MtoRagSystem/RETRIEX_PATCH_7_0A_AGENT_BASIS_YAML_ONLY_README.md

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:

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.