ГЛОБАЛЬНЫЙ РЕФАКТОРИНГ АРХИТЕКТУРЫ - Архитектура маршрутов v2: baseline ожиданий intentrecipe/result_mode с runtime-аудитом

This commit is contained in:
2026-04-12 14:54:52 +03:00
parent bd1fbbdb67
commit 278eb4abeb
14 changed files with 624 additions and 6 deletions
+7
View File
@@ -100,6 +100,13 @@ Route baseline contract:
This baseline freezes capability mapping for key intents and acts as anti-regression control when routing evolves.
Route expectation contract (level 2):
- `docs/TECH/address_route_expectations_v1.json`
- loader/evaluator: `llm_normalizer/backend/src/services/addressRouteExpectations.ts`
This second-level baseline freezes expected `intent -> selected_recipe/result_mode` semantics and provides runtime audit with optional hard guard.
## Why This Is a Foundation, Not a Patch
This change does not only tune one scenario. It introduces stable contracts:
@@ -0,0 +1,61 @@
{
"schema_version": "address_route_expectations_v1",
"updated_at": "2026-04-12T13:00:00.000Z",
"entries": [
{
"intent": "payables_confirmed_as_of_date",
"expected_selected_recipes": ["address_payables_confirmed_as_of_date_v1"],
"expected_requested_result_modes": ["confirmed_balance"],
"expected_result_modes": ["confirmed_balance"]
},
{
"intent": "list_payables_counterparties",
"expected_selected_recipes": ["address_movements_payables_v1", "address_open_items_by_party_or_contract_v1"],
"expected_requested_result_modes": ["heuristic_candidates", "confirmed_balance"],
"expected_result_modes": ["heuristic_candidates", "confirmed_balance"]
},
{
"intent": "list_receivables_counterparties",
"expected_selected_recipes": ["address_movements_receivables_v1", "address_open_items_by_party_or_contract_v1"],
"expected_requested_result_modes": ["heuristic_candidates", "confirmed_balance"],
"expected_result_modes": ["heuristic_candidates", "confirmed_balance"]
},
{
"intent": "account_balance_snapshot",
"expected_selected_recipes": ["address_open_items_by_party_or_contract_v1"],
"expected_requested_result_modes": ["confirmed_balance"],
"expected_result_modes": ["confirmed_balance"]
},
{
"intent": "documents_forming_balance",
"expected_selected_recipes": ["address_open_items_by_party_or_contract_v1"],
"expected_requested_result_modes": ["confirmed_balance"],
"expected_result_modes": ["confirmed_balance"]
},
{
"intent": "list_contracts_by_counterparty",
"expected_selected_recipes": ["address_contracts_by_counterparty_v1"],
"expected_result_modes": ["heuristic_candidates", "confirmed_balance"]
},
{
"intent": "list_documents_by_counterparty",
"expected_selected_recipes": ["address_documents_by_counterparty_v1"],
"expected_result_modes": ["heuristic_candidates", "confirmed_balance"]
},
{
"intent": "list_documents_by_contract",
"expected_selected_recipes": ["address_documents_by_contract_v1"],
"expected_result_modes": ["heuristic_candidates", "confirmed_balance"]
},
{
"intent": "bank_operations_by_counterparty",
"expected_selected_recipes": ["address_bank_operations_by_counterparty_v1"],
"expected_result_modes": ["heuristic_candidates", "confirmed_balance"]
},
{
"intent": "bank_operations_by_contract",
"expected_selected_recipes": ["address_bank_operations_by_contract_v1"],
"expected_result_modes": ["heuristic_candidates", "confirmed_balance"]
}
]
}