All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

• Fixed - slic composer-cache set and unset save their settings without starting a stopped stack. When confirmed, only running PHP services are recreated to apply the cache mount, leaving stopped services and dependencies alone. CI can configure the cache before selecting a project's PHP version without starting containers prematurely.

• Breaking Change - Playwright suites that launch browsers directly must use built-in fixtures or explicitly connect to the remote browser. Browser-facing localhost URLs and download.path() calls may also need changes. See the migration guidance before upgrading.

• Added - Internal process helpers in src/process-argv.php for executing commands as arrays of literal, unquoted arguments. Use process_argv() to capture stdout and receive a status/stdout result array, or process_argv_realtime() to stream output and receive an exit status. These helpers preserve argument boundaries without shell expansion and support interruptible child-process execution.

• Added - Internal Compose helpers in src/docker-argv.php: docker_compose_argv() and docker_compose_argv_realtime() accept command arguments followed by optional Compose options, applying Slic's environment and terminal settings. Use these helpers for new commands built from raw arguments, and slic_stack_argv() for stack file options. Pass values without shell quoting or escaping; existing helpers retain their current calling conventions.

• Changed - slic playwright test keeps tests and PHP hooks in the slic container and connects browser fixtures to a temporary server in the Microsoft Playwright image. The image follows the installed CLI version, so dependency ranges are supported. Each invocation owns and cleans up its browser container.

• Changed - slic playwright install, including install chromium --with-deps, no longer installs browsers or system packages. See the Playwright guide for usage examples and help adapting existing suites.

• Fixed - Playwright browser readiness checks, logs, and cleanup preserve the configured Docker executable and context when using a Docker Compose command prefix.

• Fixed - Slic and WordPress image publishing workflows try Amazon ECR Public first and fall back to authenticated Docker Hub pulls when the mirror fails, including when ECR download limits are exceeded.

• Fixed - The PHP 7.3, 7.4 and 8.0 images install system packages from the Debian archive, so they can be built and slic playwright install works again now that Debian 11 has left LTS.

• Fixed - The object-cache drop-in filter now uses a serializable callback so PHPUnit suites can back up global state.

• Added - First-class support for site-mode projects that use content/ instead of wp-content/, including plugin and theme container paths.
• Changed - slic here now mounts the complete project root for every WordPress site, including projects that install core into wp/.
• Changed - slic here now disables subdirectory builds for sites and enables them for plugin and theme directories.
• Fixed - Site mode no longer creates an unused wp-content/ directory when the project uses a custom content directory.
• Fixed - Plugin and theme targets in projects that install WordPress in wp/ continue to use Slic's isolated WordPress installation.
• Fixed - Switching between site and isolated component targets recreates only the running PHP containers so changed mounts take effect without resetting the test database.
• Fixed - Site theme discovery remains stable while plugin and theme targets use their required theme mounts.
• Fixed - Target-local mount overrides remain authoritative when Slic selects a site layout.
• Changed - Multi-target commands reject mixed site, plugin, and theme targets when their WordPress mounts are incompatible.
• Changed - Multi-target commands reject targets with different target-local bind-mount settings.
• Fixed - Target-local Composer cache and Slic scripts bind mounts now recreate running PHP containers and persist their runtime state.
• Fixed - Target switching now stops without persisting new mount state when Docker cannot determine which services are running.
• Fixed - Test containers now disable the object-cache drop-in without modifying the project file.
• Fixed - Airplane mode now uses and creates the configured must-use plugin directory.

• Added - PCOV support to the slic and WordPress containers to make code coverage generation faster than Xdebug-backed coverage.
• Added - The slic pcov on|off|status command to configure PCOV and apply it to running containers and checks if xdebug is running and asks the user if they want to disable it.
• Updated - The slic xdebug on command now checks if PCOV is enabled and asks the user if they want to disable it.
• Added - pcovon and pcovoff helpers inside slic shell.
• Changed - WordPress containers now apply configured PCOV state through the apache2-foreground command path while preserving the upstream WordPress image entrypoint.
• Updated - GitHub actions versions.

