check-bun:

@command -v bun >/dev/null 2>&1 || { \

echo ""; \

echo "Error: Bun is not installed."; \

echo " Install it from: https://bun.sh/"; \

echo " Quick install: curl -fsSL https://bun.sh/install | bash"; \

echo ""; \

exit 1; \

}

EDITOR_SUBMODULE_PATH := exelearning

EDITOR_OUTPUT_DIR := $(CURDIR)/dist/static

EDITOR_REPO_DEFAULT := https://github.com/exelearning/exelearning.git

EDITOR_REF_DEFAULT := main

fetch-editor-source:

@set -e; \

get_env() { \

if [ -f .env ]; then \

grep -E "^$$1=" .env | tail -n1 | cut -d '=' -f2-; \

fi; \

}; \

REPO_URL="$${EXELEARNING_EDITOR_REPO_URL:-$$(get_env EXELEARNING_EDITOR_REPO_URL)}"; \

REF="$${EXELEARNING_EDITOR_REF:-$$(get_env EXELEARNING_EDITOR_REF)}"; \

REF_TYPE="$${EXELEARNING_EDITOR_REF_TYPE:-$$(get_env EXELEARNING_EDITOR_REF_TYPE)}"; \

if [ -z "$$REPO_URL" ]; then REPO_URL="$(EDITOR_REPO_DEFAULT)"; fi; \

if [ -z "$$REF" ]; then REF="$${EXELEARNING_EDITOR_DEFAULT_BRANCH:-$$(get_env EXELEARNING_EDITOR_DEFAULT_BRANCH)}"; fi; \

if [ -z "$$REF" ]; then REF="$(EDITOR_REF_DEFAULT)"; fi; \

if [ -z "$$REF_TYPE" ]; then REF_TYPE="auto"; fi; \

echo "Fetching editor source from $$REPO_URL (ref=$$REF, type=$$REF_TYPE)"; \

if [ -d "$(EDITOR_SUBMODULE_PATH)/.git" ]; then \

echo "Updating existing editor source..."; \

git -C $(EDITOR_SUBMODULE_PATH) remote set-url origin "$$REPO_URL"; \

else \

rm -rf $(EDITOR_SUBMODULE_PATH); \

git init -q $(EDITOR_SUBMODULE_PATH); \

git -C $(EDITOR_SUBMODULE_PATH) remote add origin "$$REPO_URL"; \

fi; \

OLD_HEAD=$$(git -C $(EDITOR_SUBMODULE_PATH) rev-parse HEAD 2>/dev/null || echo "none"); \

git -C $(EDITOR_SUBMODULE_PATH) checkout -q -- bun.lock 2>/dev/null || true; \

case "$$REF_TYPE" in \

tag) \

git -C $(EDITOR_SUBMODULE_PATH) fetch --depth 1 origin "refs/tags/$$REF:refs/tags/$$REF"; \

git -C $(EDITOR_SUBMODULE_PATH) checkout -q "tags/$$REF"; \

;; \

branch) \

git -C $(EDITOR_SUBMODULE_PATH) fetch --depth 1 origin "$$REF"; \

git -C $(EDITOR_SUBMODULE_PATH) checkout -q FETCH_HEAD; \

;; \

auto) \

if git -C $(EDITOR_SUBMODULE_PATH) fetch --depth 1 origin "refs/tags/$$REF:refs/tags/$$REF" > /dev/null 2>&1; then \

echo "Resolved $$REF as tag"; \

git -C $(EDITOR_SUBMODULE_PATH) checkout -q "tags/$$REF"; \

else \

echo "Resolved $$REF as branch"; \

git -C $(EDITOR_SUBMODULE_PATH) fetch --depth 1 origin "$$REF"; \

git -C $(EDITOR_SUBMODULE_PATH) checkout -q FETCH_HEAD; \

fi; \

;; \

*) \

echo "Error: EXELEARNING_EDITOR_REF_TYPE must be one of: auto, branch, tag"; \

exit 1; \

;; \

esac; \

NEW_HEAD=$$(git -C $(EDITOR_SUBMODULE_PATH) rev-parse HEAD); \

