[mikomiel]

Claim and scope

This is the first preparation/housekeeping PR for the full remaining Polish-adaptation backlog. It does not implement or complete that backlog.

The operator requested “Prepare to do and address all issues” and selected Full confirmed backlog, in phases, excluding optional new features. The operator separately authorized only (1) correcting the repository homepage to the Polish Pages URL and (2) making the existing Dependency review check required. That scope consent is not a human PR approval, merge authorization, deployment authorization, permission grant or expert endorsement.

Base: 554a7672f9bda1ae85dee2dc9be74b7873220abe. Head: 677569e77dbdd7757621a8678cb6e092ae4a188b.

Changes in this diff

• AGENTS.md records the approved phased scope, including chapters24–34, while retaining human-owned merge/Pages, withholding and source-verification gates. Historical PR16–20 exceptions are explicitly consumed. No unfinished chapter is registered.
• README.md links the actual Polish reader and distinguishes assessed chapters1–23 (599 source positions) from the full original (34 chapters/767 positions). The eleven untouched chapters contain168 positions, not168 ready Polish cards.
• Existing audit/FINDINGS.md owns the current phase plan. Canonical advice/status records remain in book/pl/, GitHub issues own specific gaps, and GitHub alerts own scanner findings. No duplicate tracker or new plan file is added.
• Audit navigation now follows run7’s final historical115/115 script-accepted reports, not the stale112/115 overview. Historical reports remain byte-identical. Accepted report format/quotes do not establish substantive correctness, independent human review or coverage of later text.
• Two documentation regressions are added. Existing adapted-registry assertions still require exactly chapters1–23. No advice, CHAPTERS, application code, workflow, publication allowlist, dependency, licence or historical packet changes.

Separately completed owner-authorized administration and tracking

These are factual closeout claims, not settings mutations made by this source diff:

• Repository homepage read back as https://mikomiel.github.io/HowToLiveBetter-PL/ .
• Ruleset25998214 now requires both Treść i czytnik and Dependency review, each bound to GitHub Actions app15368. The full substantive ruleset was compared before/after: review count remains0, bypass actors remain empty, strictness/thread resolution/squash-only and other rules remain unchanged. Before/after and rollback payloads are retained locally; no weakening was performed.
• Issue33 closeout: closed/completed after comparing its reported defects with owner-merged PR35 and current narrow11.12. The disputed instructions were removed/narrowed. This does not claim the unread SN judgment, all case law, specialist approval or an individual contract assessment was completed.

Validation

