[wachterjohannes]

Q	A
Branch?	2.x
Bug fix?	no
New feature?	yes
Deprecations?	no
Issues	Prerequisite for symfony/ai#1994

When a recipe declares composer-scripts, Flex now also ensures @auto-scripts is wired into scripts.post-install-cmd and scripts.post-update-cmd in the user's composer.json. Restores parity with composer plugins for non-skeleton projects, where these hooks aren't pre-configured.

Cross-repo PRs

#	Repo	PR	What	Status
1	symfony/ai	symfony/ai#2027	mate discover --ignore-missing-file	open
2	symfony/ai	symfony/ai#2026	Drop symfony/ai-mate-composer-plugin from symfony/ai-mate's require list (depends on symfony/ai#2027)	draft
3	symfony/flex	symfony/flex#1089	Auto-wire @auto-scripts into post-install-cmd / post-update-cmd	this PR
4	symfony/recipes	symfony/recipes#1535	The symfony/ai-mate recipe	draft
5	symfony/ai	follow-up	Delete the composer plugin source	not started

Summary

ComposerScriptsConfigurator::configure() now, in addition to merging into scripts.auto-scripts, ensures @auto-scripts is present in both post-install-cmd and post-update-cmd:

• Hook missing → created as ["@auto-scripts"].
• Hook is an array without @auto-scripts → appended.
• Hook is a scalar → converted to array and appended.
• Hook already contains @auto-scripts → no-op (idempotent).

unconfigure() is intentionally untouched — the wiring stays even when the package is uninstalled, because other recipes may depend on it.

Usage

Recipes can now declare composer-scripts and rely on the script running automatically in any project — including plain PHP projects without the Symfony skeleton's pre-wired hooks.

[wachterjohannes]

Cross-references for the 4-PR plan in symfony/ai#1994:

• [Mate] Drop symfony/ai-mate-composer-plugin from symfony/ai-mate require ai#2026 — mate discover --ignore-missing-file flag + drop composer plugin from symfony/ai-mate requires
• [AiMate] Add recipe recipes#1535 — symfony/ai-mate Flex recipe (draft, gated on this PR + the Mate one)

[nicolas-grekas]

Why is this needed to achieve your plan? Which non-skeleton apps is this meant to cover?

[wachterjohannes]

@nicolas-grekas see the plan in symfony/ai#1994

this covers the integration of symfony mate - which will call the command vendor/bin/mate discover this allows to use mate in symfony apps with flex automatically add the script to composer.json post-*-cmd scripts or in none flex apps by calling the command manually or also add it manually to the composer.json

[wachterjohannes]

@nicolas-grekas as soon as you are OK with the plan i can fix this PR - if you have any other idea which allows to acchieve the goal - i am open to change my plan :)

[wachterjohannes]

Without this, the recipe's composer-scripts entry never runs outside the skeleton. Only the skeleton wires @auto-scripts into post-install-cmd and post-update-cmd. Plain PHP projects and other non-skeleton setups don't have those hooks.

Mate is a dev tool for any PHP project, so those are exactly the projects we need to cover. We need this change in Flex, unless you see another way to get the script to run there.

The change only touches the hooks when a recipe declares composer-scripts. It is idempotent, and unconfigure() leaves the hooks alone.