• Added - First-class theme support for slic here, slic use, slic using, and slic run, including auto-detection when running slic here from a themes directory with a sibling plugins directory.
• Added - Agent Skills documentation in skills/slic/ for AI-assisted WordPress integration test creation, debugging, and slic workflow guidance.
• Added - PHP 8.4 and 8.5 Docker image support for slic and WordPress 7.0, compiling uopz from source for PHP 8.4+ because the PECL release does not build against PHP 8.4.
• Changed - PHP 8.3 WordPress images now use WordPress 7.0.0.
• Changed - Docker builds now resolve upstream official PHP and WordPress base images from Amazon ECR Public by default to avoid Docker Hub pull rate limits.
• Fixed - Theme targets now resolve to SLIC_THEMES_DIR when running tests and build/install prompts instead of assuming all targets live in SLIC_PLUGINS_DIR.
• Fixed - slic run now repairs stale or incomplete WordPress .htaccess rewrite blocks in the configured SLIC_WP_DIR, preventing Apache-level 404s for pretty REST API URLs.

• Fixed - Add missing igbinary and redis PHP extensions to the slic and WordPress Dockerfiles.

• Fixed - Preserve staged PHP versions (from slic php-version set X.Y --skip-rebuild) when a project's .env.slic.local file would otherwise override them. Staged versions now correctly take precedence over project-specific PHP version overrides.

• Added - Prevent running slic if the uopz extension is enabled with uopz.exit=0.

• Fixed - Handling of the project in the use command to guarantee that project specific override files will apply to all operations performed during the handling of the use command, including possible spin up of the stack.
• Fixed - Correctly handle the SLIC_WP_AUTO_UPDATE_CORE, allow "undefining" this env var with SLIC_WP_AUTO_UPDATE_CORE=
• Fixed - Correctly handle the SLIC_AUTOMATIC_UPDATER_DISABLED, allow "undefining" this env var with SLIC_AUTOMATIC_UPDATER_DISABLED=
• Fixed - Correctly handle the SLIC_WP_HTTP_BLOCK_EXTERNAL, allow "undefining" this env var with SLIC_WP_HTTP_BLOCK_EXTERNAL=
• Changed - update-dump command now validates dump file existence before processing, provides clearer progress messages, and properly restores the original WordPress version after testing with a specific version.
• Fixed - read_env_file() no longer reads commented out env vars, e.g. # SOME_VAR=test would previously be set.

• Fixed - Use mysqlshow to check db service health when using MySQL 5.5.

• Change - Update MariadDB version from version 10.7.8 to version 11.8.3.
• Fixed - Error "Failed to get current SQL modes. Reason: ERROR 2026 (HY000)" due to lower MariaDB image.

• Change - GitHub Actions workflows now use native ARM64 runners (ubuntu-24.04-arm) instead of QEMU emulation for multi-platform builds, to reduce build times.
• Change - Optimized Dockerfile layer ordering to improve cache hit rates - local config files moved to end to prevent invalidating heavy system installation layers.
• Change - Added BuildKit cache mounts for apt package installation and PHP extension compilation, to reduce subsequent build times.
• Change - Added IPE_CACHE_DIR environment variable to cache PHP extension downloads and compiled artifacts across builds.
• Change - Implemented platform-specific registry caching (separate caches for amd64/arm64) to prevent cache conflicts and maximize reuse.

• Change - Optimize docker builds and workflows for slic and WordPress containers.

• Fixed - backup_env_var() not actually populating backup_vault() and env_var_backup() will properly read from the values.
• Fixed - PHP version priority order when running slic use <project> now properly respects overrides in the following order:
  • CLI environment variable (e.g., SLIC_PHP_VERSION=8.3 slic use)
  • Staged version (from slic php-version set --skip-rebuild)
  • Project's .env.slic.local file
  • Auto-detected from project's slic.json or composer.json.
