feat(plugins): unify screenshot/pause/aiTrace/heal under shared on= parameter

[DavertMik]

Summary

• Unifies four plugins (screenshot, pause, aiTrace, heal) under one on= trigger system: fail | test | step | file | url. CLI form is -p plugin:on=mode:key=value:key=value (or ; to inline-group sub-keys like path + line); config form is the equivalent object.
• Adds a shared lib/utils/pluginParser.js (parsePluginArgs, resolveTrigger, matchStepFile, matchUrl, getBrowserHelper) — replaces duplicated parsing/matching code across the four plugins.
• Renames screenshotOnFail → screenshot and consolidates pauseOn + pauseOnFail → pause; old names remain as deprecated alias shims that warn and forward (positional CLI args translate to the new on=key:param=value syntax).

Behavior

Plugin	Default on	Modes accepted
screenshot	fail	fail, test, step, file (path[, line]), url (pattern)
pause	fail	fail, test, step, file (path[, line]), url (pattern)
aiTrace	step	fail, test, step, file (path[, line]), url (pattern)
heal	fail	fail (default), file (path[, line]), url (pattern)

heal:on=step and heal:on=test are rejected with a clear error.

CLI examples

npx codeceptjs run -p screenshot:on=step
npx codeceptjs run -p pause:on=file:path=tests/login_test.js;line=43
npx codeceptjs run -p aiTrace:on=fail
npx codeceptjs run -p heal:on=url:pattern=/users/*

Companion change

@codeceptjs/configure setCommonPlugins is updated to register the new plugin names with their on= defaults; old keys are removed there (the alias shims still load if a user references them directly).

Test plan

• Parser unit smoke (CLI parsing, precedence, line coercion) — 11/11 pass
• npx mocha test/unit --recursive — 611 passing, no plugin regressions
• Existing screenshotOnFail and aiTrace unit tests pass through the alias / new code path unchanged
• Acceptance config loads the new plugin (Plugins: screenshot, retryFailedStep, pause, heal)
• Validation: -p screenshot:on=file (missing path=) prints the expected error
• Deprecation aliases load and emit deprecation warnings
• Full Playwright acceptance run against the test web server (not exercised here — server wasn't available locally)

🤖 Generated with Claude Code