new struct md files

patch_history/RETRIEX_AGENT_CONFIG_FIX_README.md

@@ -0,0 +1,32 @@
+# RetrieX Agent Config Centralization Fix
+
+This patch moves low-risk AgentRunner configuration values into `config/retriex/agent.yaml` while keeping the existing PHP fallback values in `AgentRunnerConfig`.
+
+## Scope
+
+Changed files:
+
+- `config/retriex/agent.yaml`
+- `src/Config/AgentRunnerConfig.php`
+- `RETRIEX_AGENT_CONFIG_FIX_README.md`
+
+## What was centralized
+
+- user-visible progress/status messages
+- error messages
+- source labels
+- small HTML templates used by the agent stream/output
+- Shopware query optimizer prompt text and rules
+
+## What was intentionally not changed
+
+- `PromptBuilderConfig` prompt wording/rules
+- retrieval scoring logic
+- shop matching logic
+- vocabulary/intent/search-repair logic from the previous stable centralization step
+
+## Safety notes
+
+The YAML values mirror the existing PHP fallback values. `AgentRunnerConfig` still contains the old defaults as fallbacks, so missing or invalid YAML values should not break runtime behavior.
+
+After applying the patch, clear the Symfony cache and re-run the known 1.4.2 regression prompts.