ГЛОБАЛЬНЫЙ РЕФАКТОРИНГ АРХИТЕКТУРЫ - Архитектурный фундамент: capability-guard, navigation state и трассируемый route-контракт

llm_normalizer/backend/dist/services/addressCapabilityPolicy.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveAddressCapabilityRouteDecision = resolveAddressCapabilityRouteDecision;
+exports.isCapabilityRouteBlocked = isCapabilityRouteBlocked;
+exports.resolveShadowRouteIntent = resolveShadowRouteIntent;
+const config_1 = require("../config");
+const COMPUTE_EXACT_INTENTS = new Set(["account_balance_snapshot", "documents_forming_balance", "payables_confirmed_as_of_date"]);
+const NAVIGATION_INTENTS = new Set([
+    "list_documents_by_counterparty",
+    "bank_operations_by_counterparty",
+    "list_contracts_by_counterparty",
+    "list_documents_by_contract",
+    "bank_operations_by_contract"
+]);
+const HEURISTIC_LIST_INTENTS = new Set([
+    "list_payables_counterparties",
+    "list_receivables_counterparties",
+    "open_items_by_counterparty_or_contract",
+    "list_open_contracts"
+]);
+function isExactComputeIntent(intent) {
+    return COMPUTE_EXACT_INTENTS.has(intent);
+}
+function isNavigationIntent(intent) {
+    return NAVIGATION_INTENTS.has(intent);
+}
+function isHeuristicListIntent(intent) {
+    return HEURISTIC_LIST_INTENTS.has(intent);
+}
+function defaultCapabilityId(intent) {
+    if (intent === "payables_confirmed_as_of_date") {
+        return "confirmed_payables_as_of_date";
+    }
+    if (intent === "list_payables_counterparties") {
+        return "payables_candidates_list";
+    }
+    if (intent === "list_receivables_counterparties") {
+        return "receivables_candidates_list";
+    }
+    if (intent === "account_balance_snapshot" || intent === "documents_forming_balance") {
+        return "account_balance_exact";
+    }
+    if (intent === "list_documents_by_counterparty" || intent === "list_documents_by_contract") {
+        return "documents_drilldown";
+    }
+    if (intent === "list_contracts_by_counterparty") {
+        return "contracts_drilldown";
+    }
+    if (intent === "bank_operations_by_counterparty" || intent === "bank_operations_by_contract") {
+        return "bank_operations_drilldown";
+    }
+    return `address_${intent}`;
+}
+function resolveCapabilityEnabled(intent) {
+    if (intent === "payables_confirmed_as_of_date") {
+        return {
+            enabled: config_1.FEATURE_ASSISTANT_ROUTE_PAYABLES_CONFIRMED_V1,
+            reason: config_1.FEATURE_ASSISTANT_ROUTE_PAYABLES_CONFIRMED_V1 ? "payables_confirmed_route_enabled" : "payables_confirmed_route_disabled_by_flag"
+        };
+    }
+    if (intent === "list_payables_counterparties") {
+        return {
+            enabled: config_1.FEATURE_ASSISTANT_ROUTE_PAYABLES_HEURISTIC_V1,
+            reason: config_1.FEATURE_ASSISTANT_ROUTE_PAYABLES_HEURISTIC_V1 ? "payables_heuristic_route_enabled" : "payables_heuristic_route_disabled_by_flag"
+        };
+    }
+    if (intent === "list_receivables_counterparties" || intent === "open_items_by_counterparty_or_contract" || intent === "list_open_contracts") {
+        return {
+            enabled: config_1.FEATURE_ASSISTANT_ROUTE_RECEIVABLES_HEURISTIC_V1,
+            reason: config_1.FEATURE_ASSISTANT_ROUTE_RECEIVABLES_HEURISTIC_V1 ? "receivables_heuristic_route_enabled" : "receivables_heuristic_route_disabled_by_flag"
+        };
+    }
+    if (intent === "account_balance_snapshot" || intent === "documents_forming_balance") {
+        return {
+            enabled: config_1.FEATURE_ASSISTANT_ROUTE_BALANCE_EXACT_V1,
+            reason: config_1.FEATURE_ASSISTANT_ROUTE_BALANCE_EXACT_V1 ? "balance_exact_route_enabled" : "balance_exact_route_disabled_by_flag"
+        };
+    }
+    if (isNavigationIntent(intent)) {
+        return {
+            enabled: config_1.FEATURE_ASSISTANT_ROUTE_DRILLDOWN_V1,
+            reason: config_1.FEATURE_ASSISTANT_ROUTE_DRILLDOWN_V1 ? "drilldown_route_enabled" : "drilldown_route_disabled_by_flag"
+        };
+    }
+    return {
+        enabled: config_1.FEATURE_ASSISTANT_ROUTE_ADDRESS_GENERIC_V1,
+        reason: config_1.FEATURE_ASSISTANT_ROUTE_ADDRESS_GENERIC_V1 ? "generic_address_route_enabled" : "generic_address_route_disabled_by_flag"
+    };
+}
+function resolveAddressCapabilityRouteDecision(intent) {
+    const capability = defaultCapabilityId(intent);
+    const enabled = resolveCapabilityEnabled(intent);
+    const layer = isNavigationIntent(intent)
+        ? "navigation"
+        : isExactComputeIntent(intent) || isHeuristicListIntent(intent)
+            ? "compute"
+            : "conversational";
+    const routeMode = isHeuristicListIntent(intent) ? "heuristic" : "exact";
+    return {
+        capability_id: capability,
+        capability_layer: layer,
+        capability_route_mode: routeMode,
+        capability_route_enabled: enabled.enabled,
+        capability_route_reason: enabled.reason
+    };
+}
+function isCapabilityRouteBlocked(decision) {
+    return config_1.FEATURE_ASSISTANT_CAPABILITY_ROUTE_GUARD_V1 && !decision.capability_route_enabled;
+}
+function resolveShadowRouteIntent(intent, requestedResultMode) {
+    if (!config_1.FEATURE_ASSISTANT_ROUTE_SHADOW_PAYABLES_EXACT_V1) {
+        return null;
+    }
+    if (intent === "payables_confirmed_as_of_date") {
+        return "list_payables_counterparties";
+    }
+    if (intent === "list_payables_counterparties" && requestedResultMode === "confirmed_balance") {
+        return "payables_confirmed_as_of_date";
+    }
+    return null;
+}