• Change - slic php-version set X.Y --skip-rebuild now stages the PHP version for the next slic use command without rebuilding containers, useful for CI environments to avoid pulling Docker images multiple times.
• Change - slic php-version now shows if the runtime version differs from the configured version.
• Change - slic info now displays values from .env.slic.run and warns when they're being overridden by other configuration files (like a project's .env.slic.local), making it easier to identify configuration conflicts.
• Change - Added console messages to slic use to clearly indicate which PHP version is being used and why.
• Added - PHP version management documentation.

• Breaking Change - On PHP 7.4 MySQL version to 5.5.62 to align with WordPress minimum requirements. The version of MySQL can be overridden using a version of PHP that is not 7.4, by setting the SLIC_DB_IMAGE environment variable explicitly or by setting the SLIC_DB_NO_MIN environment variable to a non falsy value.
• Fixed - Normalize the PHP version read from the project slic.json or composer.json files to make sure no useless PHP version changes will be triggered.

• Fixed - Restored the selenium/standaolone-chrome image to version 3.141.59 from 4.27.0-20241225 to ensure compatibility with older PHP driver versions.

• Fixed - Better detection of ARM64 architecture in is_arm64 function.

• Added - Allow for projects to declare their desired PHP version for slic via slic.json (phpVersion) or composer.json (config.platform.php).
• Added - Support for auto-setup of appropriate PHP containers when running slic use.

• Updated the ARM64 Chrome container image to version 4.20.0-20240427 from 4.1.2-20220227.
• Updated the x86 Chrome container image to version 4.27.0-20241225 from 3.141.59.

• Updated the node version to 18.17.0, this affects the npm command and any other command using the npm container.

• Fixed - Set the opcache.revalidate_freq to 0 in the slic and wordpress containers to avoid issues with cached files in tests.

• Fixed - Run the playwright install command as root, allow running Playwright tests as the slic user.
• Change - The playwright install command will now install only the Chromium browser and its dependencies.

• Fixed - Properly read changes and restart stack after using the slic php-version set command.
• Added - PHP 8.3 docker images.
• Change - Update GitHub action versions to remove node notices.
• Change - Build slic images from the latest PHP patch versions.

• Added - The playwright command to Playwright commands in the stack.
• Added - The less binary to the slic container (to correctly format wp-cli output).
• Added - The p alias to the slic container to allow running Playwright commands with p <command>, similar to c <command> to run Codeception commands.

• Added - The slic command now loads the .env.slic.local file from the target directory if it exists. (thanks @cliffordp)
• Added - The chrome container shm size is now set to 256m by default, and is controllable via the SLIC_CHROME_CONTAINER_SHM_SIZE env var. (thanks @maurisrx)

• Change - the airplane-mode command now installs the plugin in the must-use plugins directory instead of the plugins directory.
• Fixed - .bat file now uses the correct path to the slic executable on Windows.

• Added - The slic update-dump command to update a dump file for the current project, with an optional WordPress version update, e.g. slic update-dump tests/_data/dump.sql latest.

• Change - Disable WordPress's automatic updating in slic containers via docker compose WORDPRESS_CONFIG_EXTRA defines. See comments in .env.slic to customize this behavior.

• Change - Build linux/arm64 images for the slic and wordpress containers to avoid issues when running slic on ARM machines.

• Change - Remove version property from docker compose .yml files as it's obsolete since v2.25. docker/compose#11628

• Change - Update the npm version to 18.13.0
• Change - Update the nvm version to v0.39.7
• Fixed - Ensure nvm cache directory is world-accessible to allow use of nvm install

• Change - Allow controlling the value of the WP_HTTP_BLOCK_EXTERNAL constant using the SLIC_WP_HTTP_BLOCK_EXTERNAL environment variable defined in the .env.slic.run configuration file; set to true by default to block all outgoing HTTP requests from WordPress.
• Change - Allow controlling the value of the DISABLE_WP_CRON constant using the SLIC_DISABLE_WP_CRON environment variable defined in the .env.slic.run configuration file; set to true by default to disable the WordPress cron system.

