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.