if [ "$$OLD_HEAD" = "$$NEW_HEAD" ]; then \

echo "Editor source is already up to date ($$NEW_HEAD)."; \

else \

echo "Editor source updated: $$OLD_HEAD -> $$NEW_HEAD"; \

fi

build-editor: check-bun fetch-editor-source

@echo "Building eXeLearning static editor..."

rm -rf $(EDITOR_OUTPUT_DIR)

@# Resolve the version to embed in the editor build. The editor's build script

@# (scripts/build-static-bundle.ts) reads APP_VERSION/VERSION; without it the

@# build falls back to package.json (0.0.0-alpha). Resolution order:

@# APP_VERSION -> VERSION -> EXELEARNING_EDITOR_REF (env or .env) ->

@# exact git tag of the checked-out editor -> empty (dev default -> alpha)

@set -e; \

get_env() { \

if [ -f .env ]; then \

grep -E "^$$1=" .env | tail -n1 | cut -d '=' -f2-; \

fi; \

}; \

APP_VER="$${APP_VERSION:-$${VERSION:-$${EXELEARNING_EDITOR_REF:-$$(get_env EXELEARNING_EDITOR_REF)}}}"; \

if [ -z "$$APP_VER" ] || [ "$$APP_VER" = "main" ] || [ "$$APP_VER" = "master" ]; then \

EXACT_TAG="$$(git -C $(EDITOR_SUBMODULE_PATH) describe --tags --exact-match 2>/dev/null || true)"; \

if [ -n "$$EXACT_TAG" ]; then APP_VER="$$EXACT_TAG"; fi; \

fi; \

echo "Editor version input: $${APP_VER:-(default -> alpha)}"; \

cd $(EDITOR_SUBMODULE_PATH) && bun install && OUTPUT_DIR=$(EDITOR_OUTPUT_DIR) APP_VERSION="$$APP_VER" bun run build:static

@# If the build script ignored OUTPUT_DIR, copy from fetched source output.

@if [ ! -f "$(EDITOR_OUTPUT_DIR)/index.html" ] && [ -f "$(EDITOR_SUBMODULE_PATH)/dist/static/index.html" ]; then \

echo "Copying build output to dist/static/..."; \

mkdir -p $(EDITOR_OUTPUT_DIR); \