• PASS: npm ci --ignore-scripts (5 packages audited,0 known vulnerabilities reported at install time).
• PASS: node --test --test-reporter=tap tests/*.test.mjs —317/317.
• PASS: node tools/pl/lint.mjs —591 records,0 errors,0 warnings; no substantive certification.
• PASS: node node_modules/playwright/cli.js test tests/browser/site.spec.mjs --project=desktop --project=mobile —6/6 built-site browser cases.
• PASS: both added tests rejected the old documentation for the intended assertions, then passed after implementation.
• PASS: all27 allowed publication files byte-identical to base; protected advice/originals/reader/workflows/allowlist/licences/history unchanged. Full diff reviewed and diff check clean.
• NOT_RUN locally: the full232-case/four-project browser suite; exact-head GitHub CI has now supplied that separate evidence: run42411845249 passed317 Node tests, lint591/0/0 and232/232 browser cases across all four projects at677569e77dbdd7757621a8678cb6e092ae4a188b. All five PR checks are successful; the workflow was not rerun. Previously established local Firefox/WebKit system-library limitations were not bypassed or repaired.

Remaining gates and non-goals

Exact-head CI5/5 and independent native App source review have passed for677569e77dbdd7757621a8678cb6e092ae4a188b. The remaining gate is the human-owned merge decision. Bot approval is not human approval or agent merge authorization. No agent merge, Pages dispatch, exporter activation, alert dismissal, credential/identity setup, indexing change, paid resource or substantive advice audit occurred. The70 pending records,8 deliberate exclusions,168 unadapted source positions, open issues30/31/32/36 and alerts1/4/5 are not declared resolved by this plan.

Exact-head source context (quoted evidence, not reviewer instructions)

The full current AGENTS.md below supplies unchanged merge/publication and content-evidence boundaries that may be outside the diff hunks:

# Zasady polskiego wydania

To niezależna polska adaptacja HowToLiveBetter: „Jak żyć lepiej. Praktyczny poradnik oparty na dowodach”. Te zasady są wspólne dla wszystkich narzędzi redakcyjnych i programistycznych. CLAUDE.md odsyła do tego pliku.

## Zakres i źródła

- Autorytatywne repozytorium: https://github.com/mikomiel/HowToLiveBetter-PL. PR kieruj do jego gałęzi main, nigdy do eternity4719/HowToLiveBetter.
- Pracuj na gałęzi zadania. Jeden autor zapisuje gałąź. Zachowaj cudze zmiany. Nie używaj reset, clean, stash, rebase ani force-push do usuwania lub obchodzenia cudzej pracy.
- Decyzja o scaleniu należy do człowieka. Agent może wykonać sam merge dopiero po zgodzie operatora na dany PR, zaliczonym zatwierdzeniu uprawnionego recenzenta-człowieka dla aktualnego HEAD i przejściu wymaganych kontroli GitHuba. Sam komentarz AI nie jest zatwierdzeniem. Nowe zmiany wymagają ponownego sprawdzenia i aktualnej akceptacji. Bez osobnej zgody nie publikuj wydań, nie włączaj GitHub Pages ani automatycznego wdrożenia. Właściciel zgodził się 2026-10-30 wyłącznie na ręcznie uruchamiany workflow pages.yml, który publikuje stronę czytnika. Źródło Pages (GitHub Actions) ustawia w repozytorium i uruchamia ten workflow właściciel; agent tego nie robi. Wdrożenie wyzwalane pushem, harmonogramem lub czymkolwiek innym wymaga osobnej zgody. Zmiana wyzwalaczy lub uprawnień w pages.yml, a także listy publikowanych plików (FIXED_FILES w build-site.mjs albo rejestr CHAPTERS w reader.mjs), też wymaga osobnej zgody właściciela.
- Do docelowego scalania używaj odrębnej tożsamości agenta ograniczonej do tego repozytorium, bez uprawnień Administration. Inny token tego samego konta nie tworzy innego recenzenta. Nie używaj --admin ani bypassu, nie zmieniaj ochrony main, aby umożliwić merge. Sprawdź dokładny SHA przez --match-head-commit. Dopóki osobna tożsamość nie jest skonfigurowana, agent nie wykonuje merge; robi to człowiek. Nie deklaruj wtedy rozdzielenia uprawnień ani gotowości automatycznego scalania. Zmiany administracyjne wymagają osobnej zgody operatora.
- Do prac repozytoryjnych używaj git i gh zgodnie z lokalnymi uprawnieniami.
- Kanoniczną polską treścią są rozdziały w book/pl/. Czytnik czyta te pliki Markdown. Jedyny rejestr CHAPTERS w reader.mjs zawiera identyfikatory i ścieżki plików, nie kopie porad ani ich weryfikacji. Nie kopiuj porad do HTML, JavaScript ani osobnej bazy.
- Rozdział 15 wycofano 2026-11-01 po błędach przypisania przepisów. Ponowna ocena 2026-11-02 opracowała 18 węższych wersji na podstawie właściwych artykułów urzędowych dokumentów i oficjalnych wyjaśnień; zakres lektury oraz ograniczenia pozostają przy każdej poradzie. Nie przywracaj dawnego tekstu ze skryptów lub historii. Status verified nie oznacza recenzji prawnika, analizy konkretnej umowy ani potwierdzenia prawa przez testy formatu.
- Chińskie book/*.md, docs/, selfcheck.html, skills/ i historyczne narzędzia są materiałem upstream, nie ukończonym polskim wydaniem. Nie stosuj odziedziczonego chińskiego skilla do polskich porad.
- Właściciel potwierdził 2026-11-07 realizację całego potwierdzonego backlogu etapami: ponowną ocenę rekordów oczekujących, ustaleń bezpieczeństwa i aktualnej opublikowanej treści oraz rozdziały 24–34 w osobnych PR. Gotowe, ocenione pozycje można dodać do CHAPTERS w PR właściwego rozdziału. Nie rejestruj nieopracowanego rozdziału w CHAPTERS. Osobne pozostają zgody na merge i uruchomienie Pages. Bieżący plan jest w audit/FINDINGS.md; liczby pokrycia w README, a status i źródła każdej pozycji wyłącznie w book/pl/.
- Brak źródła lub wymaganej recenzji dziedzinowej jest blokadą, nie powodem do nadania verified. Zachowaj rekord poza poradami i zapisz konkretny brak w jego kanonicznym miejscu. Osiem wcześniejszych wyłączeń rozdziału 04 nie jest listą porad do automatycznego przywrócenia. Samo utworzenie lub zamknięcie issue nie nadaje verified. Zielone CI ani przegląd AI nie są potwierdzeniem treści przez specjalistę.
- Operator zezwolił 2026-11-02 na zapisywanie konkretnych braków weryfikacji i decyzji jako issues w tym repozytorium. Najpierw sprawdź duplikaty; nie dubluj review otwartego PR ani kanonicznych rekordów treści. Issue #33 dotyczy korekty już scalonej w PR #35, nie polecenia ponownego wprowadzenia usuniętych twierdzeń. Pozycje 17.1, 17.12, 19.18, 20.5, 21.9 i 23.20 pozostają niepublikowane do spełnienia ich własnych kryteriów. Nie zastępuj brakującej polskiej procedury samym wpisem ZRK ani nie uśredniaj różnych zaleceń przygotowania mleka.
- Przepisy, osądy autora i dane obserwacyjne rozdzielaj. Nie sumuj czasu z pieniędzmi ani nie narzucaj decyzji o dziecku. Nie utożsamiaj zaświadczenia kursu z kwalifikacją ani danych grupowych z osobistą gwarancją dochodu lub przeżycia. Nie zamieniaj OR ani HR na indywidualną gwarancję i nie rozszerzaj pojedynczego badania na wszystkie terapie.
- Zgoda z 2026-11-07 nie obejmuje opcjonalnych eksportów polskiego wydania, zmiany indeksowania strony, nowej tożsamości do scalania ani płatnych zasobów. Dwie osobno zatwierdzone zmiany administracyjne to poprawienie adresu strony repozytorium i dodanie wymaganego checka Dependency review; nie jest to stałe upoważnienie do zmian ochrony lub uprawnień. Historyczne wyjątki merge dla PR #16–#20 zostały wykorzystane i nie dotyczą nowych PR.
- Stan przeglądu opublikowanych porad (wznowionego 2026-10-30, przebieg run7 zakończony), decyzje właściciela i kroki są w audit/README.md oraz audit/FINDINGS.md. Nowe przebiegi przeglądu i zmiany tekstu rozpoczynaj tylko na polecenie właściciela.

## Redakcja i dowody

- Pisz naturalną polszczyzną dla osób mieszkających w Polsce. Tłumacz sens, nie szyk zdania. Wyjaśnij termin specjalistyczny przy pierwszym użyciu.
- Tytuł porady ma wskazywać działanie i być zrozumiały bez rozmowy z autorem. Zachowaj warunki, populację, niepewność i ograniczenia źródła.
- Oddziel koszt pieniędzy, czasu i wysiłku od oczekiwanej korzyści. Nie przeliczaj automatycznie czasu na pieniądze lub długość życia.
- Oddziel ocenę dowodów od oceny opłacalności redakcyjnej. Oceny A/B/C są opisane w README; to nie system GRADE. Nie przedstawiaj ich jako gwarancji prawdziwości.
- Używaj oryginalnych badań i oficjalnych dokumentów. Syntezę badań nazwij syntezą. Przy braku pełnego tekstu podaj, co sprawdzono w abstrakcie. Metadane i streszczenie innej osoby nie potwierdzają wyniku.
- Nie wymyślaj cytowań, DOI, cen, efektów ani wniosków prawnych. Każda liczba musi mieć sprawdzone źródło lub jawne założenia rachunku redakcyjnego.
- Nie zamieniaj korelacji w przyczynę. Nie zamieniaj d, HR lub OR w procent skuteczności. Rozróżniaj ryzyko względne, różnicę ryzyka i punkty procentowe.
- Dla prawa, świadczeń, ochrony zdrowia, pracy i finansów sprawdzaj aktualne źródła polskie lub UE. Nie zastępuj mechanicznie chińskich instytucji ani przepisów polskimi nazwami. Porady zdrowotne nie zastępują diagnozy ani leczenia. Nie publikuj bezwarunkowych instrukcji medycznych ani chińskich numerów pomocowych jako polskich.
- Nie przenoś chińskich terminów postępowań, progów pieniężnych, telefonu alarmowego, zasad odpowiedzialności ani hierarchii wartościowania beneficjentów do polskich zaleceń.
- Nie zachowuj błędu tylko dlatego, że występuje w oryginale. Popraw lub pomiń twierdzenie i opisz zmianę w adaptacji.
- Przed dodaniem porady sprawdź, czy działanie już nie występuje. Nie zmieniaj numerów oryginału, aby zapełnić luki.

## Stan i format treści

Każda oceniana pozycja nowych rozdziałów ma jeden jawny Status. Niepełna pozycja jest rekordem redakcyjnym, nie gotową poradą:

- verified: przetłumaczona, sprawdzona i dopuszczona do polskiego wydania;
- needs_verification: istotne twierdzenie lub proponowane działanie nie ma wystarczającego potwierdzenia;
- needs_localization: zastosowanie zależy od chińskich instytucji, prawa, rynku lub procedur;
- not_applicable: brak odpowiedniego zastosowania w Polsce.

Czytnik publikuje wyłącznie verified. Brak lub nieznany stan jest błędem, nie zgodą na publikację. Rekord niepublikowany zawiera powód, wymagane źródła, przypięty oryginał oraz datę i zakres oceny. Nie oznaczaj go jako gotowej porady. Osiem wyłączeń rozdziału 04 pozostaje w dotychczasowej tabeli; nie zmieniaj ich decyzji bez nowych dowodów.

Zachowaj format nagłówków rozdziału i porad, jawne kotwice porada-R-N (numer rozdziału bez zera wiodącego i numer oryginalnej pozycji) oraz pojedyncze wiersze pól. Odsyłacz między rozdziałami ma postać plik.md#porada-R-N; musi działać także w Markdown. Każda verified wymaga pól: Status, Koszt, W praktyce, Korzyść i dowody, Ocena dowodów, Ocena redakcyjna, Ograniczenia, Źródła, Oryginał, Weryfikacja, Zmiany w adaptacji. Weryfikacja zawiera datę YYYY-MM-DD i zakres sprawdzenia. Oryginał zawiera identyfikator rozdziału i pozycji oraz odsyłacz przypięty do konkretnego commita upstream. Nie dodawaj HTML do pól.

## Sprawdzenie i publikacja

- Uruchom npm ci --ignore-scripts, npm test i npm run test:browser. Instalacja przeglądarek testowych: npx playwright install chromium firefox webkit. Nie dodawaj zależności do działania czytnika.
- Testy jednostkowe sprawdzają treść i bezpieczeństwo workflow. Testy przeglądarkowe muszą uruchamiać rzeczywisty czytnik z rzeczywistym Markdown, także na małym ekranie i z klawiaturą.
- Po zmianie treści sprawdź źródła, liczby, odnośniki, kotwice i liczbę opublikowanych porad w README oraz czytniku. Sprawdź wszystkie decyzje źródłowe, nawigację i błąd odczytu jednego rozdziału. Nie pokazuj części zbioru jako całości po błędzie. Starszy sync-stats.mjs dotyczy chińskiego wydania; nie uruchamiaj go do polskiej treści.
- Workflowy repozytorium wykonują walidację, z contents: read, persist-credentials: false i Actions przypiętymi do pełnych SHA. Jedynym wyjątkiem od zasady „tylko walidacja” jest ręczny pages.yml. Nadal obowiązują w nim contents: read (zadanie budowy), persist-credentials: false i przypięcie Actions do pełnych SHA. Publikuje wyłącznie pliki wskazane przez tools/pl/build-site.mjs (czytnik, rozdziały z CHAPTERS i licencje), a uprawnienia pages: write i id-token: write ma tylko jego zadanie wdrożenia, które nie uruchamia kodu z repozytorium. Wdrożenia do gałęzi main ogranicza dopiero reguła środowiska github-pages (Deployment branches: tylko main), którą ustawia właściciel; warunek if w pliku jej nie zastępuje. Nie używaj pull_request_target, sekretów, automatycznego zatwierdzania PR ani innej publikacji. Nie dodawaj do strony odziedziczonych plików (na przykład ads/, docs/, selfcheck.html, og.png, audit/, skills/, chińskich plików book/*.md).
- Przejrzyj cały diff i nowe pliki. Zrób osobny przegląd języka oraz zgodności wniosków z dowodami. Użyj niezależnego przeglądu, jeśli jest dostępny. Nie deklaruj takiego przeglądu, jeśli się nie odbył.
- Raportuj kontrole jako PASS, FAIL, NOT_RUN lub UNAVAILABLE. Podaj testowany commit. Przegląd PR musi dotyczyć dokładnego opublikowanego HEAD.
- Teksty adaptacji są na CC BY 4.0. Zachowaj autorstwo eternity4719, tytuł oryginału, odnośnik do źródła i informację o zmianach. Zachowaj LICENSE oraz pełne zawiadomienie MIT w LICENSE-CODE dla kodu. Nie sugeruj oficjalnego zatwierdzenia przez autora upstream.
- Nie umieszczaj odziedziczonych reklam, zbiórek, analityki ani cudzych grafik w polskiej prezentacji.

[ecomwizards-gandalf]

Independent snapshot review of 554a7672f9bd...677569e77dbd in mikomiel/HowToLiveBetter-PL by pi on codex-lb (gpt-6.1-sol).

Verdict: APPROVE

Reviewer output

Findings

No concrete reachable failure found in the complete five-file diff for head 677569e77dbdd7757621a8678cb6e092ae4a188b.

• Scope and gates: The new backlog authorization is preparation, not completion. AGENTS.md explicitly prohibits registering unfinished chapters and retains separate human merge/Pages authorization, source-verification requirements, and specialist-review blockers. Historical PR #16–#20 exceptions are explicitly exhausted.
• Registry protection: tests/content.test.mjs retains the exact 01–23 list and assert.deepEqual(CHAPTERS.map(c => c.id), AGREED_SCOPE). Only its description changes; the guard is not broadened.
• Coverage: The documented arithmetic is internally consistent: 521 + 70 + 8 = 599, 767 − 599 = 168, and 34 − 23 = 11. The added test derives whole-source and remaining counts from source files rather than merely asserting fixed totals.
• Historical audit: The revised navigation clearly distinguishes run7’s script acceptance from substantive correctness, human approval, and coverage of later text. No historical packet is modified by this diff.
• Links and scope: Added links and section anchors are structurally consistent. The docs: title follows Conventional Commits. No application, workflow, dependency, publication-list, or secret-value change appears in the supplied diff.

Optional suggestion

In tests/content.test.mjs, consider checking the run7 summary against its historical STATUS.md, rather than only requiring the overview to contain 115 z 115. That would detect future disagreement between the navigation and its cited evidence.

Validation and unavailable material

I read the entire diff and PR metadata. No tests, commands, browser checks, or live GitHub validations were run.

The full checkout, historical run7 evidence, original chapter files, linked GitHub settings/issues/CI, and deployed reader were unavailable. Consequently, underlying source totals, historical acceptance totals, and administrative closeout claims were not independently verified. This approval is limited to the supplied source diff; it is not merge or deployment authorization.

VERDICT: APPROVE

Evidence: not written. This review is evidence, not merge authorization.

[mikomiel]

Post-merge verification — 2026-11-07

Pi verified the owner-account merge of PR44 as 82ba9854507e7ce53a716ae303bcf7c8168e8301 at2026-11-07T21:20:41Z. Its full tree f10dd01d71e501c1de6164fe62290a0748411c88 equals reviewed/tested head 677569e77dbdd7757621a8678cb6e092ae4a188b.

PASS fresh main CI3/3: content42415415765 passed317 Node tests, lint591/0/0 and232/232 browser cases across four projects. CodeQL42415415421 passed both language jobs. The phase plan is now merged, not merely proposed.

All27 publication bytes remain unchanged. No Pages dispatch or agent PR merge occurred. Alerts1/4/5 remain open at this verification snapshot; their sources are byte-identical to the earlier per-consumer triage. Their individual disposition is the next step, not an automatic consequence of green CI. The remaining substantive issues and withheld/unadapted content are not declared complete.