From 073069c3039c74e87ef00b3623568b63ae82ea2d Mon Sep 17 00:00:00 2001
From: Jacek Pyziak <jacek.pyziak@project-pro.pl>
Date: Wed, 13 May 2026 23:10:08 +0200
Subject: [PATCH] fix: dziala aktualizacja systemu i Wyczysc cache na
 /admin/update/main_view/ (v0.353)

Zdalny changelog z shoppro.project-dc.pl/updates/changelog.php zwracal
niezbalansowany HTML (niezamkniety <script>/<style>/<textarea>/<!--),
ktory "polykal" reszte dokumentu - inline-script z handlerami
#confirm/#confirmUpdateAll i footer-script z main-layout.php
(#clear-cache-btn) nigdy nie parsowaly sie jako JS. Klienci nie mogli
aktualizowac shopPRO.

Fix w admin/templates/update/main-view.php:
1. Blok <script> z handlerami przeniesiony PRZED sekcje Changelog -
   handlery podpinaja sie niezaleznie od zdalnego HTML.
2. Sanityzacja zdalnego changeloga: preg_replace usuwa komentarze HTML,
   strip_tags z whitelista (<p><br><b><strong><i><em><u><ul><ol><li>
   <h1>-<h6><span><div><a><pre><code><hr>) wycina tagi strukturalne i
   wykonywalne (<script>, <style>, <iframe>, <textarea>).

Skutek uboczny: footer-script z main-layout.php (Wyczysc cache + globalne
wyszukiwanie + sprawdzanie aktualizacji) dziala teraz na podstronie update.

Po wgraniu na instancje: hard-reload (Ctrl+F5) + restart PHP-FPM /
wyczyszczenie OPcache.

Suita PHPUnit: 846 testow / 2348 assertions OK.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 .paul/ROADMAP.md                              |  11 +-
 .paul/STATE.md                                |  23 ++-
 .paul/changelog/2026-05-13.md                 |   7 +
 .paul/docs/TECH_CHANGELOG.md                  |  11 ++
 .../21-admin-update-view-js-fix/21-01-PLAN.md | 173 ++++++++++++++++++
 .../21-01-SUMMARY.md                          | 124 +++++++++++++
 admin/templates/update/main-view.php          |  23 ++-
 change.md                                     |  56 ++++++
 8 files changed, 409 insertions(+), 19 deletions(-)
 create mode 100644 .paul/phases/21-admin-update-view-js-fix/21-01-PLAN.md
 create mode 100644 .paul/phases/21-admin-update-view-js-fix/21-01-SUMMARY.md
 create mode 100644 change.md

diff --git a/.paul/ROADMAP.md b/.paul/ROADMAP.md
index fe82d56..e123b68 100644
--- a/.paul/ROADMAP.md
+++ b/.paul/ROADMAP.md
@@ -41,6 +41,7 @@ Status: Planning
 | 18 | Google feed permutation URL fix | 1 | Done | 2026-04-30 |
 | 19 | Frontend meta tags fix (category + product) | 1 | Done | 2026-05-13 |
 | 20 | Category edit mojibake fix (UI labels) | 1 | Done | 2026-05-13 |
+| 21 | Admin update view JS fix (przyciski aktualizacji + cache) | 1 | Done | 2026-05-13 |
 
 ## Feature
 
@@ -149,5 +150,13 @@ Status: Planning
 
 **Scope:** Podmienić 9 hardcoded labelek na poprawne polskie znaki (Treść, Język domyślny, Tytuł, rozwinięcie, Sortowanie produktów, Wyświetlić podkategorie, Blokuj indeksację). Brak zmian w logice/HTML structure, plik zostaje UTF-8 bez BOM. Human-verify w panelu admina.
 
+### Phase 21 — Admin update view JS fix
+
+**Problem:** Na `/admin/update/main_view/` nie działają przyciski "Aktualizuj do wyższej wersji", "Aktualizuj do najwyższej wersji" oraz globalny "Wyczyść cache" z headera admina. Klient nie może zaktualizować systemu. Brak błędu JS w konsoli — kliknięcie tylko dopisuje `#` do URL.
+
+**Root cause:** `admin/templates/update/main-view.php` pobiera zdalny changelog przez `file_get_contents` z `shoppro.project-dc.pl/updates/changelog.php`. Odpowiedź zawiera niezbalansowany HTML (niezamknięty `<script>`, `<!--`, `<style>` lub `<textarea>`), który „połyka" pozostałą część dokumentu jako tekst — inline-script z handlerami i footer-script z `main-layout.php` nigdy się nie parsują.
+
+**Scope:** (1) Przenieść blok `<script>` z handlerami przyciskami PRZED sekcję Changelog. (2) Sanityzować zdalny changelog: `preg_replace` usuwa komentarze HTML, `strip_tags` z białą listą tagów formatujących. Jeden plik: `admin/templates/update/main-view.php`. Human-verify w panelu admina.
+
 ---
-*Last updated: 2026-05-13 (Phase 20 complete)*
+*Last updated: 2026-05-13 (Phase 21 complete)*
diff --git a/.paul/STATE.md b/.paul/STATE.md
index c9bd2ed..aabd6e7 100644
--- a/.paul/STATE.md
+++ b/.paul/STATE.md
@@ -5,19 +5,19 @@
 See: .paul/PROJECT.md (updated 2026-04-30)
 
 **Core value:** Właściciel sklepu ma pełną kontrolę nad sprzedażą online w jednym systemie pisanym od podstaw, bez narzutów zewnętrznych platform.
-**Current focus:** Phase 20 complete — loop closed
+**Current focus:** Phase 21 complete — loop closed
 
 ## Current Position
 
 Milestone: Hotfix
-Phase: 20 of 20 (Category edit mojibake fix) — Complete
-Plan: 20-01 complete
+Phase: 21 of 21 (Admin update view JS fix) — Complete
+Plan: 21-01 complete
 Status: UNIFY complete, ready for next PLAN loop (transition-phase git commit pending)
-Last activity: 2026-05-13 — Closed loop for .paul/phases/20-category-edit-mojibake-fix/20-01-PLAN.md
+Last activity: 2026-05-13 — Closed loop for .paul/phases/21-admin-update-view-js-fix/21-01-PLAN.md
 
 Progress:
 - Milestone: [##########] 100% (Hotfix rolling)
-- Phase 20: [##########] 100%
+- Phase 21: [##########] 100%
 
 ## Loop Position
 
@@ -46,10 +46,15 @@ Phase 17: PLAN --> APPLY --> UNIFY ✓ ✓ ✓  [COMPLETE - 2026-04-20]
 Phase 18: PLAN --> APPLY --> UNIFY ✓ ✓ ✓  [COMPLETE - 2026-04-30]
 Phase 19: PLAN --> APPLY --> UNIFY ✓ ✓ ✓  [COMPLETE - 2026-05-13]
 Phase 20: PLAN --> APPLY --> UNIFY ✓ ✓ ✓  [COMPLETE - 2026-05-13]
+Phase 21: PLAN --> APPLY --> UNIFY ✓ ✓ ✓  [COMPLETE - 2026-05-13]
 ```
 ## Accumulated Context
 
 ### Decisions
+- 2026-05-13: Phase 21 loop closed with SUMMARY at .paul/phases/21-admin-update-view-js-fix/21-01-SUMMARY.md
+- 2026-05-13: Transition-phase git commit for Phase 21 not executed in this UNIFY run (deferred — pattern z faz 15-20)
+- 2026-05-13: Phase 21 APPLY complete — admin/templates/update/main-view.php zmodyfikowany (reorder <script> przed sekcję Changelog + sanityzacja zdalnego changeloga: preg_replace komentarzy HTML + strip_tags z whitelistą tagów formatujących); php -l OK; suita 846 testów zielona; human-verify approved
+- 2026-05-13: Created Phase 21 plan at .paul/phases/21-admin-update-view-js-fix/21-01-PLAN.md — fix niedziałających przycisków aktualizacji + Wyczyść cache w /admin/update/main_view/ (zdalny changelog z niezbalansowanym HTML "połykał" inline i footer-script). Reorder bloku <script> przed sekcję Changelog + sanityzacja zdalnego changeloga (strip_tags z whitelistą + usunięcie komentarzy HTML).
 - 2026-05-13: Phase 20 loop closed with SUMMARY at .paul/phases/20-category-edit-mojibake-fix/20-01-SUMMARY.md
 - 2026-05-13: Transition-phase git commit for Phase 20 not executed in this UNIFY run (deferred — pattern z faz 15-19)
 - 2026-05-13: Phase 20 APPLY complete — 9 wystąpień mojibake w admin/templates/shop-category/category-edit.php naprawionych (Treść, Język domyślny x2, rozwinięcie, Sortowanie produktów, Wyświetlić podkategorie, Tytuł kategorii, Blokuj indeksację); suita 846 zielona; human-verify approved
@@ -108,17 +113,17 @@ None.
 ### Blockers/Concerns
 None.
 
-### Skill Audit (Phase 20)
+### Skill Audit (Phase 21)
 | Expected | Invoked | Notes |
 |----------|---------|-------|
-| /feature-dev | ○ | Trivialny fix labelek — override per pattern poprzednich faz |
+| /feature-dev | ○ | Hotfix template-only z konkretną instrukcją w change.md — override per pattern poprzednich faz |
 | /koniec-pracy | ○ | Pending — uruchomić przy release update package |
 
 ## Session Continuity
 
 Last session: 2026-05-13
-Stopped at: Phase 20 complete, loop closed
+Stopped at: Phase 21 complete, loop closed
 Next action: Start next phase plan (transition-phase git commit pending), lub uruchomić /koniec-pracy jeśli zamykamy sesję
-Resume file: .paul/phases/20-category-edit-mojibake-fix/20-01-SUMMARY.md
+Resume file: .paul/phases/21-admin-update-view-js-fix/21-01-SUMMARY.md
 ---
 *STATE.md — Updated after every significant action*
diff --git a/.paul/changelog/2026-05-13.md b/.paul/changelog/2026-05-13.md
index aea17c8..0924ccb 100644
--- a/.paul/changelog/2026-05-13.md
+++ b/.paul/changelog/2026-05-13.md
@@ -14,14 +14,21 @@
 - Task 2: Weryfikacja braku regresji (grep w całym repo — 0 innych plików dotkniętych), suita 846 zielona
 - Task 3 (human-verify): Weryfikacja w panelu admina shoppro.project-dc.pl approved
 
+- [Phase 21, Plan 01] Fix niedziałających przycisków aktualizacji systemu + globalnego "Wyczyść cache" na /admin/update/main_view/ (klient nie mógł zaktualizować shopPRO)
+- Task 1: Reorder bloku `<script>` z handlerami #confirm/#confirmUpdateAll PRZED sekcję Changelog + sanityzacja zdalnego changeloga (preg_replace komentarzy HTML + strip_tags z whitelistą tagów formatujących); root cause = niezbalansowany zdalny HTML z shoppro.project-dc.pl „połykał" inline-script i footer-script; suita 846 zielona
+- Task 2 (human-verify): Weryfikacja w panelu admina approved (przyciski aktualizacji + Wyczyść cache + zdalny changelog renderuje się sanityzowany)
+
 ## Zmienione pliki
 
 - `autoload/front/LayoutEngine.php`
 - `admin/templates/shop-category/category-edit.php`
+- `admin/templates/update/main-view.php`
 - `tests/Unit/front/LayoutEngineMetaTagsTest.php` (nowy)
 - `.paul/phases/19-frontend-meta-tags-fix/19-01-PLAN.md` (nowy)
 - `.paul/phases/19-frontend-meta-tags-fix/19-01-SUMMARY.md` (nowy)
 - `.paul/phases/19-frontend-meta-tags-fix/DIAGNOSTICS.md` (nowy)
+- `.paul/phases/21-admin-update-view-js-fix/21-01-PLAN.md` (nowy)
+- `.paul/phases/21-admin-update-view-js-fix/21-01-SUMMARY.md` (nowy)
 - `.paul/STATE.md`
 - `.paul/ROADMAP.md`
 - `.gitignore`
diff --git a/.paul/docs/TECH_CHANGELOG.md b/.paul/docs/TECH_CHANGELOG.md
index acefae4..9b384a4 100644
--- a/.paul/docs/TECH_CHANGELOG.md
+++ b/.paul/docs/TECH_CHANGELOG.md
@@ -2,6 +2,17 @@
 
 > Chronologiczny log zmian technicznych — co i dlaczego.
 
+## v0.353 (2026-05-13)
+
+- Naprawiono niedzialajace przyciski aktualizacji systemu (`#confirm`, `#confirmUpdateAll`) i globalny "Wyczysc cache" (`#clear-cache-btn`) na `/admin/update/main_view/`. Klienci nie mogli aktualizowac shopPRO na instancjach.
+- Root cause: `admin/templates/update/main-view.php` pobieral zdalny changelog przez `file_get_contents` z `shoppro.project-dc.pl/updates/changelog.php`. Odpowiedz zawierala niezbalansowany HTML (niezamkniety `<script>`, `<!--`, `<style>` lub `<textarea>`), ktory "polykal" reszte dokumentu — inline-script z handlerami przyciskow i footer-script z `main-layout.php` (Wyczysc cache) nigdy sie nie parsowal jako JS. Brak bledu w konsoli — to nie byl blad JS, to byl HTML, ktory nigdy nie zostal wykonany jako skrypt.
+- Fix 1: blok `<script>` z handlerami przeniesiony PRZED sekcje Changelog (wczesniej kolejnosc: wersje -> log -> changelog -> script; teraz: wersje -> log -> script -> changelog). Handlery podpinaja sie niezaleznie od tego, co zwroci zdalny serwer.
+- Fix 2: sanityzacja zdalnego changeloga przed wyrenderowaniem: `preg_replace('/<!--.*?-->/s', '', $html)` + `strip_tags($html, '<p><br><b><strong><i><em><u><ul><ol><li><h1>-<h6><span><div><a><pre><code><hr>')`. Tagi strukturalne i "polykajace" (`<script>`, `<style>`, `<textarea>`, `<iframe>`, `<body>`, `</html>`) sa usuwane.
+- Skutek uboczny: footer-script z `main-layout.php` (przycisk Wyczysc cache + globalne wyszukiwanie produktow/zamowien + sprawdzanie aktualizacji w menu) dziala teraz na podstronie update.
+- Zysk bezpieczenstwa: zdalny serwis nie moze juz wstrzyknac JS w panel admina.
+- Wymagane akcje na produkcji po wgraniu update package: hard-reload przegladarki (Ctrl+F5) + restart PHP-FPM / wyczyszczenie OPcache (inaczej stary skompilowany szablon dalej bedzie serwowany).
+- Suita PHPUnit bez zmian: 846 testow / 2348 assertions.
+
 ## v0.352 (2026-05-13)
 
 - Naprawiono mojibake w labelkach formularza edycji kategorii w panelu admina (`/admin/shop_category/category_edit/id=X`). Plik `admin/templates/shop-category/category-edit.php` byl kiedys zapisany z UTF-8 zinterpretowanym jako Windows-1252 i ponownie zakodowanym do UTF-8 (classic double-encoding). 9 wystapien naprawione: `Treść`→Treść, `JÄ™zyk domyĹ›lny`→Język domyślny (x2), `rozwiniÄ™cie`→rozwinięcie, `Sortowanie produktĂłw`→Sortowanie produktów, `WyĹ›wietlić podkategorie`→Wyświetlić podkategorie, `TytuĹ‚ kategorii (h1)`→Tytuł kategorii (h1), `Blokuj indeksacjÄ™`→Blokuj indeksację.
diff --git a/.paul/phases/21-admin-update-view-js-fix/21-01-PLAN.md b/.paul/phases/21-admin-update-view-js-fix/21-01-PLAN.md
new file mode 100644
index 0000000..72d5a7f
--- /dev/null
+++ b/.paul/phases/21-admin-update-view-js-fix/21-01-PLAN.md
@@ -0,0 +1,173 @@
+---
+phase: 21-admin-update-view-js-fix
+plan: 01
+type: execute
+wave: 1
+depends_on: []
+files_modified:
+  - admin/templates/update/main-view.php
+autonomous: false
+delegation: off
+---
+
+<objective>
+## Goal
+Naprawić niedziałające przyciski na `/admin/update/main_view/`: "Aktualizuj do wyższej wersji" (`#confirm`), "Aktualizuj do najwyższej wersji" (`#confirmUpdateAll`) oraz globalny "Wyczyść cache" (`#clear-cache-btn`) z headera admina.
+
+## Purpose
+Na instancjach klientów shopPRO aktualizacja wersji nie była możliwa — zdalny changelog z `shoppro.project-dc.pl/updates/changelog.php` wstrzykiwał niezbalansowany HTML (niezamknięty `<script>`/`<style>`/`<textarea>`/`<!--`), który „połykał" pozostałą część dokumentu jako tekst i blokował parsowanie inline-scriptu z handlerami oraz footer-scriptu z `main-layout.php`. Bez tej naprawy klienci nie mogą aktualizować systemu.
+
+## Output
+Zmodyfikowany plik `admin/templates/update/main-view.php`:
+1. Blok `<script>` z handlerami przeniesiony PRZED sekcję Changelog.
+2. Zdalny changelog sanityzowany przed wyrenderowaniem (usunięcie komentarzy HTML + `strip_tags` z białą listą).
+</objective>
+
+<context>
+## Project Context
+@.paul/PROJECT.md
+@.paul/ROADMAP.md
+@.paul/STATE.md
+
+## Source Files
+@admin/templates/update/main-view.php
+@change.md
+
+<clarifications>
+- **Scope** — Wystarczy fix zgodny z change.md (jeden plik, dwa kroki)?
+  → Odpowiedź: brak pytań — change.md zawiera kompletny opis problemu, przyczyny i konkretne fragmenty kodu do wdrożenia. Plan = mechaniczne wdrożenie change.md.
+</clarifications>
+</context>
+
+<acceptance_criteria>
+
+## AC-1: Handlery JS działają niezależnie od treści zdalnego changeloga
+```gherkin
+Given administrator jest na /admin/update/main_view/ z wersją starszą niż najnowsza
+And zdalny serwer shoppro.project-dc.pl zwraca dowolny HTML (nawet niezbalansowany)
+When admin klika "Aktualizuj do wyższej wersji" lub "Aktualizuj do najwyższej wersji"
+Then otwiera się dialog `$.confirm` (potwierdzenie aktualizacji)
+And po potwierdzeniu uruchamia się aktualizacja (redirect /admin/update/update/ lub AJAX /admin/update/updateAll/)
+```
+
+## AC-2: Globalny przycisk "Wyczyść cache" działa na podstronie update
+```gherkin
+Given administrator jest na /admin/update/main_view/
+When klika "Wyczyść cache" w headerze admina (`#clear-cache-btn`)
+Then footer-script z main-layout.php obsługuje kliknięcie (nie jest „połknięty" przez nieparzysty tag changeloga)
+```
+
+## AC-3: Zdalny changelog nadal się wyświetla, ale nie może popsuć strony
+```gherkin
+Given zdalny changelog zawiera `<script>`, `<style>`, `<textarea>`, `<iframe>`, `<!--...-->` lub niezamknięte tagi strukturalne
+When szablon main-view.php renderuje sekcję Changelog
+Then niedozwolone tagi są usunięte przez `strip_tags` (whitelist: <p><br><b><strong><i><em><u><ul><ol><li><h1>-<h6><span><div><a><pre><code><hr>)
+And komentarze HTML `<!--...-->` są usuwane
+And treść tekstowa changeloga + dozwolone tagi formatujące są widoczne na stronie
+```
+
+</acceptance_criteria>
+
+<tasks>
+
+<task type="auto">
+  <name>Task 1: Reorder + sanitize w main-view.php</name>
+  <files>admin/templates/update/main-view.php</files>
+  <action>
+    Wdrożyć zmianę zgodnie z change.md:
+
+    1. **Przenieść blok `<script type="text/javascript">...</script>`** (linie 64-140 obecnej wersji) PRZED sekcję Changelog (przed `<div class="panel">` zawierający `<span class="panel-title">Changelog</span>`).
+
+       Nowa kolejność w szablonie:
+       - panel "Aktualizacja systemu" (wersje + przyciski)
+       - panel "Log ostatniej aktualizacji" (warunkowy)
+       - **`<script>` z handlerami**  ← przeniesiony tutaj
+       - panel "Changelog" (zdalny `file_get_contents` + sanityzacja)
+
+    2. **Zastąpić linię z `file_get_contents`** (obecnie linia 60):
+       ```php
+       <?= @file_get_contents( 'https://shoppro.project-dc.pl/updates/changelog.php?ver=' . $this->ver ); ?>
+       ```
+       na blok sanityzacji:
+       ```php
+       <?php
+       $changelog = (string) @file_get_contents( 'https://shoppro.project-dc.pl/updates/changelog.php?ver=' . $this->ver );
+       $changelog = preg_replace( '/<!--.*?-->/s', '', $changelog );
+       $changelog = strip_tags( $changelog, '<p><br><b><strong><i><em><u><ul><ol><li><h1><h2><h3><h4><h5><h6><span><div><a><pre><code><hr>' );
+       echo $changelog;
+       ?>
+       ```
+
+    Nie zmieniać:
+    - logiki JS w bloku `<script>` (handlery `#confirm`, `#confirmUpdateAll`, funkcja `updateAll`)
+    - struktury HTML paneli (klasy CSS, ID, atrybuty)
+    - tekstów polskich w szablonie
+    - składni krótkich tagów `<?` (kompatybilność PHP < 8.0 — szablon używa krótkich tagów, zachować konwencję)
+
+    Plik zostaje UTF-8 bez BOM.
+
+    Unikać: wprowadzania dodatkowych zależności, refaktoringu spoza zakresu change.md, zmiany URL zdalnego changeloga.
+  </action>
+  <verify>
+    1. `php -l admin/templates/update/main-view.php` → "No syntax errors"
+    2. Grep: `grep -n "strip_tags" admin/templates/update/main-view.php` → linia z whitelistą obecna
+    3. Grep: blok `<script type="text/javascript">` znajduje się przed `<span class="panel-title">Changelog</span>` w pliku (sprawdzić numery linii)
+  </verify>
+  <done>AC-3 satisfied (sanityzacja whitelist + usunięcie komentarzy HTML); strukturalna baza dla AC-1 i AC-2 (reorder przed changelogiem)</done>
+</task>
+
+<task type="checkpoint:human-verify" gate="blocking">
+  <what-built>
+    Reorder bloku `<script>` przed sekcję Changelog + sanityzacja zdalnego changeloga w `admin/templates/update/main-view.php`.
+  </what-built>
+  <how-to-verify>
+    1. Wgrać zmodyfikowany plik na instancję testową (lub lokalnie, jeśli setup pozwala).
+    2. Hard-reload (Ctrl+F5) w przeglądarce.
+    3. Restart PHP-FPM / wyczyścić OPcache (jeśli aktywny).
+    4. Wejść na `/admin/update/main_view/` jako admin (przy wersji starszej niż najnowsza, żeby przyciski się pokazały).
+    5. **AC-1:** Kliknąć "Aktualizuj do wyższej wersji" → dialog `$.confirm` musi się otworzyć. To samo dla "Aktualizuj do najwyższej wersji".
+    6. **AC-2:** Kliknąć "Wyczyść cache" w headerze admina → handler musi zadziałać (komunikat / akcja zgodna z `main-layout.php`).
+    7. **AC-3:** Sekcja Changelog nadal wyświetla treść ze zdalnego serwera (tekst + formatowanie), ale bez `<script>`/`<style>`/`<iframe>` (View Source).
+    8. Sprawdzić DevTools console — brak nowych błędów JS związanych z `main-view.php`.
+  </how-to-verify>
+  <resume-signal>Type "approved" to continue, or describe issues to fix</resume-signal>
+</task>
+
+</tasks>
+
+<boundaries>
+
+## DO NOT CHANGE
+- Logikę JS handlerów aktualizacji (`#confirm`, `#confirmUpdateAll`, funkcja `updateAll`) — wyłącznie reorder bloku.
+- `admin/templates/site/main-layout.php` (footer-script `#clear-cache-btn`) — naprawa jest skutkiem ubocznym reorderu w main-view.
+- URL zdalnego changeloga (`https://shoppro.project-dc.pl/updates/changelog.php`).
+- Logikę kontrolera `UpdateController` i endpointy `/admin/update/update/`, `/admin/update/updateAll/`.
+- Inne szablony w `admin/templates/update/`.
+
+## SCOPE LIMITS
+- Tylko jeden plik: `admin/templates/update/main-view.php`.
+- Brak testów PHPUnit (zmiana w warstwie szablonu, brak unit-testowalnej logiki).
+- Brak zmian w bazie / migracjach.
+- Brak release update package — to robi `/koniec-pracy` po UNIFY.
+- Brak zmiany sposobu pobierania changeloga (np. cache, timeout, fallback) — to byłby osobny scope.
+
+</boundaries>
+
+<verification>
+Before declaring plan complete:
+- [ ] `php -l admin/templates/update/main-view.php` passes
+- [ ] Blok `<script>` znajduje się przed sekcją Changelog (kolejność w pliku)
+- [ ] Sekcja Changelog zawiera `strip_tags` z whitelistą formatowania
+- [ ] Human-verify checkpoint approved (3 przyciski działają, changelog renderuje się sanityzowany)
+- [ ] All acceptance criteria met
+</verification>
+
+<success_criteria>
+- AC-1, AC-2, AC-3 spełnione i potwierdzone w human-verify
+- Brak regresji innych funkcji panelu admina
+- Pełna suita PHPUnit (`./test.ps1`) nadal zielona (846 testów — bez nowych testów w tym planie)
+</success_criteria>
+
+<output>
+After completion, create `.paul/phases/21-admin-update-view-js-fix/21-01-SUMMARY.md`
+</output>
diff --git a/.paul/phases/21-admin-update-view-js-fix/21-01-SUMMARY.md b/.paul/phases/21-admin-update-view-js-fix/21-01-SUMMARY.md
new file mode 100644
index 0000000..c7dc012
--- /dev/null
+++ b/.paul/phases/21-admin-update-view-js-fix/21-01-SUMMARY.md
@@ -0,0 +1,124 @@
+---
+phase: 21-admin-update-view-js-fix
+plan: 01
+subsystem: admin
+tags: [template, js, htmlsanitize, update, admin-panel]
+
+requires:
+  - phase: none
+    provides: none
+provides:
+  - Działające przyciski aktualizacji systemu (`#confirm`, `#confirmUpdateAll`) na /admin/update/main_view/
+  - Działający globalny przycisk "Wyczyść cache" (`#clear-cache-btn`) na tej podstronie
+  - Sanityzacja zdalnego changeloga (whitelist tagów formatujących + usunięcie komentarzy HTML)
+affects: [admin update workflow, future remote-content includes]
+
+tech-stack:
+  added: []
+  patterns:
+    - "Zdalne file_get_contents w szablonie sanityzować przez strip_tags z whitelistą + usunięcie komentarzy HTML; krytyczne <script> renderować PRZED takim includem"
+
+key-files:
+  created: []
+  modified:
+    - admin/templates/update/main-view.php
+
+key-decisions:
+  - "Reorder: blok <script> z handlerami PRZED sekcję Changelog (nie po) — odporność na uszkodzony zdalny HTML"
+  - "Whitelist strip_tags ogranicza zdalny changelog do tagów formatujących; <script>/<style>/<textarea>/<iframe> wykluczone"
+
+patterns-established:
+  - "Sanityzacja zdalnego HTML w szablonach admina: preg_replace('/<!--.*?-->/s', '', $html) + strip_tags(whitelist)"
+
+duration: ~15min
+started: 2026-05-13T00:00:00Z
+completed: 2026-05-13T00:00:00Z
+---
+
+# Phase 21 Plan 01: Admin update view JS fix — Summary
+
+**Naprawiono niedziałające przyciski aktualizacji systemu i globalny "Wyczyść cache" na `/admin/update/main_view/` przez reorder bloku `<script>` przed sekcję Changelog + sanityzację zdalnego changeloga w `admin/templates/update/main-view.php`.**
+
+## Performance
+
+| Metric | Value |
+|--------|-------|
+| Duration | ~15min |
+| Tasks | 1 auto + 1 checkpoint:human-verify |
+| Files modified | 1 |
+| Tests | 846 / 2348 asercji — OK |
+
+## Acceptance Criteria Results
+
+| Criterion | Status | Notes |
+|-----------|--------|-------|
+| AC-1: Handlery JS działają niezależnie od treści zdalnego changeloga | Pass | Blok `<script>` w linii 55, przed sekcją Changelog w linii 135 — handlery `#confirm`/`#confirmUpdateAll` podpinają się przed parsowaniem zdalnego HTML |
+| AC-2: Globalny "Wyczyść cache" działa na podstronie update | Pass | Footer-script z `main-layout.php` (#clear-cache-btn) nie jest już „połykany" przez niezbalansowany tag changeloga — potwierdzone human-verify |
+| AC-3: Zdalny changelog renderuje się sanityzowany | Pass | `preg_replace('/<!--.*?-->/s', '', ...)` usuwa komentarze HTML, `strip_tags` z whitelistą `<p><br><b><strong><i><em><u><ul><ol><li><h1>-<h6><span><div><a><pre><code><hr>` wycina niedozwolone tagi strukturalne i wykonywalne |
+
+## Accomplishments
+
+- Klient może aktualizować shopPRO na instancjach — root cause (niezbalansowany zdalny HTML „połykający" inline-script handlerów i footer-script `main-layout.php`) wyeliminowany przez reorder + sanityzację.
+- Globalny "Wyczyść cache" w headerze admina działa nie tylko na podstronie update, ale i pośrednio wszędzie indziej (footer-script się teraz parsuje).
+- Dodatkowy zysk bezpieczeństwa: zdalny `shoppro.project-dc.pl/updates/changelog.php` nie może już wstrzyknąć `<script>`/`<style>`/`<iframe>` w panel admina.
+
+## Files Created/Modified
+
+| File | Change | Purpose |
+|------|--------|---------|
+| `admin/templates/update/main-view.php` | Modified | Reorder bloku `<script>` przed sekcję Changelog + sanityzacja zdalnego changeloga (strip_tags whitelist + usunięcie komentarzy HTML) |
+
+## Decisions Made
+
+| Decision | Rationale | Impact |
+|----------|-----------|--------|
+| Reorder zamiast np. wyłączenia zdalnego changeloga | Zachowuje istniejącą funkcjonalność (admin widzi nowości), eliminuje root cause | Minimalna zmiana, ten sam UX |
+| `strip_tags` z białą listą zamiast np. iframe sandbox | Najprostszy, zerowy narzut, działa na PHP 7.4, brak dodatkowych zależności | Zdalny content może być tylko tekstem z formatowaniem — wystarczy do changeloga |
+| Whitelist obejmuje tagi formatujące + `<div>`/`<span>`/`<a>` | Zachowuje typową strukturę changeloga | Zdalny serwer nie może już strukturalnie popsuć strony |
+
+## Deviations from Plan
+
+### Summary
+
+| Type | Count | Impact |
+|------|-------|--------|
+| Auto-fixed | 0 | — |
+| Scope additions | 0 | — |
+| Deferred | 0 | — |
+
+**Total impact:** Plan wykonany dokładnie według change.md, bez odstępstw.
+
+### Deferred Items
+
+None.
+
+## Issues Encountered
+
+| Issue | Resolution |
+|-------|------------|
+| `./test.ps1` z CLAUDE.md nie istnieje w repo (zmiana w lokalnej konfiguracji) | Uruchomiono `php phpunit.phar` bezpośrednio — 846 testów zielonych |
+
+## Skill Audit (Phase 21)
+
+| Expected | Invoked | Notes |
+|----------|---------|-------|
+| /feature-dev | ○ | Hotfix template-only z konkretną instrukcją w change.md — override per pattern poprzednich faz |
+| /koniec-pracy | ○ | Pending — uruchomić przy release update package |
+
+Skill audit: not blocking (warning only).
+
+## Next Phase Readiness
+
+**Ready:**
+- Repo gotowe do `/koniec-pracy` (release update package z nową wersją zawierającą fix `admin/templates/update/main-view.php`)
+- Brak regresji testowej — 846 testów zielonych
+
+**Concerns:**
+- Po wgraniu update package na instancje klientów konieczny: hard-reload (Ctrl+F5) + restart PHP-FPM / wyczyszczenie OPcache (zgodnie z change.md sekcja "Po wgraniu")
+
+**Blockers:**
+- None
+
+---
+*Phase: 21-admin-update-view-js-fix, Plan: 01*
+*Completed: 2026-05-13*
diff --git a/admin/templates/update/main-view.php b/admin/templates/update/main-view.php
index ebabea3..dfcd62f 100644
--- a/admin/templates/update/main-view.php
+++ b/admin/templates/update/main-view.php
@@ -52,15 +52,6 @@
 </div>
 <? endif; ?>
 
-<div class="panel">
-  <div class="panel-heading">
-    <span class="panel-title">Changelog</span>
-  </div>
-  <div class="panel-body">
-    <?= @file_get_contents( 'https://shoppro.project-dc.pl/updates/changelog.php?ver=' . $this->ver ); ?>
-  </div>
-</div>
-
 <script type="text/javascript">
 $(function() {
   var version_current = <?= $this->ver; ?>;
@@ -138,3 +129,17 @@ $(function() {
   }
 });
 </script>
+
+<div class="panel">
+  <div class="panel-heading">
+    <span class="panel-title">Changelog</span>
+  </div>
+  <div class="panel-body">
+    <?php
+    $changelog = (string) @file_get_contents( 'https://shoppro.project-dc.pl/updates/changelog.php?ver=' . $this->ver );
+    $changelog = preg_replace( '/<!--.*?-->/s', '', $changelog );
+    $changelog = strip_tags( $changelog, '<p><br><b><strong><i><em><u><ul><ol><li><h1><h2><h3><h4><h5><h6><span><div><a><pre><code><hr>' );
+    echo $changelog;
+    ?>
+  </div>
+</div>
diff --git a/change.md b/change.md
new file mode 100644
index 0000000..cca9d88
--- /dev/null
+++ b/change.md
@@ -0,0 +1,56 @@
+# Zmiana 3: Naprawa JS na stronie /admin/update/main_view/ (przyciski aktualizacji + Wyczyść cache)
+
+## Plik
+`admin/templates/update/main-view.php`
+
+## Problem
+Na podstronie `/admin/update/main_view/` nie działały:
+- przycisk **„Aktualizuj do wyższej wersji"** (`#confirm`)
+- przycisk **„Aktualizuj do najwyższej wersji"** (`#confirmUpdateAll`)
+- globalny przycisk **„Wyczyść cache"** (`#clear-cache-btn`) z headera admina
+
+W konsoli przeglądarki **nie było żadnego błędu JS**. Kliknięcie powodowało jedynie dopisanie `#` do URL-a (`/admin/update/main_view/#`).
+
+## Przyczyna
+W szablonie znajdowało się pobieranie zdalnego changeloga przez `file_get_contents` z `https://shoppro.project-dc.pl/updates/changelog.php`:
+
+```php
+<?= @file_get_contents( 'https://shoppro.project-dc.pl/updates/changelog.php?ver=' . $this->ver ); ?>
+```
+
+Odpowiedź zdalnego serwera zawierała niezbalansowany HTML (np. niezamknięty `<script>`, `<!--`, `<style>` albo `<textarea>`), który „połykał" całą resztę dokumentu jako tekst wewnątrz tego nieparzystego tagu. Skutki:
+- Inline-script z handlerami przycisków aktualizacji (zaraz pod changelogiem) nie był parsowany jako JS.
+- Footer-script z `main-layout.php` (handler `#clear-cache-btn` i globalne wyszukiwanie) też był „w środku" połkniętego HTML i nigdy się nie uruchamiał na tej podstronie.
+- Konsola nie pokazywała błędu, bo to nie był błąd JS — to był po prostu HTML, który nigdy nie został wykonany jako skrypt.
+
+## Co zmieniono
+
+### 1. Blok `<script>` z handlerami przeniesiony przed sekcję Changelog
+Wcześniej kolejność w szablonie była: panel z wersjami → log → **changelog (zdalny)** → `<script>`. Po zmianie: panel z wersjami → log → **`<script>`** → changelog (zdalny). Dzięki temu handlery `#confirm` i `#confirmUpdateAll` podpinają się niezależnie od tego, co zwróci zdalny serwer.
+
+### 2. Sanitizacja odpowiedzi zdalnego changeloga
+Przed wyrenderowaniem changelog jest czyszczony:
+
+```php
+$changelog = (string) @file_get_contents( 'https://shoppro.project-dc.pl/updates/changelog.php?ver=' . $this->ver );
+$changelog = preg_replace( '/<!--.*?-->/s', '', $changelog );
+$changelog = strip_tags( $changelog, '<p><br><b><strong><i><em><u><ul><ol><li><h1><h2><h3><h4><h5><h6><span><div><a><pre><code><hr>' );
+echo $changelog;
+```
+
+- Usuwane są komentarze HTML (`<!--…-->`).
+- `strip_tags` z wąską białą listą zostawia tylko tagi formatujące — wszystkie tagi strukturalne i mogące „połknąć" treść (`<script>`, `<style>`, `<textarea>`, `<iframe>`, `<body>`, `</html>` itp.) są usuwane.
+
+### 3. Naprawiony też skutek uboczny
+Po tych zmianach poprawnie działa również:
+- footer-script z `main-layout.php` (przycisk **Wyczyść cache** + globalne wyszukiwanie produktów/zamówień + sprawdzanie aktualizacji w menu)
+
+## Efekt
+- Przyciski aktualizacji systemu na `/admin/update/main_view/` działają.
+- Przycisk „Wyczyść cache" działa na tej (i każdej innej) podstronie admina.
+- Zdalny changelog ze `shoppro.project-dc.pl` nadal się wyświetla, ale nie może już popsuć struktury strony.
+- Dodatkowy zysk bezpieczeństwa: zdalny serwis nie może wstrzyknąć JS w panel admina.
+
+## Po wgraniu
+1. Hard-reload przeglądarki (Ctrl+F5) — stary HTML siedzi w cache klienta.
+2. Restart PHP-FPM / wyczyszczenie OPcache — inaczej stary skompilowany szablon dalej będzie serwowany.