cp -R $(EDITOR_SUBMODULE_PATH)/dist/static/* $(EDITOR_OUTPUT_DIR)/; \

fi

@# Save the commit hash used for this build

@git -C $(EDITOR_SUBMODULE_PATH) rev-parse HEAD > $(EDITOR_OUTPUT_DIR)/.build-commit 2>/dev/null || true

@echo ""

@echo "============================================"

@echo " Static editor built at dist/static/"

@echo "============================================"

build-editor-if-needed:

@if ! $(MAKE) --no-print-directory fetch-editor-source; then \

if [ -f "$(EDITOR_OUTPUT_DIR)/index.html" ]; then \

echo "Warning: could not update the editor source; keeping the existing build."; \

exit 0; \

fi; \

exit 1; \

fi; \

BUILD_COMMIT=""; \

if [ -f "$(EDITOR_OUTPUT_DIR)/.build-commit" ]; then \

BUILD_COMMIT=$$(cat "$(EDITOR_OUTPUT_DIR)/.build-commit"); \

fi; \

CURRENT_COMMIT=$$(git -C $(EDITOR_SUBMODULE_PATH) rev-parse HEAD 2>/dev/null || echo "unknown"); \

if [ -f "$(EDITOR_OUTPUT_DIR)/index.html" ] && [ "$$BUILD_COMMIT" = "$$CURRENT_COMMIT" ]; then \

echo "Static editor is up to date ($$CURRENT_COMMIT), skipping build."; \

else \

$(MAKE) build-editor; \

fi

build-editor-no-update: build-editor

clean-editor:

rm -rf dist/static

rm -rf $(EDITOR_SUBMODULE_PATH)/dist/static

rm -rf $(EDITOR_SUBMODULE_PATH)/node_modules

ifeq ($(shell uname), Darwin)

SED_INPLACE = sed -i ''

SED_INPLACE = sed -i

check-docker:

@docker version > /dev/null || (echo "" && echo "Error: Docker is not running. Please ensure Docker is installed and running." && echo "" && exit 1)

install-requirements:

npm -g i @wordpress/env

start-if-not-running:

@if [ "$$(curl -s -o /dev/null -w '%{http_code}' http://127.0.0.1:8889)" = "000" ]; then \

echo "wp-env is NOT running. Starting (previous updating) containers..."; \

npx wp-env start --update; \

npx wp-env run cli wp plugin activate exelearning; \

echo "Visit http://localhost:8888/wp-admin/ to access the eXeLearning dashboard."; \

else \

echo "wp-env is already running, skipping start."; \

fi

up: check-docker build-editor-if-needed start-if-not-running

up-playground: build-editor-if-needed

@if [ "$$(curl -s -o /dev/null -w '%{http_code}' http://127.0.0.1:8888)" = "000" ]; then \

echo "Starting wp-env with Playground runtime..."; \

npx wp-env start --runtime=playground --update; \

echo "Visit http://localhost:8888/wp-admin/ to access the eXeLearning dashboard (admin/password)."; \

else \

echo "wp-env is already running, skipping start."; \

fi

reset:

@npx wp-env reset development 2>/dev/null || { \

echo ""; \

echo "wp-env reset failed (Playground runtime does not support reset)."; \

echo "Run 'make destroy' followed by 'make up' or 'make up-playground' to start fresh."; \

}

flush-permalinks:

npx wp-env run cli wp rewrite structure '/%postname%/'

create-user:

@if [ -z "$(USER)" ] || [ -z "$(EMAIL)" ] || [ -z "$(ROLE)" ]; then \

echo "Error: Please, specify USER, EMAIL, ROLE and PASSWORD. Usage: make create-user USER=test1 EMAIL=test1@example.org ROLE=editor PASSWORD=password"; \

exit 1; \

fi

npx wp-env run cli sh -c 'wp user list --field=user_login | grep -q "^$(USER)$$" || wp user create $(USER) $(EMAIL) --role=$(ROLE) --user_pass=$(PASSWORD)'

down: check-docker

npx wp-env stop

down-playground:

npx wp-env stop

clean:

@npx wp-env reset development 2>/dev/null && \

npx wp-env run cli wp plugin activate exelearning && \

npx wp-env run cli wp language core install es_ES --activate && \

npx wp-env run cli wp site switch-language es_ES || { \

echo ""; \

echo "wp-env reset failed (Playground runtime does not support reset)."; \

echo "Use 'make destroy' followed by 'make up-playground' to start fresh."; \

}

destroy:

npx wp-env destroy

check-plugin-old: check-docker start-if-not-running

npx wp-env run cli wp plugin install plugin-check --activate --color

npx wp-env run cli wp plugin check exelearning --exclude-directories=tests,.claude,.agents --exclude-checks=file_type,image_functions --ignore-warnings --color

check-plugin: check-docker start-if-not-running

# Install plugin-check if needed (don't fail if already active)

@npx wp-env run cli wp plugin install plugin-check --activate --color || true

# `wp plugin check` exits 0 even when it reports errors, so the exit code

# decides nothing: the output is what has to be read. Verified by injecting

# a forbidden call, which the checker reported as an ERROR while still

# exiting 0.

#

# The exclusion list used to name `exelearning`, the editor submodule. The

# plugin is installed under that same name, so the rule matched the plugin's

# own root and the checker scanned nothing at all — it reported only "the

# plugin readme.txt does not exist". Same trap `.phpcs.xml.dist` documents

# for PHPCS. Neither the submodule nor dist/ holds a single PHP file, so

# excluding them was never needed; tests/ and bin/ are the only ones that do,

# and bin/ is developer tooling that is not shipped.

@echo "Running WordPress Plugin Check..."

@TMPFILE=$$(mktemp); \

npx wp-env run cli wp plugin check exelearning \

--exclude-directories=tests,bin,.claude,.agents \

--exclude-checks=file_type,image_functions \

--ignore-warnings \

--color 2>&1 | tee $$TMPFILE; \

ERRORS=$$(sed 's/\x1B\[[0-9;]*[mK]//g' $$TMPFILE | grep -cE '\bERROR\b' || true); \

rm -f $$TMPFILE; \

echo ""; \

if [ "$$ERRORS" -gt 0 ]; then \

echo "Plugin Check: ✗ $$ERRORS error(s) found."; \

exit 1; \

fi; \

echo "Plugin Check: ✓ No errors found."

check: fix lint architecture-check check-plugin test check-untranslated mo

check-all: check

tests: test

test: start-if-not-running

@CMD="./vendor/bin/phpunit"; \

if [ -n "$(FILE)" ]; then CMD="$$CMD $(FILE)"; fi; \

if [ -n "$(FILTER)" ]; then CMD="$$CMD --filter $(FILTER)"; fi; \

npx wp-env run tests-cli --env-cwd=wp-content/plugins/exelearning $$CMD --testdox --colors=always

test-verbose: start-if-not-running

@CMD="./vendor/bin/phpunit"; \

if [ -n "$(TEST)" ]; then CMD="$$CMD --filter $(TEST)"; fi; \

CMD="$$CMD --debug --verbose"; \

npx wp-env run tests-cli --env-cwd=wp-content/plugins/exelearning $$CMD --colors=always

MIN_COVERAGE ?= 94

test-coverage: start-if-not-running

@mkdir -p artifacts/coverage

@CMD="env XDEBUG_MODE=coverage ./vendor/bin/phpunit --testdox --colors=always --coverage-text=artifacts/coverage/coverage.txt --coverage-html artifacts/coverage/html --coverage-clover artifacts/coverage/clover.xml"; \

if [ -n "$(FILE)" ]; then CMD="$$CMD $(FILE)"; fi; \

if [ -n "$(FILTER)" ]; then CMD="$$CMD --filter $(FILTER)"; fi; \

npx wp-env run tests-cli --env-cwd=wp-content/plugins/exelearning $$CMD; \

EXIT_CODE=$$?; \

echo ""; \

echo "════════════════════════════════════════════════════════════"; \

echo " COVERAGE SUMMARY "; \

echo "════════════════════════════════════════════════════════════"; \

grep -E "^\s*(Summary|Classes|Methods|Lines):" artifacts/coverage/coverage.txt 2>/dev/null | head -4 || echo "Coverage data not available"; \

echo ""; \

echo "Per-class coverage:"; \

echo "────────────────────────────────────────────────────────────"; \

awk '/^[A-Z]/ { class=$$1 } /Methods:.*Lines:/ { \

lines_pct = $$0; \

gsub(/.*Lines:[[:space:]]*/, "", lines_pct); \