llm_normalizer/backend/dist/services/addressNavigationState.js

@@ -0,0 +1,391 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEmptyAddressNavigationState = createEmptyAddressNavigationState;
+exports.cloneAddressNavigationState = cloneAddressNavigationState;
+exports.normalizeAddressNavigationState = normalizeAddressNavigationState;
+exports.evolveAddressNavigationStateWithAssistantItem = evolveAddressNavigationStateWithAssistantItem;
+const nanoid_1 = require("nanoid");
+const addressNavigation_1 = require("../types/addressNavigation");
+const MAX_RESULT_SETS = 40;
+const MAX_NAVIGATION_EVENTS = 120;
+const MAX_ENTITY_REFS_PER_RESULT_SET = 40;
+const DISPLAY_ENTITY_TYPE_BY_INTENT = {
+    counterparty_activity_lifecycle: "counterparty",
+    customer_revenue_and_payments: "counterparty",
+    supplier_payouts_profile: "counterparty",
+    list_payables_counterparties: "counterparty",
+    list_receivables_counterparties: "counterparty",
+    list_contracts_by_counterparty: "contract",
+    list_documents_by_counterparty: "document_ref",
+    list_documents_by_contract: "document_ref",
+    bank_operations_by_counterparty: "document_ref",
+    bank_operations_by_contract: "document_ref",
+    open_items_by_counterparty_or_contract: "counterparty"
+};
+const RESULT_SET_TYPE_BY_INTENT = {
+    counterparty_activity_lifecycle: "counterparty_list",
+    customer_revenue_and_payments: "counterparty_list",
+    supplier_payouts_profile: "counterparty_list",
+    list_payables_counterparties: "counterparty_list",
+    payables_confirmed_as_of_date: "balance_snapshot",
+    list_receivables_counterparties: "counterparty_list",
+    list_contracts_by_counterparty: "contract_list",
+    list_documents_by_counterparty: "document_list",
+    list_documents_by_contract: "document_list",
+    bank_operations_by_counterparty: "bank_operations_list",
+    bank_operations_by_contract: "bank_operations_list",
+    open_items_by_counterparty_or_contract: "open_items_list",
+    period_coverage_profile: "profile_summary",
+    document_type_and_account_section_profile: "profile_summary",
+    counterparty_population_and_roles: "profile_summary",
+    contract_usage_overview: "profile_summary",
+    contract_usage_and_value: "profile_summary",
+    vat_payable_forecast: "profile_summary"
+};
+function toObject(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return null;
+    }
+    return value;
+}
+function toNonEmptyString(value) {
+    if (typeof value !== "string") {
+        return null;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+function toAddressFocusObjectType(value) {
+    const normalized = toNonEmptyString(value);
+    if (!normalized) {
+        return "unknown";
+    }
+    if (normalized === "counterparty" || normalized === "contract" || normalized === "document_ref" || normalized === "account") {
+        return normalized;
+    }
+    return "unknown";
+}
+function toAddressIntent(value) {
+    const normalized = toNonEmptyString(value);
+    return (normalized ?? "unknown");
+}
+function inferDisplayEntityType(intent) {
+    return DISPLAY_ENTITY_TYPE_BY_INTENT[intent] ?? "unknown";
+}
+function inferResultSetType(intent) {
+    return RESULT_SET_TYPE_BY_INTENT[intent] ?? "unknown";
+}
+function parseEntityCandidateFromLine(line) {
+    const compact = String(line ?? "").trim();
+    if (!compact) {
+        return null;
+    }
+    const numberedMatch = compact.match(/^(\d+)\.\s+(.+)$/);
+    if (!numberedMatch) {
+        return null;
+    }
+    const index = Number.parseInt(String(numberedMatch[1] ?? ""), 10);
+    if (!Number.isFinite(index) || index <= 0) {
+        return null;
+    }
+    const afterNumber = String(numberedMatch[2] ?? "");
+    const pieces = afterNumber.split("|").map((item) => item.trim()).filter(Boolean);
+    const valueCandidate = pieces.length > 0 ? pieces[0] : afterNumber;
+    const cleaned = valueCandidate.replace(/^["'«»“”„`’‘]+|["'«»“”„`’‘]+$/gu, "").trim();
+    if (!cleaned || cleaned.length < 2) {
+        return null;
+    }
+    return { index, value: cleaned };
+}
+function extractEntityRefsFromAssistantReply(replyText, intent, limit = MAX_ENTITY_REFS_PER_RESULT_SET) {
+    const entityType = inferDisplayEntityType(intent);
+    if (entityType === "unknown") {
+        return [];
+    }
+    const dedup = new Map();
+    const lines = String(replyText ?? "").split(/\r?\n/);
+    for (const line of lines) {
+        const parsed = parseEntityCandidateFromLine(line);
+        if (!parsed) {
+            continue;
+        }
+        const key = `${parsed.index}:${entityType}:${parsed.value.toLowerCase()}`;
+        if (!dedup.has(key)) {
+            dedup.set(key, {
+                index: parsed.index,
+                entity_type: entityType,
+                value: parsed.value
+            });
+        }
+        if (dedup.size >= limit) {
+            break;
+        }
+    }
+    return Array.from(dedup.values());
+}
+function cloneFocusObject(value) {
+    if (!value) {
+        return null;
+    }
+    return {
+        object_type: value.object_type,
+        object_id: value.object_id,
+        label: value.label,
+        provenance_result_set_id: value.provenance_result_set_id,
+        selected_at: value.selected_at
+    };
+}
+function cloneResultSet(input) {
+    return {
+        result_set_id: input.result_set_id,
+        type: input.type,
+        intent: input.intent,
+        route_id: input.route_id,
+        filters: { ...input.filters },
+        source_refs: [...input.source_refs],
+        entity_refs: input.entity_refs.map((item) => ({
+            index: item.index,
+            entity_type: item.entity_type,
+            value: item.value
+        })),
+        created_from_turn: input.created_from_turn,
+        created_at: input.created_at
+    };
+}
+function cloneNavigationEvent(input) {
+    return {
+        event_id: input.event_id,
+        action: input.action,
+        source_result_set_id: input.source_result_set_id,
+        target_object_id: input.target_object_id,
+        derived_result_set_id: input.derived_result_set_id,
+        turn_index: input.turn_index,
+        created_at: input.created_at
+    };
+}
+function normalizeFilters(value) {
+    const record = toObject(value);
+    if (!record) {
+        return {};
+    }
+    return { ...record };
+}
+function resolveNavigationAction(debug, hasFocusObject) {
+    const continuationContract = toObject(debug.dialog_continuation_contract_v2);
+    const decision = toNonEmptyString(continuationContract?.decision);
+    if (decision === "new_topic") {
+        return "open";
+    }
+    if (decision === "continue_previous") {
+        return hasFocusObject ? "drilldown" : "refine";
+    }
+    if (decision === "switch_to_suggested") {
+        return "refine";
+    }
+    return hasFocusObject ? "drilldown" : "open";
+}
+function buildFocusObjectFromDebug(debug, resultSetId, createdAt) {
+    const rawValue = toNonEmptyString(debug.anchor_value_resolved) ?? toNonEmptyString(debug.anchor_value_raw);
+    if (!rawValue) {
+        return null;
+    }
+    const objectType = toAddressFocusObjectType(debug.anchor_type);
+    const canonicalType = objectType === "unknown" ? inferDisplayEntityType(toAddressIntent(debug.detected_intent)) : objectType;
+    return {
+        object_type: canonicalType,
+        object_id: `${canonicalType}:${rawValue}`.toLowerCase(),
+        label: rawValue,
+        provenance_result_set_id: resultSetId,
+        selected_at: createdAt
+    };
+}
+function capResultSets(resultSets) {
+    if (resultSets.length <= MAX_RESULT_SETS) {
+        return resultSets;
+    }
+    return resultSets.slice(resultSets.length - MAX_RESULT_SETS);
+}
+function capNavigationEvents(events) {
+    if (events.length <= MAX_NAVIGATION_EVENTS) {
+        return events;
+    }
+    return events.slice(events.length - MAX_NAVIGATION_EVENTS);
+}
+function isAddressAssistantItem(item) {
+    return (item.role === "assistant" &&
+        Boolean(item.debug) &&
+        toNonEmptyString(item.debug?.detected_mode) === "address_query");
+}
+function createEmptyAddressNavigationState(sessionId, nowIso = new Date().toISOString()) {
+    return {
+        schema_version: addressNavigation_1.ADDRESS_NAVIGATION_STATE_SCHEMA_VERSION,
+        session_id: sessionId,
+        updated_at: nowIso,
+        session_context: {
+            active_result_set_id: null,
+            active_focus_object: null,
+            last_confirmed_route: null,
+            date_scope: {
+                as_of_date: null,
+                period_from: null,
+                period_to: null
+            },
+            organization_scope: null
+        },
+        result_sets: [],
+        navigation_history: []
+    };
+}
+function cloneAddressNavigationState(value) {
+    if (!value) {
+        return null;
+    }
+    return {
+        schema_version: value.schema_version,
+        session_id: value.session_id,
+        updated_at: value.updated_at,
+        session_context: {
+            active_result_set_id: value.session_context.active_result_set_id,
+            active_focus_object: cloneFocusObject(value.session_context.active_focus_object),
+            last_confirmed_route: value.session_context.last_confirmed_route,
+            date_scope: {
+                as_of_date: value.session_context.date_scope.as_of_date,
+                period_from: value.session_context.date_scope.period_from,
+                period_to: value.session_context.date_scope.period_to
+            },
+            organization_scope: value.session_context.organization_scope
+        },
+        result_sets: value.result_sets.map(cloneResultSet),
+        navigation_history: value.navigation_history.map(cloneNavigationEvent)
+    };
+}
+function normalizeAddressNavigationState(value, sessionId) {
+    const fallback = createEmptyAddressNavigationState(sessionId);
+    if (!value || typeof value !== "object") {
+        return fallback;
+    }
+    const normalizedSessionId = toNonEmptyString(value.session_id) ?? sessionId;
+    const normalizedUpdatedAt = toNonEmptyString(value.updated_at) ?? new Date().toISOString();
+    const context = toObject(value.session_context) ?? {};
+    const dateScope = toObject(context.date_scope) ?? {};
+    const resultSets = Array.isArray(value.result_sets) ? value.result_sets : [];
+    const navigationHistory = Array.isArray(value.navigation_history) ? value.navigation_history : [];
+    return {
+        schema_version: addressNavigation_1.ADDRESS_NAVIGATION_STATE_SCHEMA_VERSION,
+        session_id: normalizedSessionId,
+        updated_at: normalizedUpdatedAt,
+        session_context: {
+            active_result_set_id: toNonEmptyString(context.active_result_set_id),
+            active_focus_object: cloneFocusObject(context.active_focus_object),
+            last_confirmed_route: toNonEmptyString(context.last_confirmed_route),
+            date_scope: {
+                as_of_date: toNonEmptyString(dateScope.as_of_date),
+                period_from: toNonEmptyString(dateScope.period_from),
+                period_to: toNonEmptyString(dateScope.period_to)
+            },
+            organization_scope: toNonEmptyString(context.organization_scope)
+        },
+        result_sets: resultSets
+            .map((item) => toObject(item))
+            .filter((item) => item !== null)
+            .map((item) => ({
+            result_set_id: toNonEmptyString(item.result_set_id) ?? `rs-${(0, nanoid_1.nanoid)(10)}`,
+            type: inferResultSetType(toAddressIntent(item.intent)),
+            intent: toAddressIntent(item.intent),
+            route_id: toNonEmptyString(item.route_id),
+            filters: normalizeFilters(item.filters),
+            source_refs: Array.isArray(item.source_refs)
+                ? item.source_refs.map((v) => toNonEmptyString(v)).filter((v) => Boolean(v))
+                : [],
+            entity_refs: Array.isArray(item.entity_refs)
+                ? item.entity_refs
+                    .map((entry) => toObject(entry))
+                    .filter((entry) => entry !== null)
+                    .map((entry) => ({
+                    index: Number.isFinite(Number(entry.index)) ? Number(entry.index) : 0,
+                    entity_type: toAddressFocusObjectType(entry.entity_type),
+                    value: toNonEmptyString(entry.value) ?? ""
+                }))
+                    .filter((entry) => entry.index > 0 && entry.value.length > 0)
+                : [],
+            created_from_turn: Number.isFinite(Number(item.created_from_turn)) ? Number(item.created_from_turn) : 0,
+            created_at: toNonEmptyString(item.created_at) ?? normalizedUpdatedAt
+        })),
+        navigation_history: navigationHistory
+            .map((item) => toObject(item))
+            .filter((item) => item !== null)
+            .map((item) => ({
+            event_id: toNonEmptyString(item.event_id) ?? `nav-${(0, nanoid_1.nanoid)(10)}`,
+            action: toNonEmptyString(item.action) ?? "open",
+            source_result_set_id: toNonEmptyString(item.source_result_set_id),
+            target_object_id: toNonEmptyString(item.target_object_id),
+            derived_result_set_id: toNonEmptyString(item.derived_result_set_id),
+            turn_index: Number.isFinite(Number(item.turn_index)) ? Number(item.turn_index) : 0,
+            created_at: toNonEmptyString(item.created_at) ?? normalizedUpdatedAt
+        }))
+    };
+}
+function evolveAddressNavigationStateWithAssistantItem(state, item, turnIndex) {
+    if (!isAddressAssistantItem(item) || !item.debug) {
+        return state;
+    }
+    const debug = item.debug;
+    const intent = toAddressIntent(debug.detected_intent);
+    if (intent === "unknown") {
+        return state;
+    }
+    const createdAt = toNonEmptyString(item.created_at) ?? new Date().toISOString();
+    const resultSetId = `rs-${item.message_id}`;
+    const routeId = toNonEmptyString(debug.selected_recipe);
+    const filters = normalizeFilters(debug.extracted_filters);
+    const sourceRefs = routeId ? [routeId] : [];
+    const entityRefs = extractEntityRefsFromAssistantReply(item.text, intent);
+    const resultSet = {
+        result_set_id: resultSetId,
+        type: inferResultSetType(intent),
+        intent,
+        route_id: routeId,
+        filters,
+        source_refs: sourceRefs,
+        entity_refs: entityRefs,
+        created_from_turn: turnIndex,
+        created_at: createdAt
+    };
+    const previousResultSetId = state.session_context.active_result_set_id;
+    const focusObject = buildFocusObjectFromDebug(debug, resultSetId, createdAt);
+    const action = resolveNavigationAction(debug, Boolean(focusObject));
+    const navigationEvent = {
+        event_id: `nav-${(0, nanoid_1.nanoid)(10)}`,
+        action,
+        source_result_set_id: previousResultSetId,
+        target_object_id: focusObject?.object_id ?? null,
+        derived_result_set_id: resultSetId,
+        turn_index: turnIndex,
+        created_at: createdAt
+    };
+    const normalizedDateScope = {
+        as_of_date: toNonEmptyString(filters.as_of_date),
+        period_from: toNonEmptyString(filters.period_from),
+        period_to: toNonEmptyString(filters.period_to)
+    };
+    const organizationScope = toNonEmptyString(filters.organization);
+    const nextResultSets = capResultSets([...state.result_sets.filter((itemSet) => itemSet.result_set_id !== resultSetId), resultSet].sort((left, right) => left.created_from_turn - right.created_from_turn));
+    const nextEvents = capNavigationEvents([...state.navigation_history, navigationEvent]);
+    return {
+        ...state,
+        updated_at: createdAt,
+        session_context: {
+            active_result_set_id: resultSetId,
+            active_focus_object: focusObject ?? state.session_context.active_focus_object,
+            last_confirmed_route: routeId ?? state.session_context.last_confirmed_route,
+            date_scope: {
+                as_of_date: normalizedDateScope.as_of_date ?? state.session_context.date_scope.as_of_date,
+                period_from: normalizedDateScope.period_from ?? state.session_context.date_scope.period_from,
+                period_to: normalizedDateScope.period_to ?? state.session_context.date_scope.period_to
+            },
+            organization_scope: organizationScope ?? state.session_context.organization_scope
+        },
+        result_sets: nextResultSets,
+        navigation_history: nextEvents
+    };
+}

llm_normalizer/backend/dist/services/addressQueryService.js

@@ -7,6 +7,7 @@ const addressMcpClient_1 = require("./addressMcpClient");
 const decomposeStage_1 = require("./address_runtime/decomposeStage");
 const resolveStage_1 = require("./address_runtime/resolveStage");
 const composeStage_1 = require("./address_runtime/composeStage");
+const addressCapabilityPolicy_1 = require("./addressCapabilityPolicy");
 const ACCOUNT_SCOPE_FIELDS_CHECKED = ["account_dt", "account_kt", "registrator", "analytics"];
 const ACCOUNT_SCOPE_MATCH_STRATEGY = "account_code_regex_plus_alias_map_v1";
 const ADDRESS_ANCHOR_RECOVERY_LIMIT = 1000;
@@ -747,6 +748,39 @@ function withConfirmedBalanceFallbackReason(reasons, requestedResultMode, semant
     }
     return [...reasons, "confirmed_balance_unavailable_fallback_to_heuristic_candidates"];
 }
+function buildCapabilityAudit(intent) {
+    const decision = (0, addressCapabilityPolicy_1.resolveAddressCapabilityRouteDecision)(intent);
+    return {
+        capabilityId: decision.capability_id,
+        layer: decision.capability_layer,
+        routeMode: decision.capability_route_mode,
+        enabled: decision.capability_route_enabled,
+        reason: decision.capability_route_reason
+    };
+}
+function buildShadowRouteAudit(input) {
+    const shadowIntent = (0, addressCapabilityPolicy_1.resolveShadowRouteIntent)(input.intent, input.requestedResultMode);
+    if (!shadowIntent) {
+        return {
+            intent: null,
+            selectedRecipe: null,
+            status: "skipped"
+        };
+    }
+    const shadowRecipeSelection = (0, addressRecipeCatalog_1.selectAddressRecipe)(shadowIntent, input.filters);
+    if (!shadowRecipeSelection.selected_recipe) {
+        return {
+            intent: shadowIntent,
+            selectedRecipe: null,
+            status: "unavailable"
+        };
+    }
+    return {
+        intent: shadowIntent,
+        selectedRecipe: shadowRecipeSelection.selected_recipe.recipe_id,
+        status: "planned"
+    };
+}
 function enforceStrictAccountScopeForIntent(plan, intent) {
     if (intent !== "list_receivables_counterparties" || plan.account_scope_mode === "strict") {
         return plan;
@@ -1411,6 +1445,14 @@ function buildLimitedExecutionResult(input) {
             runtime_readiness: runtimeReadinessForLimitedCategory(input.category),
             limited_reason_category: input.category,
             response_type: "LIMITED_WITH_REASON",
+            capability_id: input.capabilityAudit?.capabilityId ?? null,
+            capability_layer: input.capabilityAudit?.layer ?? null,
+            capability_route_mode: input.capabilityAudit?.routeMode ?? null,
+            capability_route_enabled: input.capabilityAudit?.enabled ?? true,
+            capability_route_reason: input.capabilityAudit?.reason ?? null,
+            shadow_route_intent: input.shadowRouteAudit?.intent ?? null,
+            shadow_route_selected_recipe: input.shadowRouteAudit?.selectedRecipe ?? null,
+            shadow_route_status: input.shadowRouteAudit?.status ?? "skipped",
             ...resultSemantics,
             limitations: input.limitations,
             reasons
@@ -1458,6 +1500,36 @@ class AddressQueryService {
                 baseReasons.push("as_of_date_derived_for_confirmed_payables");
             }
         }
+        const capabilityDecision = (0, addressCapabilityPolicy_1.resolveAddressCapabilityRouteDecision)(intent.intent);
+        const capabilityAudit = buildCapabilityAudit(intent.intent);
+        const shadowRouteAudit = buildShadowRouteAudit({
+            intent: intent.intent,
+            requestedResultMode,
+            filters: executionFilters
+        });
+        if ((0, addressCapabilityPolicy_1.isCapabilityRouteBlocked)(capabilityDecision)) {
+            return buildLimitedExecutionResult({
+                mode,
+                shape,
+                intent,
+                filters: executionFilters,
+                missingRequiredFilters: [],
+                selectedRecipe: null,
+                mcpCallStatus: "skipped",
+                rowsFetched: 0,
+                rowsMatched: 0,
+                category: "unsupported",
+                reasonText: "маршрут capability временно отключен feature-флагом",
+                nextStep: "включите capability route или используйте соседний поддерживаемый сценарий",
+                limitations: ["capability_route_disabled_by_flag"],
+                reasons: [
+                    ...baseReasons,
+                    config_1.FEATURE_ASSISTANT_CAPABILITY_ROUTE_GUARD_V1 ? "capability_route_guard_blocked" : "capability_route_guard_skipped"
+                ],
+                capabilityAudit,
+                shadowRouteAudit
+            });
+        }
         const composeOptionsFromFilters = (filterSet) => ({
             userMessage,
             periodFrom: typeof filterSet.period_from === "string" ? filterSet.period_from : undefined,
@@ -1515,7 +1587,9 @@ class AddressQueryService {
                 reasonText: "сценарий пока вне поддерживаемого контура текущего адресного режима",
                 nextStep: "могу проверить близкие сценарии: документы/платежи по контрагенту, договоры или остаток по счету",
                 limitations: ["intent_not_supported_in_v1"],
-                reasons: baseReasons
+                reasons: baseReasons,
+                capabilityAudit,
+                shadowRouteAudit
             });
         }
         if (recipeSelection.selected_recipe === null) {
@@ -1534,7 +1608,9 @@ class AddressQueryService {
                 reasonText: "для этого сценария пока нет готового шаблона выборки в текущем режиме",
                 nextStep: "можно выбрать близкий поддерживаемый сценарий или переключить запрос в режим расширенной проверки",
                 limitations: ["recipe_not_available"],
-                reasons: [...baseReasons, ...recipeSelection.selection_reason]
+                reasons: [...baseReasons, ...recipeSelection.selection_reason],
+                capabilityAudit,
+                shadowRouteAudit
             });
         }
         if (recipeSelection.missing_required_filters.length > 0) {
@@ -1553,7 +1629,9 @@ class AddressQueryService {
                 reasonText: "не хватает обязательных фильтров",
                 nextStep: `уточните: ${recipeSelection.missing_required_filters.join(", ")}`,
                 limitations: ["missing_required_filters"],
-                reasons: [...baseReasons, ...recipeSelection.selection_reason]
+                reasons: [...baseReasons, ...recipeSelection.selection_reason],
+                capabilityAudit,
+                shadowRouteAudit
             });
         }
         if (!config_1.FEATURE_ASSISTANT_ADDRESS_QUERY_LIVE_V1) {
@@ -1572,7 +1650,9 @@ class AddressQueryService {
                 reasonText: "live address lane выключен feature-флагом",
                 nextStep: "включите FEATURE_ASSISTANT_ADDRESS_QUERY_LIVE_V1",
                 limitations: ["address_live_lane_disabled"],
-                reasons: baseReasons
+                reasons: baseReasons,
+                capabilityAudit,
+                shadowRouteAudit
             });
         }
         const rawCounterpartyAnchor = typeof filters.extracted_filters.counterparty === "string" ? filters.extracted_filters.counterparty.trim() : "";
@@ -1695,7 +1775,9 @@ class AddressQueryService {
                 reasonText: "live MCP вызов завершился ошибкой",
                 nextStep: mcp.error,
                 limitations: ["mcp_call_failed"],
-                reasons: [...baseReasons, mcp.error]
+                reasons: [...baseReasons, mcp.error],
+                capabilityAudit,
+                shadowRouteAudit
             });
         }
         const normalizedRawRows = toNormalizedRows(mcp.raw_rows);