• Fix - Added extra_hosts:"${host:-host}:host-gateway" to slick-stack.yml for Linux compatibility, enabling Xdebug without modifying the XDH environment variable. Ref.

• Change - Update base WordPress container from 6.1 to 6.2.
• Change - Add WP CLI to the wordpress container as wp.

• Change - Configure slic and wordpress containers consistently with php.ini configuration file.
• Change - Set xdebug.log_level=0 in slic and wordpress containers to avoid nags in separate process running.

• Change - Enable xdebug coverage mode in all PHP based docker containers when xdebug is enabled via: xdebug.mode=develop,debug,coverage.

• Change - Tag again to update WordPress version to 6.1 (the last WP version with a PHP 7.4 image).

• Change - Update WordPress version to 6.1 (the last WP version with a PHP 7.4 image).

• Fix - broken CRLF line breaks via slic real-time commands due to docker compose v2.2.x being used Docker compose issue.

• Updates slic-stack.site.yml for full site testing.
• Adds check for site target to reference slic_wp_dir() when running commands.

• Change - Default to Composer version 2.

• Change - Leverage Docker Compose syntax to manage network aliases and service dependencies. Clean up a remove code.
• Add the dc command to run Docker Compose commands in the stack.
• Support the SLIC_DOCKER_COMPOSE_BIN environment variable to allow for the use a different Docker Compose binary, the docker compose one is used by default.

• Fix - issue 142 ensure the hosts file in the docker container contains a tab character before trying to explode it.

• Added - Pass through the COMPOSER_AUTH environment variable to the slic docker container to allow composer installs for private or otherwise protected dependencies. Especially useful when running in GitHub Actions.
• Added - The PHP exif extension to the slic container to allow slic composer install commands to succeed when this extension is required.

• Change - No longer build gd in the slick docker container with AVIF, fixing external dependency on the currently down code.videolan.org, and speeding up builds - more info.
• Change - use tmpfs for the db and redis services data directories to improve performance on Linux machines.

• Changed - Add docker build caching using the GitHub Cache Backend when publishing docker images via GitHub actions.

• Change - Display composer version in slic info.
• Added - The --skip-rebuild option to the slic php-version set command to allow setting the PHP version without rebuilding the stack in order to speed up CI runs. Example: slic php-version set 8.1 --skip-rebuild
• Fix - slic php-version help will now properly show command help text.
• Fix - slic php-version will now properly use the default PHP version if the SLIC_PHP_VERSION env var is not set.

• Change - The WordPress PHP7.3 image is only available in for WordPress 5.9.x.
• Change - Convert docker image builds into single matrix GitHub workflows.
• Added - Add a PHP 8.2 slic/WordPress docker image build. PHP8.2 is using WordPress version 6.1.1.
• Change - Use docker build arguments when publishing docker containers.
• Change - Bump action docker/build-push-action@v3.1.1 to docker/build-push-action@v3.3.1
• Change - Bump action docker/metadata-action@v4.0.1 to docker/metadata-action@v4.3.0
• Change - Bump nvm version from v0.39.1 to v0.39.3 in slic docker image.

• Fix - Modernize variable syntax to avoid PHP 8.2 deprecation notices.