gsub(/%.*/, "", lines_pct); \

if (lines_pct+0 >= 90) color="\033[32m"; \

else if (lines_pct+0 >= 50) color="\033[33m"; \

else color="\033[31m"; \

printf " %s%-40s\033[0m %s\n", color, class, $$0 \

}' artifacts/coverage/coverage.txt 2>/dev/null; \

echo "────────────────────────────────────────────────────────────"; \

echo " \033[32m●\033[0m ≥90% \033[33m●\033[0m ≥50% \033[31m●\033[0m <50%"; \

echo "════════════════════════════════════════════════════════════"; \

echo "Full report: artifacts/coverage/html/index.html"; \

echo ""; \

if [ $$EXIT_CODE -ne 0 ]; then exit $$EXIT_CODE; fi; \

COVERAGE=$$(grep -E "^\s*Lines:" artifacts/coverage/coverage.txt 2>/dev/null | grep -oE "[0-9]+\.[0-9]+" | head -1); \

if [ -z "$$COVERAGE" ]; then \

echo "Error: Could not extract coverage percentage"; \

exit 1; \

fi; \

COVERAGE_INT=$$(echo "$$COVERAGE" | cut -d. -f1); \

echo ""; \

if [ "$$COVERAGE_INT" -lt "$(MIN_COVERAGE)" ]; then \

