# Address Query — Execution Lineup V1 (Project Sync)

Дата: 2026-03-29

## Принцип выполнения

Один пакет, последовательные subwave, без большого неразмеченного рефакторинга.

## Subwave M0 — Contracts and Foundations (No behavior change)

Цель: добавить контракты и каркас без переключения runtime.

- `question_mode/address_intent` contracts;
- address debug contract;
- base recipe schema;
- semantic registry skeleton (P0 entities only).

Артефакты:

- `docs/ADDRESS/runs/<run_id>/M0_contracts_report.md`
- `contracts_diff.md`

## Subwave M1 — Classifier + Intent + Filter Pipeline

Цель: научить runtime распознавать address mode и извлекать фильтры.

- mode classifier;
- P0 intent resolver;
- filter extractor + validator;
- resolver subset (counterparty/contract/account/document_type/organization).

Артефакты:

- `intent_resolution_matrix.md`
- `filter_extraction_audit.json`
- `resolver_ambiguity_cases.md`

## Subwave M1.5 — L0 Hybrid Router Stabilization

Цель: стабилизировать входную интерпретацию на шумном вводе без раздувания словарей.

- LLM-first decompose в строгий JSON-контракт;
- deterministic fallback (корни/подстроки, парсинг дат и счетов, шумоочистка);
- режим `shadow` (без влияния на финальный ответ) и сбор trace;
- переход в `soft-enable` только после прохождения регрессии.

Артефакты:

- `llm_router_shadow_report.json`
- `fallback_trigger_audit.md`
- `noisy_input_regression_results.md`

## Subwave M2 — Recipe + MCP Execution (Live-first)

Цель: связать intents с whitelist recipes и реальным MCP execution.

- recipe selector;
- address MCP executor;
- live-first policy;
- controlled fallback (no silent snapshot).

Артефакты:

- `recipe_selection_report.md`
- `live_call_inventory_address.json`
- `fallback_policy_audit.md`

## Subwave M3 — Factual Answer Composer + Debug

Цель: стабильный factual output в едином контракте.

- `FACTUAL_LIST` / `FACTUAL_SUMMARY` / `LIMITED_WITH_REASON`;
- compact output для текущей оболочки диалога;
- debug payload fields finalized.

Артефакты:

- `answer_contract_examples.md`
- `debug_payload_samples/`

## Subwave M4 — Live Acceptance Rerun

Контрольный набор:

1. кто должен нам на сегодня;
2. кому должны мы;
3. какие договоры не закрыты;
4. остаток по 60 на дату;
5. какие документы формируют остаток.

Acceptance gates:

- correct mode routing for P0 queries;
- non-empty factual outputs on expected-positive live cases;
- `false_factual_rate = 0`;
- no regression in deep-analysis path.

Артефакты:

- `chat_export_address_live.md`
- `address_case_matrix.md`
- `before_after_metrics.json`
- `run_summary.json`

## Что делаем сразу

- Сегодня стартуем с `M0` и `M1` (контракты + классификация/фильтры).
- После этого закрываем `M1.5` (shadow L0 router + регрессия на шумных вопросах).
- И только затем поднимаем `M2` для 2 первых intents (`payables/receivables`).