@@ -2356,7 +2438,9 @@ class AddressQueryService {
                 reasonText,
                 nextStep,
                 limitations,
-                reasons: baseReasons
+                reasons: baseReasons,
+                capabilityAudit,
+                shadowRouteAudit
             });
         }
         const factual = (0, composeStage_1.composeFactualReply)(intent.intent, filteredRows, composeOptionsFromFilters(executionFilters));
@@ -2394,7 +2478,9 @@ class AddressQueryService {
                 reasonText: "exact payables mode: confirmed balance was not proven for the requested as-of slice",
                 nextStep: "specify as_of_date/counterparty or enable detailed settlement registers for exact confirmed balance",
                 limitations: ["exact_payables_mode_unconfirmed_output_blocked"],
-                reasons: [...baseReasons, "exact_payables_mode_unconfirmed_output_blocked"]
+                reasons: [...baseReasons, "exact_payables_mode_unconfirmed_output_blocked"],
+                capabilityAudit,
+                shadowRouteAudit
             });
         }
         return {
@@ -2439,6 +2525,14 @@ class AddressQueryService {
                 runtime_readiness: "LIVE_QUERYABLE_WITH_LIMITS",
                 limited_reason_category: null,
                 response_type: factual.responseType,
+                capability_id: capabilityAudit.capabilityId,
+                capability_layer: capabilityAudit.layer,
+                capability_route_mode: capabilityAudit.routeMode,
+                capability_route_enabled: capabilityAudit.enabled,
+                capability_route_reason: capabilityAudit.reason,
+                shadow_route_intent: shadowRouteAudit.intent,
+                shadow_route_selected_recipe: shadowRouteAudit.selectedRecipe,
+                shadow_route_status: shadowRouteAudit.status,
                 ...factualResultSemantics,
                 limitations: filters.warnings,
                 reasons: withConfirmedBalanceFallbackReason(baseReasons, requestedResultMode, factual.semantics, factualResultSemantics.result_mode)

llm_normalizer/backend/dist/services/assistantService.js

@@ -1465,6 +1465,14 @@ function buildAddressDebugPayload(addressDebug, llmPreDecomposeMeta = null) {
         evidence_strength: addressDebug.evidence_strength ?? undefined,
         balance_confirmed: typeof addressDebug.balance_confirmed === "boolean" ? addressDebug.balance_confirmed : undefined,
         as_of_date_basis: addressDebug.as_of_date_basis ?? undefined,
+        capability_id: addressDebug.capability_id ?? undefined,
+        capability_layer: addressDebug.capability_layer ?? undefined,
+        capability_route_mode: addressDebug.capability_route_mode ?? undefined,
+        capability_route_enabled: typeof addressDebug.capability_route_enabled === "boolean" ? addressDebug.capability_route_enabled : undefined,
+        capability_route_reason: addressDebug.capability_route_reason ?? undefined,
+        shadow_route_intent: addressDebug.shadow_route_intent ?? undefined,
+        shadow_route_selected_recipe: addressDebug.shadow_route_selected_recipe ?? undefined,
+        shadow_route_status: addressDebug.shadow_route_status ?? undefined,
         execution_lane: "address_query",
         llm_decomposition_applied: Boolean(llmMeta?.applied),
         llm_decomposition_attempted: Boolean(llmMeta?.attempted),

llm_normalizer/backend/dist/services/assistantSessionLogger.js

@@ -184,6 +184,7 @@ class AssistantSessionLogger {
                 trace_ids: traceIds,
                 reply_types: replyTypes,
                 investigation_state: session.investigation_state,
+                address_navigation_state: session.address_navigation_state,
                 turns,
                 conversation: session.items,
                 last_assistant: {

llm_normalizer/backend/dist/services/assistantSessionStore.js

@@ -4,6 +4,7 @@ exports.AssistantSessionStore = void 0;
 const nanoid_1 = require("nanoid");
 const config_1 = require("../config");
 const investigationState_1 = require("./investigationState");
+const addressNavigationState_1 = require("./addressNavigationState");
 const MAX_ITEMS_PER_SESSION = 200;
 function cloneItem(item) {
     return {
@@ -16,7 +17,8 @@ function cloneSession(state) {
         session_id: state.session_id,
         updated_at: state.updated_at,
         items: state.items.map(cloneItem),
-        investigation_state: (0, investigationState_1.cloneInvestigationState)(state.investigation_state)
+        investigation_state: (0, investigationState_1.cloneInvestigationState)(state.investigation_state),
+        address_navigation_state: (0, addressNavigationState_1.cloneAddressNavigationState)(state.address_navigation_state)
     };
 }
 function normalizeSessionShape(state) {
@@ -25,9 +27,13 @@ function normalizeSessionShape(state) {
     const investigationState = config_1.FEATURE_ASSISTANT_INVESTIGATION_STATE_V1
         ? legacy.investigation_state ?? (0, investigationState_1.createEmptyInvestigationState)(state.session_id)
         : legacy.investigation_state ?? null;
+    const addressNavigationState = config_1.FEATURE_ASSISTANT_ADDRESS_NAVIGATION_STATE_V1
+        ? (0, addressNavigationState_1.normalizeAddressNavigationState)(legacy.address_navigation_state ?? (0, addressNavigationState_1.createEmptyAddressNavigationState)(state.session_id), state.session_id)
+        : legacy.address_navigation_state ?? null;
     state.items = normalizedItems;
     state.updated_at = typeof legacy.updated_at === "string" && legacy.updated_at.trim() ? legacy.updated_at : new Date().toISOString();
     state.investigation_state = investigationState;
+    state.address_navigation_state = addressNavigationState;
     return state;
 }
 class AssistantSessionStore {
@@ -42,7 +48,8 @@ class AssistantSessionStore {
             session_id: resolvedId,
             updated_at: new Date().toISOString(),
             items: [],
-            investigation_state: config_1.FEATURE_ASSISTANT_INVESTIGATION_STATE_V1 ? (0, investigationState_1.createEmptyInvestigationState)(resolvedId) : null
+            investigation_state: config_1.FEATURE_ASSISTANT_INVESTIGATION_STATE_V1 ? (0, investigationState_1.createEmptyInvestigationState)(resolvedId) : null,
+            address_navigation_state: config_1.FEATURE_ASSISTANT_ADDRESS_NAVIGATION_STATE_V1 ? (0, addressNavigationState_1.createEmptyAddressNavigationState)(resolvedId) : null
         };
         this.sessions.set(resolvedId, created);
         return cloneSession(created);
@@ -53,6 +60,10 @@ class AssistantSessionStore {
         if (session.items.length > MAX_ITEMS_PER_SESSION) {
             session.items = session.items.slice(session.items.length - MAX_ITEMS_PER_SESSION);
         }
+        if (config_1.FEATURE_ASSISTANT_ADDRESS_NAVIGATION_STATE_V1) {
+            const baseNavigationState = (0, addressNavigationState_1.normalizeAddressNavigationState)(session.address_navigation_state, sessionId);
+            session.address_navigation_state = (0, addressNavigationState_1.evolveAddressNavigationStateWithAssistantItem)(baseNavigationState, item, Math.max(0, session.items.length - 1));
+        }
         session.updated_at = new Date().toISOString();
         return cloneItem(item);
     }
@@ -66,6 +77,23 @@ class AssistantSessionStore {
         session.updated_at = new Date().toISOString();
         return (0, investigationState_1.cloneInvestigationState)(session.investigation_state);
     }
+    getAddressNavigationState(sessionId) {
+        const session = this.ensureMutableSession(sessionId);
+        if (!config_1.FEATURE_ASSISTANT_ADDRESS_NAVIGATION_STATE_V1) {
+            return null;
+        }
+        return (0, addressNavigationState_1.cloneAddressNavigationState)(session.address_navigation_state);
+    }
+    setAddressNavigationState(sessionId, state) {
+        const session = this.ensureMutableSession(sessionId);
+        if (!config_1.FEATURE_ASSISTANT_ADDRESS_NAVIGATION_STATE_V1) {
+            session.address_navigation_state = null;
+            return null;
+        }
+        session.address_navigation_state = (0, addressNavigationState_1.normalizeAddressNavigationState)(state, sessionId);
+        session.updated_at = new Date().toISOString();
+        return (0, addressNavigationState_1.cloneAddressNavigationState)(session.address_navigation_state);
+    }
     ensureMutableSession(sessionId) {
         const existing = this.sessions.get(sessionId);
         if (existing) {
@@ -75,7 +103,8 @@ class AssistantSessionStore {
             session_id: sessionId,
             updated_at: new Date().toISOString(),
             items: [],
-            investigation_state: config_1.FEATURE_ASSISTANT_INVESTIGATION_STATE_V1 ? (0, investigationState_1.createEmptyInvestigationState)(sessionId) : null
+            investigation_state: config_1.FEATURE_ASSISTANT_INVESTIGATION_STATE_V1 ? (0, investigationState_1.createEmptyInvestigationState)(sessionId) : null,
+            address_navigation_state: config_1.FEATURE_ASSISTANT_ADDRESS_NAVIGATION_STATE_V1 ? (0, addressNavigationState_1.createEmptyAddressNavigationState)(sessionId) : null
         };
         this.sessions.set(sessionId, created);
         return created;