echo "════════════════════════════════════════════════════════════"; \

echo " ❌ COVERAGE CHECK FAILED"; \

echo " Current: $$COVERAGE% | Required: $(MIN_COVERAGE)%"; \

echo "════════════════════════════════════════════════════════════"; \

exit 1; \

else \

echo "════════════════════════════════════════════════════════════"; \

echo " ✅ COVERAGE CHECK PASSED"; \

echo " Current: $$COVERAGE% | Required: $(MIN_COVERAGE)%"; \

echo "════════════════════════════════════════════════════════════"; \

fi

setup-tests-env:

@echo "Setting up tests environment..."

@npx wp-env run tests-cli wp core install \

--url=http://localhost:8889 \

--title="eXeLearning Tests" \

--admin_user=admin \

--admin_password=password \

--admin_email=admin@example.com \

--skip-email 2>/dev/null || true

@npx wp-env run cli wp language core install es_ES --activate

@npx wp-env run cli wp site switch-language es_ES

@npx wp-env run tests-cli wp plugin activate exelearning 2>/dev/null || true

@npx wp-env run tests-cli wp rewrite structure '/%postname%/' --hard 2>/dev/null || true

test-e2e: start-if-not-running setup-tests-env

WP_BASE_URL=http://localhost:8889 npm run test:e2e -- $(ARGS)

test-e2e-visual: start-if-not-running setup-tests-env

WP_BASE_URL=http://localhost:8889 npm run test:e2e -- --ui

logs:

npx wp-env logs

logs-test:

npx wp-env logs --environment=tests

install-phpcs: check-docker start-if-not-running

@echo "Checking if PHP_CodeSniffer is installed..."

@if ! npx wp-env run cli bash -c '[ -x "$$HOME/.composer/vendor/bin/phpcs" ]' > /dev/null 2>&1; then \

echo "Installing PHP_CodeSniffer and WordPress Coding Standards..."; \

npx wp-env run cli composer global config --no-plugins allow-plugins.dealerdirect/phpcodesniffer-composer-installer true; \

npx wp-env run cli composer global require squizlabs/php_codesniffer wp-coding-standards/wpcs --no-interaction; \

else \

echo "PHP_CodeSniffer is already installed."; \

fi

lint:

composer phpcs

architecture-check:

composer architecture-check

architecture-records:

@composer architecture-records

fix:

composer phpcbf || true

phpmd:

phpmd . text phpmd.xml --exclude vendor,node_modules,tests,dist

cli-container:

@docker ps --format "{{.Names}}" \

| grep "\-cli\-" \

| grep -v "tests-cli" \

|| ( \

echo "No main CLI container found. Please run 'make up' first." ; \

exit 1 \

)

fix-no-tty: cli-container start-if-not-running

@CONTAINER_CLI=$$( \

docker ps --format "{{.Names}}" \

| grep "\-cli\-" \

| grep -v "tests-cli" \

) && \

echo "Running PHPCBF (no TTY) inside $$CONTAINER_CLI..." && \

docker exec -i $$CONTAINER_CLI \

phpcbf --standard=wp-content/plugins/exelearning/.phpcs.xml.dist wp-content/plugins/exelearning

lint-no-tty: cli-container start-if-not-running

@CONTAINER_CLI=$$( \

docker ps --format "{{.Names}}" \

| grep "\-cli\-" \

| grep -v "tests-cli" \

) && \

echo "Running PHPCS (no TTY) inside $$CONTAINER_CLI..." && \

docker exec -i $$CONTAINER_CLI \

phpcs --standard=wp-content/plugins/exelearning/.phpcs.xml.dist wp-content/plugins/exelearning

update: check-docker

composer update --no-cache --with-all-dependencies

npm update

pot:

composer make-pot

composer pot-remove-ctime

po:

composer po

mo:

composer make-mo

l10n-php:

composer make-php

json:

composer clean-json

composer make-json

translations:

composer make-translations

i18n-audit:

composer i18n-audit

check-translations:

@composer untranslated || { \

echo ""; \

echo "ERROR: Untranslated strings found. Translate them in languages/*.po."; \

exit 1; \

}