• Fix - Enable and disable XDebug correctly in WorPress and slic container removing restart requirement.
• Fix - Avoid issues with missing /usr/sbin/sendmail during WordPress installation. [#134]

• Fix - Simplify the restart_all_services() code so that containers are all shut down and then all started.

• Fix - Add the intl PHP module to the container.

• Fix - Ensure actions that need to execute after containers start actually wait until those containers start.

• Feature - Added the slic exec command that allows bash command execution within the stack. [#31]
• Fix - Set the Composer cache directory default location correctly. [#78]
• Tweak - Add SLIC_PHP_VERSION to slic info.
• Tweak - Make the Valid Targets: output a bit less readable during slic info in favor of keeping the env values visible.

• Feature - Prompt the user to stop containers before updating.
• Feature - Add the slic php-version command and allow for switching between PHP versioned containers.
• Fix - Allow wordpress.test to be resolvable during test execution by placing it in the /etc/hosts file of the slic and chrome containers.
• Fix - PHP 8.0+ compatibility fix for WordPress zip downloads.
• Fix - Prevent looping over the same test suite when executing slic run. [#118]
• Fix - Better handling of checking for services that are up.

• Switch the slic-stack.yml to use the new Docker images for slic and slic-wordpress.

• Generate Docker images for slic and wordpress containers.

• Fixes for the run command when executed while the containers are not already running.
• Scaffold in a /cache directory to store test-related information.
• PHP 8 deprecation warning fix.

• Ensure that the right flags are passed during docker-compose command execution when in non-interactive mode.

• Big overhaul of documentation within the tool.
• Now saving the state of XDebug when running slic shell multiple times.
• Added XDebug 3 compatible php.ini settings.

• Rebranded tric to slic.
• Consolidated many of the containers into a single slic container to simplify the stack and reduce the time to start up and shut down containers.
• Containers are no longer brought down upon completion of a command.
• Removed the serve command. Since containers remain up, the up command can be used to start the stack and make the local site available.
• Reworked how slic handles npm. It now uses nvm under the hood and automatically installs the version of node that is dictated by .nvmrc.
• Removed the npm_lts command. It is no longer needed after the reworking of the npm command.

• Add the ps command to list the current containers information.
• Fix mariadb image to 10.7.3.

• Update the Composer container to use PHP 7.4.

• Set xdebug.log_level=0 in the stack configuration to avoid XDebug warnings from breaking code.

• Add the mysql command to quickly open a mysql shell in the running database container of the tric stack.
• Add the wp command as alias of the cli command.

• Set the version of the lucatume/codeception container to cc3.1.0-v1.1.1.

• Version bump to pull the latest version of the fixed codeception container.

• Use the seleniarm/standalone-chromium container for the chrome service on ARM architecture machines.
• Add the pcntl extension to the codeception container.

• Add support for a Mailcatcher container (thanks @sc0ttkclark).

• Updated the node version to 10.16.0, this affects the npm command and any other command using the npm container.
• Added the host-ip command to get the host machine IP address containers will be able to use to connect to the host (e.g. when setting up XDebug on Linux).

• Fixed an issue where the path to the WP directory would not build correctly on Windows systems.

• Allow opening a shell in the cli service to run wp-cli commands just using tric cli.

• Set COMPOSER_HTACCESS_PROTECT=0 explicitly in the docker-compose configuration file to avoid an .htaccess file being created in the root directory of the current target.

• Update the WordPress image version, in the tric-stack.build.yml file, from 5.5 to 5.6 to fix CI build issues.

• Add an argument, to the reset command, to remove the default WordPress (/_wordpress) installation directory using tric reset wp.

• Added the composer-cache command so the host machine's composer cache can be leveraged within tric containers.

• Updated default WordPress image to 5.6-apache.

• Updated default repo org to the-events-calendar.

• Fix an issue where commands that required a ready and available WordPress installation in the tric WordPress directory would not take care to scaffold and install it; e.g. cli or site-cli.

• Fix an issue where the USING_CONTAINERS environment variable would be duplicated in environment files set up by tric init command.
• Fix an issue where a negative answer to build targets with sub-directories, e.g. TEC and ET, would result in the target being built anyway.

• Fix the XDebug version and wordpress service Dockerfile to keep using version 2 and not update to version 3 on a rebuild (e.g. one triggered by tric update or tric build-stack commands).
• Add the tric ssh command to allow opening a shell in a running stack service; differently from the shell command, the ssh command will not start the service if it's not already running.

• Add support for the TRIC_HOST environment variable. This will override the default host machine IP address lookup tric would perform on Linux or the hard-wired host.docker.internal hostname tric would use on Windows and Mac host to set the default xdebug.remote_host value.
• Default to the host machin IP address to set xdebug.remote_host only if the host has not been set by means of a call to tric xdebug host <host> or by setting the XDH environment variable explicitly.
• Fix an issue that would reset run settings stored in the .env.tric.run file when using the tric xdebug <key> <value> command.
• Correctly handle Docker network removal in parallel tasks to avoid "error while removing network" errors.
• Add support for tric run to run all the available Codeception test suites from the target one after another.

• Removed the 3s wait at start of the codeception service.
• Fixed (in the context of the lucatume/dockerfiles repository) an issue that would cause Codeception tests to exit 0 on failure and not 1 as expected.

• Fixed volumes setup to make sure the volume, and the host file structure, created by WordPress container is owned by the current user and not root.
• Fixed and issue that would change, on Linux, the file modes of all the used plugins, to a+rwx when using the run command; fixes #36

• Executing tric use without a target now attempts to set the current working directory as the target.
• tric info now outputs all valid targets, which is what tric use without a valid target used to do.
• The Composer prompt from tric init no longer appears if composer.json is not found, likewise for the NPM prompt if package.json is not found.
• Fixed an issue that would prevent the npm and npm_lts services from correctly returning their exit status.
• Add support for the --pretty flag to the npm and npm_lts commands to print a more human-readable output.

• Fixed two issues in the target command where the command would fail if no previous target had been set.
• Set the start of the random network subnet pool for parallel processes used by the target command to a higher number to reduce the chance of running into overlapping pool issues.

• Activate all debug options in the wordpress service.
• Use a custom WordPress image for the stack, based on the default wordpress one, but modified to support and use XDebug.

• Fixed a smaller issue in the target command.

• Add the site-cli command to start a wp-cli container on a running and ready WordPress stack.

• Add a check to ensure a target is set for commands that require it.

• Add the npm_lts service and service to the stack to run npm commands on the current LTS version of node.

• Fixed an issue where the terminal columns and lines detection would cause issue in CI context.
• Fixed an issue where the npm image would not build correctly in CI context.

• Add support for the bash sub-command to the tric cli command to allow opening a bash shell into the cli container to manage the WordPress installation currently being served by tric serve.

• Add support for multiple commands in the target command to allow running a set of commands on a set of targets.

• Update the WordPress version used in the stack to 5.5.
• Fix handling of default answers in prompts.

• Fix an issue where docker-compose would display an error due to missing default value for the TRIC_CURRENT_PROJECT_SUBDIR env var.

• Fix an issue where the function-mocker-cache volume would be mounted with root ownership on Linux systems causing Function Mocker to fail while trying to set up cache in plugins that use it.

• Added the tric target command to support running the same command against multiple targets.

• Fix an issue where the tric init command would not correctly pick up the existing environment files if not running from the plugin directory.
• Added the TRIC_INTERACTIVE, TRIC_BUILD_PROMPT and TRIC_BUILD_SUBDIR env var to the tric info report.

• Added tric build-subdir which allows you to control whether sub-directories (e.g. common in The Events Calendar) should be built during composer/npm commands or not.
• Fix an issue where the build-prompt status was reported incorrectly.

• Fix an issue with file modes on the WordPress container that would make its wp-content directory root owned on Linux hosts.

• Fix parallel processing closure argument requirements.

• Allow for additional git upstreams other than GitHub.

• Fix and re-enable the parallel processing functionality.

• Temporarily disabled the parallel processing functionality.

• When running parallel processes, use random subnets to avoid container collision.

• Add support for DB_ prefixed database credentials and name in the original .env.* files.

• Added tric upgrade which allows you to upgrade tric to the latest tagged release.

• Prompt to tric update when container build version are out of sync from the tric version.
• Output npm error log when one is generated.
• Adjust pathing of subdirectories within the tric stack so that npm can find a .git directory when performing npm install.
• Suppress the fixuid command output in the npm docker-entrypoint.sh.
• Separated out poolable (passive) command functions from realtime command functions to prevent issues with interactivity.

• Added phpcs and phpcbf commands.
• Added parallel processing of commands.
• Changed tric build to tric build-stack.

• Ensure .htaccess file is present in _wordpress.

• Initial version