patch 7

RETRIEX_PATCH_7_0A_AGENT_BASIS_YAML_ONLY_README.md

@@ -0,0 +1,39 @@
+# RetrieX Patch 7.0a - AgentRunnerConfig basis values YAML-only
+
+Scope: small first AgentRunnerConfig migration step.
+
+Changed:
+- `AgentRunnerConfig` no longer uses PHP fallback defaults for the five simple basis values:
+  - `commerce_history_budget_chars`
+  - `product_search_knowledge_chunk_limit`
+  - `advisory_product_search_knowledge_chunk_limit`
+  - `optimized_shop_query_prefix_pattern`
+  - `optimized_shop_query_trim_characters`
+- Added required typed accessors for these values.
+- Missing or invalid YAML values now raise a clear `InvalidArgumentException` instead of silently using PHP fallback defaults.
+
+Not changed:
+- Agent messages
+- source labels
+- HTML templates
+- No-LLM fallback texts
+- shop prompt / meta guard rules
+- retrieval
+- PromptBuilder
+- CommerceQueryParser
+- Shop matching
+
+Prerequisite:
+- Patch 6.1 must already be applied, because it adds `optimized_shop_query_trim_characters` to `config/retriex/agent.yaml`.
+
+Recommended checks after applying:
+```bash
+php bin/console cache:clear
+php bin/console mto:agent:config:validate
+php bin/console mto:agent:config:audit-source --details
+php bin/console mto:agent:regression:test
+```
+
+Expected audit direction:
+- `fallback_accessors` should decrease by 5.
+- The five basis keys above should no longer appear as `yaml_with_php_fallback` in `AgentRunnerConfig`.