composer make-translations

composer make-translations

composer validate-translations

@if ! git diff --quiet -- languages; then \

echo ""; \

echo "ERROR: Committed translation files are out of date."; \

echo "Run 'make translations' and commit the tracked changes under languages/."; \

git --no-pager diff --stat -- languages; \

exit 1; \

fi

@untracked="$$(git ls-files --others --exclude-standard -- languages)"; \

if [ -n "$$untracked" ]; then \

echo ""; \

echo "ERROR: Unexpected untracked translation files detected:"; \

echo "$$untracked"; \

exit 1; \

fi

@echo "Translations are up to date and deterministic."

check-untranslated:

composer check-untranslated

package-translations: mo l10n-php json

composer validate-translations

@set -e; \

found=0; \

for po in languages/exelearning-*.po; do \

if [ ! -e "$$po" ]; then continue; fi; \

found=1; \

locale="$${po#languages/exelearning-}"; \

locale="$${locale%.po}"; \

mo="$${po%.po}.mo"; \

l10n="$${po%.po}.l10n.php"; \

if [ ! -s "$$mo" ]; then \

echo "Error: Missing or empty generated translation file: $$mo" >&2; \

exit 1; \

fi; \

if [ ! -s "$$l10n" ]; then \

echo "Error: Missing or empty generated translation file: $$l10n" >&2; \

exit 1; \

fi; \

json_found=0; \

for json in languages/exelearning-"$$locale"-*.json; do \

if [ ! -e "$$json" ]; then continue; fi; \

json_found=1; \

if [ ! -s "$$json" ]; then \

echo "Error: Empty generated translation file: $$json" >&2; \

exit 1; \

fi; \

done; \

if [ "$$json_found" -eq 0 ]; then \

echo "Error: No generated JSON translation found for locale $$locale" >&2; \

exit 1; \

fi; \

done; \

if [ "$$found" -eq 0 ]; then \

echo "Error: No translation source files found under languages/." >&2; \

exit 1; \

fi

package: package-translations

@if [ -z "$(VERSION)" ]; then \

echo "Error: No version specified. Usage: 'make package VERSION=1.2.3'"; \

exit 1; \

fi

@# The embedded editor is a release artifact (ADR-72-01): never produce a

@# package without a valid bundled editor.

@if [ ! -r dist/static/index.html ]; then \

echo "Error: dist/static/index.html is missing or unreadable. Build the editor with 'make build-editor' before packaging." >&2; \

exit 1; \

fi

@if [ ! -d dist/static/app ] && [ ! -d dist/static/libs ] && [ ! -d dist/static/files ]; then \

echo "Error: dist/static/ is missing the expected editor asset directories (app/, libs/ or files/)." >&2; \

exit 1; \

fi

@if [ ! -f .editor-version ] || [ -z "$$(tr -d '[:space:]' < .editor-version)" ]; then \

echo "Error: .editor-version is missing or empty; it must name the bundled editor version." >&2; \

exit 1; \

fi

# Update the version in exelearning.php & readme.txt

$(SED_INPLACE) "s/^ \* Version:.*/ * Version: $(VERSION)/" exelearning.php

$(SED_INPLACE) "s/define( 'EXELEARNING_VERSION', '[^']*'/define( 'EXELEARNING_VERSION', '$(VERSION)'/" exelearning.php

$(SED_INPLACE) "s/^Stable tag:.*/Stable tag: $(VERSION)/" readme.txt

@# Create the ZIP package with proper folder structure.

@# `wp dist-archive` reads .distignore straight from the working tree, so the

@# generated files that .gitignore keeps out of the repository (dist/static/

@# and the runtime translations) are packaged like any other file.

@# --plugin-dirname is what makes the archive extract as exelearning/ even

@# though the development checkout is named wp-exelearning.

@# `--force` does not empty an existing archive: dist-archive 3.1 shells out

@# to the `zip` binary, which ADDS to one. Without this removal a file that a

@# new .distignore rule excludes would survive from an earlier build.

rm -f "$(CURDIR)/exelearning-$(VERSION).zip"

