mstrhakr · mstrhakr · Jul 2, 2026 · Jul 3, 2026 · Jul 3, 2026 · Jul 6, 2026
diff --git a/.github/workflows/sync-plugin-url.yml b/.github/workflows/sync-plugin-url.yml
@@ -80,7 +80,7 @@ jobs:
 
           if [[ "$CURRENT_URL_BRANCH" != "$BRANCH" ]]; then
             echo "Branch mismatch - fixing pluginURL..."
-            sed -i -E "s#^<!ENTITY pluginURL \"https://raw.githubusercontent.com/&github;/[^/]*/&name;\\.plg\">#<!ENTITY pluginURL \"https://raw.githubusercontent.com/&github;/${BRANCH}/&name;.plg\">#" "$PLG_FILE"
+            sed -i -E "s#^<!ENTITY pluginURL \"https://raw.githubusercontent.com/&github;/[^/]*/&name;\\.plg\">#<!ENTITY pluginURL \"https://raw.githubusercontent.com/\\&github;/${BRANCH}/\\&name;.plg\">#" "$PLG_FILE"
 
             EXPECTED_LINE="<!ENTITY pluginURL \"https://raw.githubusercontent.com/&github;/${BRANCH}/&name;.plg\">"
             if ! grep -Fxq "$EXPECTED_LINE" "$PLG_FILE"; then

diff --git a/README.md b/README.md
@@ -81,12 +81,12 @@ The built-in editor provides multiple tabs for managing your compose stack:
 - **Autostart & Shutdown** - Configurable per-stack autostart with optional force-recreate, wait-for-Docker, and configurable timeouts. Graceful shutdown handling.
 - **Visibility & Filtering** - Optionally hide Compose-managed containers from the native Docker UI and Dashboard tile to avoid duplicate entries (behavior varies by unRAID version).
 - **Backup & Restore** - Manual and scheduled backups with selective restore from the UI.
-- **Web Terminal** - Integrated ttyd terminal for live, colorized compose command output; also supports a basic output mode.
+- **Web Terminal** - Integrated ttyd terminal for live, colorized compose command output.
 - **Profiles** - Full support for Docker Compose profiles, including multi-profile selection per action.
 - **External Paths** - Compose files and env files can live outside the default projects folder (external compose path and env path per stack).
 - **Override File Management** - Centralized management of override files (`compose.override.yaml`, `compose.override.yml`, `docker-compose.override.yaml`, `docker-compose.override.yml`) with service rename handling.
 - **Stack Editor** - Full-screen modal editor with four tabs: Compose (YAML with live validation), ENV, Web UI Labels (icon/WebUI/shell per service via override file), and Settings (name, description, icon URL, WebUI URL, default profile, external paths). Ctrl+S to save, Esc to close.
-- **Basic / Advanced View Toggle** - Toggle between a compact view and an advanced view exposing additional columns (SHA diffs, force-update links) — scoped to the Compose tab to avoid affecting the Docker tab.
+- **Column Customizer & Layout** - Choose which stack and service columns are visible and in what order; extra detail fields (for example SHA snippets and force-update links) follow your saved layout in the Compose tab.
 - **Compose File Discovery** - Automatically detects all four standard compose file names (`compose.yaml`, `docker-compose.yaml`, `compose.yml`, `docker-compose.yml`).
 - **Filename Preservation** - Existing compose and override filenames are preserved; upgrades do not auto-rename your stack files.
 - **Build Stack Support** - Stacks with a `build:` section in the compose file are detected automatically; context menu and update labels adapt ("Build", "Build & Up", "Update & Rebuild").

