flagtldr / docs /DECISIONS.md
botezx's picture
FlagTLDR 0.5.3 (snapshot of local 792adad)
4f4eadf
|
Raw History Blame Contribute Delete
25.3 kB
# DECISIONS – otwarte pytania do botex-human
Każde pytanie ma rekomendację (★). Zaznacz wybór, a ja zaktualizuję kod i dokumentację.
### D1. Jak wysyłać podsumowanie do Groka „na koncie X”?
- ★ **a′)** **One-click (`grok-auto`), teraz domyślne.** Po Twoim kliknięciu rozszerzenie steruje Twoim Grokiem w ukrytej ramce
`x.com/i/grok` albo w karcie w tle: wpisuje prompt, klika „Wyślij”, czeka i zbiera odpowiedź do panelu pod wpisem. Nie wywołuje
API, nie używa tokenów, nie zdejmuje nagłówków. Ryzyko: szara strefa ToS (automatyzacja UI), umiarkowane/niskie. Selektory nie
są jeszcze zweryfikowane na prawdziwym x.com. Przy błędzie przechodzi automatycznie do a).
**Pytanie:** czy zostawić ukrytą ramkę jako domyślną, czy wolisz kartę w tle (widoczna w pasku kart przez kilka–kilkadziesiąt sekund)?
- **a)** Handoff: schowek i otwarcie Groka w X. Oficjalne, bezpieczne, ale wymaga jednego Ctrl+V. *(fallback i opcja ręczna)*
- b) xAI API przez OAuth subskrypcji (progrok lub wbudowany device-flow). Wymaga SuperGrok lub X Premium+. Wynik od razu w panelu.
- c) Nieoficjalnie przez sesję X (`add_response.json`). W pełni automatyczne, ale łamie ToS (ryzyko dla konta) i może się zepsuć.
- d) Klucz xAI API (płatne tokeny).
- **Pytanie:** jaki plan masz na X / xAI (Premium, Premium+, SuperGrok)?
### D2. Skąd brać odpowiedzi w wątku?
- ★ **a)** Tylko to, co X załadował w karcie (trzeba przewinąć). Zero dodatkowego ruchu.
- b) Automatyczne przewijanie lub dociąganie przez wewnętrzne GraphQL (ryzyko ToS).
- c) X API pay-per-use (~$0.005 za wpis, np. 200 odpowiedzi to ~$1). Masz konto developerskie?
### D3. Który basal i gdzie ma działać?
- ★ **a)** `basal-omni-pico` na CPU na Twoim komputerze (`scripts/basal-serve.sh`). Zajmuje ~1.6 GB, ~0.3–0.5 s na wpis.
- b) `basal-omni-1.0-mini` (GPU ~16 GB lub Mac z MLX). Lepsza jakość i obsługa obrazów (memy, zrzuty).
- c) Serwer na tym boxie lub zdalnym, wystawiony rozszerzeniu (wymaga tunelu i autoryzacji).
- **Pytanie:** jaki masz sprzęt (GPU, VRAM, Mac M-series)?
### D4. Uczenie klasyfikatora
- ★ **a)** Faza 2: opis, rubryki i przykłady w prompcie, potem kalibracja `basal-calibrate` na ~70–300 Twoich etykietach (zbieranych kliknięciem „popraw etykietę”).
- b) Dodatkowo głowica na embeddingach, trenowana w sekundy. Mogłaby działać w samej przeglądarce, bez serwisu.
- c) Własne LoRA na basal (brak oficjalnego skryptu; większy projekt).
- **Pytanie:** jakie klasyfikacje są dla Ciebie najważniejsze (np. merytoryczny / kontra / szum; boty; polityka; spam krypto)? Ile przykładów możesz dać na start?
### D5. Co robić z oznaczonymi wpisami?
- Domyślnie: kolorowy pasek i plakietka; `szum` zwijany do jednej linii; `hide` dostępne, ale niedomyślne.
- **Pytanie:** czy klasyfikować cały timeline (więcej obciążenia), czy tylko otwarte wątki?
### D6. Przeglądarki i telefon
- ★ Chrome i Firefox na desktopie. Na Androida: Firefox (wymaga publikacji na AMO, może być prywatna lub niewystawiona).
- **Pytanie:** na czym korzystasz z X (desktop, Android, iOS)?
### D7. Dystrybucja
- ★ Na razie „załaduj rozpakowane” lub podpisany XPI (unlisted na AMO).
- Później ewentualnie Chrome Web Store (unlisted). Czy publikować publicznie?
### D8. Język
- UI i domyślny system prompt są po polsku. Czy podsumowanie zawsze po polsku, czy w języku wątku?
### D9. Ilość danych w promptcie
- Domyślnie do 150 odpowiedzi (sortowanych po polubieniach) i 60 tys. znaków. Czy uwzględniać cytaty (quote posts)?
- **Ustalone (v0.4.1, botex-human):** tylko **poddrzewo klikniętego wpisu** – wpis, odpowiedzi na niego i odpowiedzi na te odpowiedzi
(rekurencyjnie); bez przodków i bez sąsiednich gałęzi. Przodkowie tylko jako oznaczony „kontekst nadrzędny” (ustawienie:
brak / bezpośredni rodzic – domyślnie / do 3 / cały łańcuch). Drzewo z `in_reply_to_status_id_str` (TweetDetail), zapasowo
kolejność w module `conversationthread-*`; bez GraphQL – układ strony (wszystko pod wpisem głównym strony i pod jego przodkami
należy do ich poddrzewa; dla odpowiedzi niżej – tylko kolejne wpisy tego samego modułu do separatora X).
Nagłówek panelu: „Poddrzewo wpisu: N odpowiedzi z K znanych” (K = liczniki odpowiedzi X dla wpisu i zebranych odpowiedzi).
Ograniczenie: X ładuje głębsze gałęzie dopiero po „Pokaż więcej odpowiedzi” – czego nie załadował, tego nie mamy (widać to w N vs K).
### D10. Kraj konta autora i ukrywanie wg kraju/regionu (v0.4.0) – co ustaliliśmy, co do potwierdzenia
- **Wszystko domyślnie wyłączone** (ustawienia → „3. Kraj konta autora”). *Zmienione w 0.5.0 (D18): funkcja domyślnie włączona na żądanie, automatyczne sprawdzanie nadal wyłączone.*
- **Trzy stany, nigdy pomieszane:** *wg X* (flaga kraju albo zarys regionu, ⚠ gdy X sam ostrzega o VPN/proxy),
*zadeklarowana* (📍 w przerywanej ramce – tekst z profilu, tylko informacyjnie), *nieznana* (brak danych; „?” opcjonalnie).
Kraje mają **tylko flagę**, zarysy wyłącznie dla regionów; nieznany region → 🌐.
- **Pasywnie (domyślnie):** dane, które X i tak pobrał – lokalizacja z profilu w każdym obiekcie `User` oraz pełne „Konto z”,
gdy sam otworzysz czyjeś „Informacje o koncie”. Zero własnych zapytań.
- **Aktywnie (opcja z ostrzeżeniem, ryzyko):** `AboutAccountQuery` wysyłane **z kontekstu strony x.com** (Twoja sesja, jak robi to
sama strona), tylko dla autorów **widocznych** na ekranie, 1 naraz globalnie (wszystkie karty), domyślnie 6/min (1–30),
cache 14 dni (1–30; „brak danych” max 3 dni), pauza do `x-rate-limit-reset` po 429 (oraz gdy `remaining ≤ 1`),
stop: 401/403 → 60 min, 400/404/422 (zmienił się queryId) → 6 h, 3 błędy z rzędu → 30 min. Wznowienie w opcjach.
Token `authorization` jest tylko podglądany z zapytań X i **nigdy nie opuszcza strony** (nie trafia do storage ani do tła);
CSRF czytany z ciasteczka `ct0` w chwili zapytania.
**Ryzyko:** nieudokumentowany endpoint, szara strefa regulaminu (automatyczne zapytania), możliwe limity, w skrajności
ograniczenie konta. Dlatego to osobny przełącznik z czerwonym ostrzeżeniem i potwierdzeniem.
- **Odrzucone:** ukryta karta/ramka z `/<handle>/about` (to samo zapytanie, więcej ruchu i ryzyka); zewnętrzne API (wyciek tego, kogo czytasz).
- **Filtr:** lista krajów/regionów/„nieznana” z wyszukiwarką; tryb ukryj / zwiń z „Pokaż” / przyciemnij; zakres oś czasu /
odpowiedzi (strony `/status/`) / oba; czarna albo biała lista. Region obejmuje swoje kraje (opcja) i pod-regiony
(„Azja” łapie „Azję Południową”, ale nie odwrotnie). **Nigdy nie ukrywamy na niepełnych danych:** konto niesprawdzone /
w trakcie sprawdzania nie jest filtrowane (także w trybie białej listy); „nieznana” = X odpowiedział, że nie ma danych.
Otwarty wpis (główny w wątku) nigdy nie jest ukrywany. Opcja: kraj zadeklarowany w profilu jako zastępstwo w filtrze (domyślnie wył.).
- **Podsumowanie:** odpowiedzi ukryte/zwinięte filtrem nie trafiają do promptu (opcja, domyślnie tak); przyciemnione – trafiają.
- **Raport diagnostyczny:** tylko liczniki (zapytania, trafienia cache, 429, stopy) i ustawienia (lista krajów jako liczba).
- **v0.4.1:** domyślnie 12/min z tempem adaptacyjnym wg nagłówków X (zob. D11), przycisk „🌐 Sprawdź kraj” przy wpisie.
- **Pytania do botex-human:** (1) czy domyślne 12/min (adaptacyjnie) i 14 dni są OK? (2) czy filtr ma działać też na cytatach/retweetach (teraz: autor wpisu)?
(3) czy pokazywać źródło połączenia (np. „Android”, „Poland App Store”) w podpowiedzi – teraz tak, tylko w tooltipie.
### D11. v0.4.1 – kliknięcia, kolejka, pigułka, kotwiczenie (ustalone z botex-human)
- **„🌐 Sprawdź kraj” przy wpisie:** domyślnie włączone (osobny przełącznik), także przy wyłączonym aktywnym sprawdzaniu; uwaga o ryzyku
tylko przy pierwszym użyciu; widoczny też, gdy automat nie dotrze do autora w ~5 s (kolejka / budżet / pauza).
- **Kliknięcie = od razu** (cel ~1 s): nie czeka na odstęp, nasz limit na minutę ani automatyczne pozycje; max 2 zapytania w locie.
Opóźnia je tylko pauza X (429 / `remaining = 0` do resetu / stop po błędach) – z odliczaniem na przycisku; autor jest wtedy pierwszy w kolejce.
- **Kolejka:** auto – wypada po 10 s poza ekranem lub po zniknięciu z DOM; kliknięte – po 2 min poza ekranem; limit 20 (ustawialny),
najnowsze widoczne pierwsze. Liczniki odrzuceń w raporcie diagnostycznym.
- **Pigułka kolejki + licznik na ikonie + presety 6/12/30**, tempo adaptacyjne (RESEARCH §8).
- **Kotwiczenie:** „⚖ Podsumuj” jako osobny element w pasku akcji TEGO wpisu (grupa z przyciskami reply/retweet/like, której najbliższy
`article` to ten wpis), z pominięciem ankiet (tekstowych i obrazkowych), kart, cytatów, zdjęć/karuzel; bez pozycjonowania absolutnego.
Plakietka kraju – w `User-Name` tego wpisu, nie cytowanego (`src/lib/anchors.js`).
### D12. v0.4.2 – tryb Groka (ustalone z botex-human)
- **Domyślnie Szybki (Fast)**; do wyboru Auto, Ekspert, „nie zmieniaj”. Wybór tylko przez UI (kliknięcie przełącznika w kompozytorze),
bez parametrów URL (nie istnieją) i bez wewnętrznych API.
- **Nigdy nie blokuje podsumowania:** brak przełącznika / tryb niedostępny / brak potwierdzenia → bieżący tryb + ostrzeżenie w panelu
(„nie udało się ustawić trybu Szybki” albo „…potwierdzić…”) + sekcja `mode` w diagnostyce (tylko ogólne klucze trybów).
- **„Przywróć poprzedni tryb”** domyślnie włączone, best-effort (limit ~10 s, po odpowiedzi, przed zamknięciem ramki/karty) –
X może zapamiętywać wybór także z ukrytej ramki.
- **Próbne otwieranie menu** (ostatnia deska ratunku dla przycisku bez etykiety): najwyżej 3 przyciski `aria-haspopup` w formularzu
kompozytora, każde menu zamykane Escape. Do usunięcia, jeśli raport z x.com pokaże stabilny selektor.
- **API xAI:** domyślnie `grok-4.3` + `reasoning_effort: none` (szybki odpowiednik wycofanych `grok-4-fast`); `grok-4.7` jako opcja „ekspercka”.
### D13. v0.4.2 – „Grok sam czyta wątek”, panel, plakietka kraju, jedno wysłanie (ustalone z botex-human 23.10, 16:52–17:03)
- **Domyślnie Grok czyta wątek sam** z linku do klikniętego wpisu; prompt tylko OPISUJE, które odpowiedzi brać (poddrzewo, wszystkie
poziomy; rodzic tylko kontekst; pole „Jak wybierać odpowiedzi”) i prosi o „@autor + link”. Rozszerzenie nie zbiera i nie liczy
odpowiedzi (nagłówek „Grok czyta wątek sam”). Odrzucony plan „numerowana lista + [spoza listy]”. Tryb „odpowiedzi z rozszerzenia”
zostaje jako porównawczy (niedomyślny); dostawca „API zgodne z OpenAI” zawsze w nim działa (API nie czyta X).
- **Filtr kraju w trybie Groka:** nie da się wyciąć odpowiedzi, których nie zbieramy – do promptu idzie lista kont ukrytych/zwiniętych
przez filtr (max 50) z prośbą o pominięcie. Best-effort, niezweryfikowane.
- **Panel:** stały kontrakt sekcji `## TEZA/ZA/PRZECIW/SZUM/OCENA/BRAKUJE`, tolerancyjny parser; subiektywne sekcje zwinięte i podpisane.
- **Plakietka kraju:** stan autora (w kolejce + pozycja / sprawdzam / flaga / „Sprawdź kraj”) liczony centralnie dla autora i rozsyłany do
innych kart x.com przez service worker (wiadomość `xa-geo-state`, ważna 90 s).
- **Jedno wysłanie na zadanie:** token zadania; ramka może wysłać tylko, jeśli to ona przejęła zadanie, a przejście na kartę tylko gdy ramka
nie przejęła zadania; drugie „wyślij” – odmowa. Po wpisaniu odczyt kompozytora; podwojenie → wyczyść i wpisz raz; między metodami
wpisywania zawsze czyszczenie. Nadal tylko akcje UI z kliknięcia użytkownika, bez wewnętrznych API; nagłówki bezpieczeństwa bez zmian.
### D14. v0.4.3 – hybrydowe źródło odpowiedzi, poprawka „niezwiązanych odpowiedzi” (ustalone z botex-human 23.10, 17:02 FINAL, 17:27, 17:48)
- **Domyślnie hybrydowo:** rozszerzenie dostarcza zweryfikowane poddrzewo (malejąco wg polubień, ten sam limit), a prompt zawiera link
i zasady wyboru wygenerowane z ustawień – te same, których używa rozszerzenie – żeby Grok doczytał brakujące odpowiedzi i cytował
„@autor + link”. „Jak wybierać odpowiedzi” domyślnie = te zasady. Opcje: „tylko Grok czyta wątek”, „tylko dostarczone odpowiedzi”.
Stare domyślne „grok” (bez `replySourceV043`) → „hybrid”.
- **Weryfikacja odpowiedzi:** tylko łańcuch `in_reply_to_status_id_str` do wpisu; DOM tylko na własnej stronie wpisu; przodkowie tylko
z łańcucha wpisu; bez kontekstu z układu strony. Wolimy pokazać 0 dostarczonych (Grok doczyta z linku) niż jedną fałszywą.
- **Podwójne wklejenie:** porównanie bez białych znaków; ostatnia kontrola tuż przed „Wyślij” po ustabilizowaniu się kompozytora
(2 odczyty co 250 ms); podwójnie → wyczyść i wpisz raz; nadal podwójnie → przerwij z błędem (nigdy nie wysyłamy duplikatu).
Nadal tylko akcje UI z kliknięcia użytkownika, bez wewnętrznych API; nagłówki bezpieczeństwa bez zmian.
### D15. v0.4.3 – dwie ścieżki odpowiedzi, argumenty wg ważności (ustalone z botex-human 23.10, 17:31, 17:35)
- Jeden prompt systemowy, dwie ścieżki; pierwsza linia `## TRYB: TEZA` / `## TRYB: INFORMACJA`. Parser: znacznik wygrywa tylko, gdy
pasują sekcje; inaczej wnioskowanie z sekcji; inaczej markdown. Ustawienie wymuszenia: auto / teza / informacja.
- ZA/PRZECIW (i „Ciekawe odpowiedzi”) porządkuje Grok wg wagi merytorycznej, nie polubień; duplikaty łączy w jeden punkt z listą @autorów.
Panel trzyma kolejność Groka, pokazuje top N (domyślnie 3, 0 = wszystkie) z „Pokaż wszystkie (N)” / „Zwiń”.
### D16. 0.5.0 – czas podsumowania i formatowanie sekcji rozwijanych (zlecenie botex-human 23.10)
- **Oczekiwany czas = mediana** ostatnich ≤20 udanych przebiegów z najbardziej szczegółowego „kubełka” z ≥2 próbkami: ten sam tryb
Groka + kontekst (ramka/karta/okno) → ten sam tryb → wszystkie; inaczej „brak danych”. Mediana zamiast średniej – odporna na pojedyncze
zawieszenia. Pasek zatrzymuje się na 95 % do czasu wyniku (nie „kłamie”, że skończył). Błędy i przerwane przebiegi się nie liczą.
- Zapis w `chrome.storage.local.summaryTiming` tylko `{ms, mode, ctx, at}` (maks. 60) – bez treści, autorów i ID; przycisk
„Wyczyść statystyki czasu” w ustawieniach.
- OCENA / BRAKUJE / SZUM / PYTANIA renderowane tym samym bezpiecznym rendererem markdown co karty ZA/PRZECIW (bez `innerHTML`),
z odstępami i kolorami zależnymi od motywu.
### D17. 0.5.0 – nowa nazwa FlagTLDR (zlecenie botex-human 23.10)
- Nazwa **FlagTLDR**, slug `flagtldr`. `manifest.name` „FlagTLDR – flagi krajów i TL;DR wątków na X” (43 znaki – `web-ext lint` ogranicza
do 45, Chrome do 75), `short_name` „FlagTLDR”, opis 129/132 znaków. Raport diagnostyczny: `schema: "flagtldr-diag/1"`, `tool: "FlagTLDR"`.
Przyszłe paczki: `dist/flagtldr-<wersja>-chrome.zip` (teraz nie budujemy).
- **Klucze storage bez zmian** (`settings`, `xaGeo`, `xaGeoState`, `xaDiag`, `summaryTiming`, `geoClickAck`…) – nie miały prefiksu
„x-addons”, więc zmiana nic by nie dała, a wymagałaby migracji. Bez zmian też: katalog repo `/workspace/x-addons`, wewnętrzne `XA.*`, klasy `xa-*`, kanały
`xaddons-page-hook`/`xaddons-content`, pakiet `xaddons-classifier`. ID Firefoksa zmienione później na `flagtldr@botezx.local` (D22).
- **Sprawdzenie kolizji nazwy (23.10.2026, wyszukiwarka):** nie znaleziono produktu ani rozszerzenia o nazwie „FlagTLDR”. Podobne:
FlagTGL (feature flags, https://flagtgl.com/), newsletter TLDR (https://tldr.tech/), everytldr (https://everytldr.com/),
Flaglio (https://www.flaglio.com/); GitHub: dgr4y/flagfilter (filtr flag 4chan, https://github.com/dgr4y/flagfilter),
LiteObject/ai-tldr-chrome-extension, i365dev/community-tldr (w CWS). Indeks wyszukiwarki jest ograniczony –
**przed publikacją sprawdzić ręcznie w Chrome Web Store i Edge Add-ons**.
### D18. 0.5.0 – kraj konta domyślnie włączony na żądanie (zlecenie botex-human 23.10)
- `geoEnabled: true` domyślnie: przy autorach bez danych przycisk „🌐 Sprawdź kraj” (jedno zapytanie po kliknięciu), pamięć podręczna
i dane pasywne pokazują się od razu. **Pasywnie** (jak dotąd, przy włączonej funkcji): `page-hook.js` czyta kopie odpowiedzi GraphQL,
które X i tak pobrał (lokalizacja z profilu w obiektach User; pełne „Konto z”, gdy użytkownik sam otworzy „Informacje o koncie”) –
bez własnych zapytań. `geoActiveLookup` („Sprawdzaj kraje automatycznie”) i filtr – nadal domyślnie wyłączone.
- **Migracja istniejących ustawień:** zapisanego `false` nie da się odróżnić od świadomego wyboru, więc znacznik `geoDefaultsV2`
(zapisywany przez ustawienia przy każdym „Zapisz”). Bez znacznika i gdy **cała** sekcja kraju ma stare wartości domyślne (pusta lista
filtra) → `geoEnabled` przełączane na `true`; każda inna zmiana w sekcji = świadomy wybór, zostaje. `geoActiveLookup` migracja nigdy nie włącza.
Znane ograniczenie: ktoś, kto włączył i znów wyłączył funkcję, nic więcej nie zmieniając, dostanie ją włączoną – ryzyko niskie
(tryb na żądanie nie wysyła zapytań bez kliknięcia); można ją wyłączyć jednym kliknięciem.
### D19. 0.5.0 – przygotowanie do Chrome Web Store / Edge Add-ons (zlecenie botex-human 23.10)
- Tylko Chromium; Firefox (AMO) i mobilne poza zakresem. Materiały: `docs/store/` (PRIVACY, PERMISSIONS z audytem A1–A14, LISTING,
PUBLISHING, `assets/` ze skryptu `scripts/e2e/store-assets.mjs` – z makiety, fikcyjne konta). Nic nie zostało zgłoszone ani opłacone;
manifest nie zmieniony w ramach audytu.
- **Propozycje do wersji sklepowej (do decyzji):** flaga `--store` w `package-chrome.py` (bez hostów `127.0.0.1`/`localhost`,
`background.scripts`, `gecko`), stała `STORE_BUILD` ukrywająca klasyfikator (poza „single purpose”), tryb diagnostyczny i pola debug;
`api.x.ai` jako uprawnienie opcjonalne; rozważyć usunięcie `clipboardWrite`; dodać ikonę 16 px do `manifest.icons`; nowa ikona bez
„X” (znak towarowy) z marginesem 16 px.
- **Ryzyka recenzji:** hook fetch/XHR w świecie MAIN, stała `WEB_BEARER` + odczyt `ct0`, nieudokumentowany `AboutAccountQuery` i
automatyzacja UI Groka (regulamin X) – mogą skutkować odrzuceniem lub późniejszym zgłoszeniem; opisane w PERMISSIONS.md A5–A7.
### D20. 0.5.0 – nowa ikona: liść (zlecenie botex-human 23.10: „nowoczesna, coś prostego, pięknego z natury”)
- **Dlaczego:** stara ikona („X” z kropką na ciemnym kwadracie) przypominała logo X (znak towarowy X Corp.) i nie miała marginesu
wymaganego przez Chrome Web Store (D19, audyt A12).
- **Warianty** (ręcznie pisane SVG 96×96, 3–4 kształty, płaskie z lekkim gradientem; `docs/icon/variants/*.svg` + podglądy PNG 256 px,
arkusz `docs/icon/comparison.png` – 16/32/48/128 px w rzeczywistej wielkości na jasnym i ciemnym tle):
**A „Szczyt”** – białe góry i żółte słońce na niebieskim zaokrąglonym kwadracie; **B „Liść”** – biały liść z nerwem na zielonym kole;
**C „Kropla”** – biała kropla wody na niebiesko-fioletowym kwadracie.
- **Wybór: B „Liść”.** Najmocniejsza sylwetka w 16 px (jeden duży biały kształt po przekątnej, nerw widoczny od 32 px), zielone koło
odcina się i od jasnego, i od ciemnego paska narzędzi (Chrome / Edge, motywy jasny i ciemny) oraz od niebieskich ikon X / Groka obok;
nic nie przypomina litery „X”. A w 16 px zlewa się w „obrazek” (góry + słońce to też powszechna ikona galerii zdjęć, a dolna krawędź
gór na białym tle się rozmywa); C jest czytelna, ale generyczna (kojarzy się z aplikacjami pogody / wody) i niebieska jak X.
- **Wymiary:** `extension/icons/icon{16,32,48}.png` – pełne koło (bez marginesu, żeby w pasku narzędzi nie było za małe);
`icon128.png` – grafika 96×96 wyśrodkowana, 16 px przezroczystego marginesu (wytyczne CWS „Supplying images”; ikona średnio-jasna,
więc bez dodatkowej poświaty). `manifest.icons` 16/32/48/128 i `action.default_icon` 16/32/48. Test jednostkowy sprawdza rozmiary
PNG i margines (bbox kanału alfa = 16…111).
- **W UI:** logo (`icon48.png` w 32 px) w nagłówku ustawień + favicon; w nagłówkach nakładki postępu, panelu TL;DR i panelu tekstu
zamiast „⚖” – mała ikona jako inline SVG (`LOGO_SVG` w content.js; bez `web_accessible_resources`, czyli bez nowych zasobów
dostępnych dla stron). Przycisk „⚖ Podsumuj” zostaje (opisuje akcję, nie markę).
- **Grafiki sklepu** renderowane z `docs/icon/flagtldr.svg` (`scripts/e2e/icon-assets.mjs`, wołane z `icon-render.mjs` i
`store-assets.mjs`): `icon-128.png` (= icon128), `logo-300.png` (pełne koło, przezroczyste rogi), `promo-440x280.png` (ciemnozielone
tło, żeby zielone koło się wyróżniało); zrzuty sklepu 2 i 3 odświeżone (nowe logo w nagłówku panelu). Wszystko powtarzalne: `node scripts/e2e/icon-render.mjs <chrome> b-lisc` (bez makiety).
### D21. Wydanie 0.5.0 (2026-10-23, po akceptacji ikony przez botex-human)
- Zmiany „Unreleased” (D16–D20) wydane jako **0.5.0**: `manifest.json`, `package.json` (+ `package-lock.json`), przykładowy raport
diagnostyczny. Paczka `dist/flagtldr-0.5.0-chrome.zip` (`scripts/package-chrome.py`), tag git `v0.5.0`. Nic nie zostało zgłoszone
do sklepów (to osobna decyzja – PUBLISHING.md).
- **Aktualizacja z 0.4.3 – co zostaje (sprawdzone, `scripts/e2e/release-check.mjs`, Chrome 156, tymczasowy profil):** cały stan
(`settings`, pamięć krajów `xaGeo`/`xaGeoState`, `summaryTiming`, diagnostyka) jest w `chrome.storage.local`, przypisanym do ID
rozszerzenia; manifest nie ma pola `key`, więc ID rozszerzenia rozpakowanego = skrót ścieżki katalogu. (a) Nowe pliki w **tym samym
katalogu** + ⟳ → to samo ID, ustawienia i pamięć krajów zachowane, nazwa na liście zmienia się z „X Addons” na FlagTLDR.
(b) **Inny katalog** → nowe ID, pusto (ustawienia domyślne); stary wpis trzeba usunąć, żeby nie działały dwa naraz.
(c) **„Usuń” i ponowne załadowanie** (nawet z tego samego katalogu) → pusto – usunięcie kasuje dane rozszerzenia.
Nie dodajemy pola `key` (stałe ID) ani eksportu ustawień – instrukcja zaleca wariant (a).
- Migracja D18 działa także przy aktualizacji: kto zmienił coś w sekcji „Kraj konta” w 0.4.3, zachowuje swój wybór (w teście:
zmienione „Pamięć podręczna (dni)” → `geoEnabled` zostaje wyłączone).
### D22. Anonimizacja repozytorium (po 0.5.0, bez zmiany wersji)
- Właściciel projektu występuje w dokumentacji, komentarzach i testach jako **botex-human** (zamiast imienia). Godziny ustaleń zostały.
- **ID Firefoksa** `browser_specific_settings.gecko.id`: `flagtldr@botezx.local` (poprzednio identyfikator z imieniem właściciela).
Firefox jest poza zakresem (publikujemy tylko Chromium), a Chrome to pole ignoruje, więc zmiana nie wpływa na ustawienia
ani pamięć krajów w Chromium. W Firefoksie byłoby to nowe rozszerzenie (dane od zera).
- **Przykłady z X:** regresje 0.4.3 (oś czasu „5 z 6” i drugi zgłoszony przypadek) oraz odpowiedź Groka w układzie z numerowanymi
nagłówkami odtworzone na **wymyślonych** kontach (`@przyklad_autor`, `@autorka_wpisu`, `@watek_start`, `@argument_a`…),
identyfikatorach (`2113570000000000001`…) i treściach o tej samej strukturze. Pliki: `fixtures/hometimeline.focal2.json`
(makieta `?tl=focal2`), `fixtures/grok-answers/numbered-pl.md` (makieta Groka `?answer=numbered`). Testy sprawdzają te same przypadki.
### D23. Wydanie 0.5.1 (2026-10-26)
- Poprawki po testach 0.5.0: puste `()` w kartach ZA/PRZECIW po wyciągnięciu źródeł; odporność automatyzacji Groka na
przełączanie kart (chwilowa aktywacja karty na tryb/wpisanie, łagodniejsze wykrywanie elementów w tle).
- Anonimizacja repo (D22) wchodzi do tej paczki. Bez zmian kluczy `chrome.storage`. Paczka
`dist/flagtldr-0.5.1-chrome.zip`, tag `v0.5.1`.
### D24. Wydanie 0.5.2 (2026-10-30)
- Poprawka po testach 0.5.1: nowy przycisk „Tryb głosowy” w polu Groka był brany za przełącznik trybu (ogólne selektory
`aria-label*="tryb"/"mode"`), więc rozszerzenie klikało mikrofon i nie wpisywało promptu. Kontrolki głosu są pomijane,
a ogólne selektory wymagają przycisku z menu albo nazwy trybu w etykiecie. Bez zmian kluczy `chrome.storage`.
Paczka `dist/flagtldr-0.5.2-chrome.zip`, tag `v0.5.2`.
### D25. Wydanie 0.5.3 (2026-10-30)
- Grok w całości w tle: bez aktywowania karty Groka (pożyczanie fokusu z 0.5.1 domyślnie wyłączone, opcja
`grokAllowFocusSwitch`), wpisywanie bez fokusu; reguła DNR usuwa `X-Frame-Options` tylko dla ramki `x.com/i/grok`
otwieranej z x.com (uprawnienie `declarativeNetRequestWithHostAccess`). Paczka `dist/flagtldr-0.5.3-chrome.zip`, tag `v0.5.3`.