./vendor/bin/wp dist-archive . "$(CURDIR)/exelearning-$(VERSION).zip" \

--plugin-dirname=exelearning --force

# Restore the version in exelearning.php & readme.txt

$(SED_INPLACE) "s/^ \* Version:.*/ * Version: 0.0.0/" exelearning.php

$(SED_INPLACE) "s/define( 'EXELEARNING_VERSION', '[^']*'/define( 'EXELEARNING_VERSION', '0.0.0'/" exelearning.php

$(SED_INPLACE) "s/^Stable tag:.*/Stable tag: 0.0.0/" readme.txt

help:

@echo "Available commands:"

@echo ""

@echo "eXeLearning Static Editor:"

@echo " build-editor - Build static eXeLearning editor from configured repo/ref"

@echo " build-editor-no-update - Alias of build-editor"

@echo " clean-editor - Remove static editor build and fetched source node_modules"

@echo " fetch-editor-source - Download editor source from configured repo/ref"

@echo ""

@echo "General:"

@echo " up - Fetch source, build static editor, and start Docker containers"

@echo " up-playground - Same as 'up' but using Playground runtime (no Docker required)"

@echo " down - Stop and remove Docker containers"

@echo " down-playground - Stop Playground runtime (no Docker required)"

@echo " reset - Reset the WordPress database"

@echo " logs - Show the docker container logs"

@echo " logs-test - Show logs from test environment"

@echo " clean - Clean up WordPress environment"

@echo " destroy - Destroy the WordPress environment"

@echo " flush-permalinks - Flush the created permalinks"

@echo " create-user - Create a WordPress user if it doesn't exist."

@echo " Usage: make create-user USER=<username> EMAIL=<email> ROLE=<role> PASSWORD=<password>"

@echo ""

@echo "Linting & Code Quality:"

@echo " fix - Automatically fix code style with PHP_CodeSniffer"

@echo " lint - Check code style with PHP_CodeSniffer"

@echo " fix-no-tty - Same as 'fix' but without TTY (for git hooks)"

@echo " lint-no-tty - Same as 'lint' but without TTY (for git hooks)"

@echo " check-plugin - Run WordPress plugin-check tests"

@echo " check-untranslated - Check for untranslated strings"

@echo " architecture-check - Validate architecture records (identifiers, metadata, links)"

@echo " architecture-records - Print the generated ADR and change index"

@echo " check - Run fix, lint, architecture-check, plugin-check, tests, untranslated, and mo"

@echo " check-all - Alias for 'check'"

@echo ""

@echo "Testing:"

@echo " test - Run PHPUnit tests. Accepts optional variables:"

@echo " FILTER=<pattern> (run tests matching the pattern)"

@echo " FILE=<path> (run tests in specific file)"

@echo " Examples:"

@echo " make test FILTER=MyTest"

@echo " make test FILE=tests/MyTest.php"

@echo " make test FILE=tests/MyTest.php FILTER=test_my_feature"

@echo " test-coverage - Run PHPUnit with coverage (requires: npx wp-env start --xdebug=coverage)"

@echo ""

@echo " test-e2e - Run E2E tests (non-interactive)"

@echo " test-e2e-visual - Run E2E tests with visual test UI"

@echo ""

@echo "Translations:"

@echo " pot - Generate the .pot file (editable source template)"

@echo " po - Update .po files from the .pot file"

@echo " mo - Generate .mo runtime files from .po files"

@echo " l10n-php - Generate .l10n.php runtime files (WordPress 6.5+) from .po files"

@echo " json - Regenerate the JS translation JSON files from .po files"

@echo " translations - Full deterministic build: pot, po, mo, l10n.php and json"

@echo " check-translations - Validate translation artifacts are complete and up to date"

@echo " i18n-audit - Run the WordPress i18n audit on the codebase"

@echo ""

@echo "Packaging & Updates:"

@echo " update - Update Composer dependencies"

@echo " package - Generate translations and create ZIP. Usage: make package VERSION=x.y.z"

@echo ""

@echo " help - Show this help message"

.DEFAULT_GOAL := help