diff --git a/compose.manager.plg b/compose.manager.plg
@@ -2,15 +2,15 @@
 <!DOCTYPE PLUGIN [
 <!ENTITY name "compose.manager">
 <!ENTITY author "mstrhakr">
-<!ENTITY version     "2026.07.02">
+<!ENTITY version     "2026.08.23.2252">
 <!ENTITY launch "Settings/&name;.settings">
 <!ENTITY packageVER "&version;">
-<!ENTITY packageMD5  "936c69547f5a759e90f8915409f41835">
-<!ENTITY pkgBUILD    "0825">
+<!ENTITY packageMD5  "43bf2ab4917dbad616a9e39ac7291a92">
+<!ENTITY pkgBUILD    "2252">
 <!ENTITY packageName "&name;-&packageVER;-noarch-&pkgBUILD;">
 <!ENTITY packagefile "&packageName;.txz">
 <!ENTITY github "mstrhakr/compose_plugin">
-<!ENTITY pluginURL "https://raw.githubusercontent.com/&github;/main/&name;.plg">
+<!ENTITY pluginURL "https://raw.githubusercontent.com/&github;/dev/&name;.plg">
 <!ENTITY packageURL "https://github.com/&github;/releases/download/v&version;/&packagefile;">
 <!ENTITY pluginsPATH "/boot/config/plugins">
 <!ENTITY pluginLOC "&pluginsPATH;/&name;">
@@ -36,67 +36,49 @@
 >
 
 <CHANGES>
-###2026.07.02
-- Features (compose): enhance column customization with reorder functionality and UI updates
-- Features (compose): implement stack row striping synchronization for improved UI consistency
-- Features (compose): add health status column and related functionality to stack and container views
-- Features: add custom interval settings for compose stats and enhance nchan publisher
-- Features: refactor column customization UI with transfer lists and responsive design
-- Features: enhance stack toggle functionality with batching and user intent tracking
-- Features: add expand/collapse all functionality for compose stacks
-- Features: promote col customizer and remove basic/advanced toggle
-- Features: Implement snapshot loading for compose metrics and enhance data publishing to ensure data shows during progressive loading
-- Features: Add column visibility customization for stack and service tables
-- Features (tests): add tests for pruning auto-managed and legacy labels only orphans
-- Features: add 'Remove Orphans by Default' option and integrate into compose actions
-- Features: add progressive stack list loading
-- Features (container): add persistent container cache and icon resolution logic
-- Features: return to update dialog when changelog is dismissed
-- Features: show docker.versions changelogs in the update dialog
-- Bug Fixes (composeStats): enhance memory value parsing and sanitize docker stats fields
-- Bug Fixes: enhance logging for stack management and settings handling
-- Bug Fixes: add support for --remove-orphans flag in compose command
-- Bug Fixes: add support for removeOrphans flag in performComposeAction
-- Bug Fixes: delay stack refresh after prompt to ensure proper UI feedback
-- Bug Fixes (cache): add endpoint to retrieve persistent container cache and update loading method
-- Bug Fixes (deploy.sh, test.sh): update file permissions to make scripts executable
-- Bug Fixes (Exec.php): update dockerVersionsInstalled check to verify plugin directory existence and cleanup tests
-- Bug Fixes (ExecActionsTest): improve testGetSavedUpdateStatusDockerVersionsNotInstalled for determinism
-- Bug Fixes (composeLoadlist): bind autostart change handler early for dynamic rows and update loading status on success
-- Bug Fixes (Exec.php): improve dockerVersionsInstalled check to verify actual changelog assets
-- Bug Fixes (sync-plugin-url): enhance branch detection and pluginURL synchronization logic
-- Bug Fixes (docker.versions): conditionally load external styles for Docker versions if available
-- Bug Fixes (compose): optimize cache invalidation logic based on stack/container structure changes
-- Bug Fixes (changelog): conditionally load changelog script if available so it works when compose is on its own tab
-- Bug Fixes (update): update button now triggers update action instead of always triggering force update
-- Bug Fixes (composeSortable): enhance details row detachment logic during drag-and-drop
-- Bug Fixes (composeSortable): improve drag-and-drop behavior by detaching non-sortable rows
-- Bug Fixes (profiles): unify action profile picker and enforce profile precedence
-- Bug Fixes: plug poll interval leak and skip dialog reopen when warnings disabled
-- Bug Fixes: whitelist changelog message types, filter scaffolding noise
-- Bug Fixes: discard stale Nchan buffer and concurrent changelog messages
-- Bug Fixes: correct version and package details in plugin metadata
-- Performance (compose): throttle dockerload cache paints during websocket bursts
-- Performance (compose): avoid full-table applyListView during progressive row inserts
-- Performance (compose): debounce composeListRefreshed during progressive row load
-- Performance: implement parallel project loading with request queuing and progress tracking
-- Refactoring: update echoComposeCommand and echoComposeCommandMultiple to use options array
-- Refactoring: delegate changelog display to docker.versions' showChangeLog()
-- Documentation: document docker.versions changelog integration in user guide
-- Tests: add unit tests for getSavedUpdateStatus docker.versions detection
-- Chores: update changelog for v2026.06.18.1637 [skip ci]
-- Chores: update changelog for v2026.06.15.1000 [skip ci]
-- Chores: update changelog for v2026.06.14.1531 [skip ci]
-- Chores: update changelog for v2026.06.14.1530 [skip ci]
-- Chores: update changelog for v2026.06.14.1451 [skip ci]
-- Chores: update changelog for v2026.06.11.1526 [skip ci]
-- Chores: update changelog for v2026.06.11.1517 [skip ci]
+###2026.08.23.2252
+- Features: enhance error handling and metadata retrieval in compose loading process
+- Features: implement client-side control for compose_info publisher and enhance WebSocket management for hidden tabs
+- Features: add additional ignored error messages for PHPStan analysis
+- Features: implement plugin-local update check for Compose Manager to enhance image update accuracy
+- Features (tests): enhance foreground operation tests for Compose Manager with modal interactions and image validation
+- Features (tests): add UI operation flow tests for Compose Manager and extract shared helpers
+- Features (notification): add composeSendNotification function for stack delete notifications
+- Features (e2e): add Playwright end-to-end tests for Compose Manager
+- Features (cache): add function to purge deleted stack caches and update UI accordingly
+- Features (settings): enhance auto-check updates functionality with mode selection and custom intervals
+- Features (settings-page): add functions to count changed settings and update UI accordingly
+- Features (settings-page): enhance global actions and settings form handling
+- Features (settings-page): enhance defaults with auto/manual verbage
+- Features (settings-page): enhance settings tab with descriptive help text and rephrase section titles
+- Features (settings-page): reorganize and enhance update checking section
+- Features (column-layout): implement shared column layout and visibility helpers
+- Bug Fixes (tests): use PATH_SEPARATOR for COMPOSE_FILE in env file to support Windows development
+- Bug Fixes (icons): resolve native Docker tab/Dashboard icons for local paths (#129)
+- Bug Fixes: add missing Playwright dependencies installation step in E2E test setup
+- Bug Fixes: ensure function definitions are wrapped in function_exists checks to prevent redeclaration errors
+- Bug Fixes: remove HTML coverage report generation from PHPUnit configuration
+- Bug Fixes: enhance image digest retrieval and add running container check in auto-update script to match manual update path Fixes #132
+- Bug Fixes: ensure new stacks create app-managed project override templates and update tests accordingly Fixes #134
+- Bug Fixes: ensure proper exit code propagation for compose commands and record operation exit status
+- Bug Fixes (nchan): optimize docker stats publishing and address shared-memory exhaustion
+- Bug Fixes: enhance stack update handling with improved reload queue management
+- Bug Fixes (tests): ensure tests remove containers each time
+- Bug Fixes (settings): remove unused referrer handling script for cleaner settings page
+- Bug Fixes (settings): add debug logging functions for settings changes and state tracking
+- Bug Fixes (stack): simplify removal logic in composeDeleteStackFolder function
+- Bug Fixes (ui): make stack deletion dynamic without full reload
+- Bug Fixes (stack): guard and harden deleteStack folder removal
+- Bug Fixes (menu): centralize header menu visibility condition
+- Bug Fixes (compose-pull): refactor ComposePullConfirmed function to use options object for parameters
+- Bug Fixes (sync-plugin-url): correct escaping in sed command for pluginURL update
+- Refactoring: remove basic output style handling
+- Refactoring (settings-page): reorganize settings and update help funcs
 - Chores: sync pluginURL+README for dev branch [skip ci]
-- Chores: remove test compose setup
-- Fix dropdown z-index on docker page when clicking on stack icon
-- Add support for additional compose files per stack
-- Potential fix for pull request finding
-- [View all changes](https://github.com/mstrhakr/compose_plugin/compare/v2026.06.06...v2026.07.02)
+- Chores (columns): cleanup advanced/basic view mode references and legacy logic
+- Refactor IconTest and remove redundant tests; add ComposeListEndpointTest
+- [PR #139](https://github.com/mstrhakr/compose_plugin/pull/139)
+- [beta release diff](https://github.com/mstrhakr/compose_plugin/compare/v2026.07.02...v2026.08.23.2252)
 </CHANGES>
 
 <!-- The 'pre-install' script. -->

diff --git a/docs/testing.md b/docs/testing.md
@@ -30,6 +30,36 @@ php vendor/bin/phpunit --coverage-html tests/coverage/html
 docker run --rm -v "${PWD}:/code" -w /code bats/bats:latest tests/unit/*.bats
 ```
 
+### Running Playwright E2E (Live Server, Read-Only)
+
+The E2E suite is intentionally designed for non-destructive smoke checks against a real Unraid server.
+
+```bash
+cd tests/e2e
+npm install
+npx playwright install chromium firefox
+```
+
+Create or refresh auth state:
+
+```bash
+cd tests/e2e
+E2E_BASE_URL="https://your-unraid-host" npx playwright codegen "$E2E_BASE_URL" --save-storage=.auth/storage-state.json
+```
+
+Run the suite:
+
+```bash
+cd tests/e2e
+E2E_BASE_URL="https://your-unraid-host" \
+E2E_STORAGE_STATE=".auth/storage-state.json" \
+E2E_COMPOSE_PATH="/Docker/Compose" \
+E2E_IGNORE_HTTPS_ERRORS="1" \
+npm test
+```
+
+See `tests/e2e/README.md` for details and safety guardrails.
+
 ## VS Code Integration
 
 The workspace is configured with PHPUnit Test Explorer. After opening the project:
@@ -41,7 +71,7 @@ The workspace is configured with PHPUnit Test Explorer. After opening the projec
 
 ## Test Structure
 
-```
+```text
 tests/
 ├── framework/          # Submodule: plugin-tests framework
 │   └── src/

diff --git a/phpstan.neon b/phpstan.neon
@@ -22,13 +22,19 @@ parameters:
         - "#my_scale_status#"
         - "#csrf_token#"
         - "#getComposeRoot#"
+        - "#getCurlHandle#"
       identifier: function.notFound
     # Platform classes (Docker management)
     - messages:
         - "#DockerClient#"
         - "#DockerUpdate#"
         - "#DockerUtil#"
       identifier: class.notFound
+    # method_exists() against platform classes above is always false in
+    # static analysis (the classes only exist at Unraid runtime), which is
+    # expected -- it's a runtime capability check, not a real bug.
+    - message: "#Call to function method_exists\\(\\) with 'DockerUtil' and#"
+      identifier: function.impossibleType
     # Global variables from platform/defines.php
     - message: "#Variable \\$\\w+ might not be defined#"
       identifier: variable.undefined

diff --git a/phpunit.xml b/phpunit.xml
@@ -18,7 +18,6 @@
     </source>
     <coverage>
         <report>
-            <html outputDirectory="tests/coverage/html"/>
             <clover outputFile="tests/coverage/clover.xml"/>
             <text outputFile="tests/coverage/coverage.txt"/>
         </report>