Add an Iceberg REST Catalog front door

AGENTS.md

@@ -84,6 +84,7 @@ scripts/run-real-installation-smoke-simple.sh --env-file smoke-stand/env/simple.
 - Знание о служебном плейсхолдере Hive (`_dummy_database`/`_dummy_table`, константы `SemanticAnalyzer.DUMMY_DATABASE`/`DUMMY_TABLE`, которые Hive шлёт в `LockRequest` для `INSERT ... VALUES`) живёт только в `routing/HivePlaceholderNamespace`. Плейсхолдер не выбирает каталог, не считается вторым namespace lock-запроса и не переписывается интернализацией в реальную backend-базу. Не добавляй локальных сравнений с `_dummy_database` в других классах.
 - Для RPC, у которых Hive IDL не объявляет исключений (`add_write_notification_log`, `open_txns`, `show_locks` и другие: у их `<method>_result` есть только поле `success`), libthrift 0.9.3 подменяет любое серверное исключение на `TApplicationException("Internal error processing <method>")`. Текст отказа таких методов виден только в логе - не рассчитывай, что его получит клиент, и не проверяй его в smoke-скриптах. Настоящий HMS теряет свои тексты ошибок так же.
 - Классификация backend Thrift-ошибок живёт только в `thriftbridge/ThriftFailureClassifier`: «метода нет» - это `TApplicationException` с типом `UNKNOWN_METHOD` (или отсутствие метода в загруженном runtime), transport failure и protocol desync - отдельные категории. Не пиши локальные `instanceof TApplicationException` для решений про fallback, downgrade или переоткрытие соединения.
+- `restcatalog` - Iceberg REST front door поверх routing-слоя: per-catalog сервисы работают через in-process прокси `IMetaStoreClient`; для не-default каталогов включён name translation, чтобы клиент видел внутренние имена баз этого каталога. Write-запросы к таблицам, view (create/update/drop/rename), namespace DDL (create/update/drop) и multi-table transaction commit поддержаны, но только когда namespace резолвится в `routing.default-catalog` - только его таблицы подкреплены реальным HMS-локом, остальные каталоги обслуживает synthetic lock shim без проверки конфликтов. `WriteRouteGate` проверяет резолвленный каталог, а не prefix запроса, поэтому federated-имя под default-prefix отказывается так же, как прямой запрос к non-default prefix; `GET /v1/config` объявляет всю эту асимметрию в `endpoints` - default-каталог видит все тринадцать write-маршрутов, что WriteRouteGate проверяет, остальные каталоги видят только чтение. Не добавляй локальных проверок "разрешён ли write" в других классах - весь gate живёт в `WriteRouteGate`. Каждый `IcebergRestService` получает per-catalog Hadoop `Configuration` через `IcebergRestServices.open(..., hadoopConfForCatalog)`, которая в проде резолвится в `router.requireBackend(catalog).hiveConf()` - тот же объект, что уже несёт `fs.defaultFS`/Kerberos-настройки catalog.<name>.conf.* для Thrift-пути. Не заводи для REST-пути отдельную голую `new Configuration()`: под Kerberos это провалит запись в HDFS ("Failed to specify server's Kerberos principal name"), потому что namenode-принципал у каждого каталога свой и известен только через его собственный conf.
 
 ## Парсинг конфигурации
 
@@ -98,8 +99,9 @@ scripts/run-real-installation-smoke-simple.sh --env-file smoke-stand/env/simple.
 - Держи изменения узко сфокусированными. Пути routing, security, compatibility и class-loading чувствительны для production.
 - Предпочитай deterministic routing и явные safe failures вместо догадок, когда catalog ownership или namespace context неоднозначны.
 - Сохраняй совместимость с Java 17. Не добавляй требования к более новым версиям языка или runtime.
-- Не добавляй новые зависимости без реальной необходимости; Hive/Hadoop dependency convergence хрупкий.
+- Не добавляй новые зависимости без реальной необходимости; Hive/Hadoop dependency convergence хрупкий. `hadoop-hdfs` и `hadoop-common` обязаны быть одной версии: Maven их не сравнивает (разные artifact ID), а рассинхрон ломает `DFSOutputStream` (`NoSuchMethodError: FSOutputSummer.<init>`) при любой записи в HDFS изнутри JVM прокси - `pom.xml` явно исключает транзитивный `hadoop-hdfs` из `orc-core` и держит `hadoop-hdfs:2.6.0` напрямую, чтобы совпасть с `hadoop-common`. Проверяй `mvn -o dependency:tree | grep -iE "hadoop-hdfs|hadoop-common"` при трогании этих зависимостей.
 - Логирование: slf4j-api и binding `slf4j-reload4j` держи на одной версии `${slf4j.version}`. `org.apache.log4j` должен приходить только из reload4j, поэтому `log4j:log4j` исключён во всех зависимостях, которые его тянут (обе Hive-зависимости, `hadoop-mapreduce-client-core`, `curator-test`). Добавляя зависимость, проверь `mvn -o dependency:tree | grep log4j`: второй провайдер этого пакета даст в fat jar классы, выбранные shade-плагином произвольно.
+- `hadoop-hdfs` тянет `xerces:xercesImpl`/`xml-apis` (нужны только offline-вьюеру image/edits, не рантайм-пути `DFSClient`, который использует этот прокси) - оба исключены в блоке `hadoop-hdfs` в `pom.xml`. `xercesImpl` несёт `META-INF/services/javax.xml.parsers.*`, что в shaded fat jar делает 2007-летний парсер (с известными CVE) JVM-wide JAXP-провайдером для каждого `DocumentBuilderFactory`/`SAXParserFactory` в процессе, включая Hadoop `Configuration` и парсинг hive-site - и тихо вытесняет парсер JDK. Добавляя зависимость, проверь `mvn -o dependency:tree | grep -iE "xerces|xml-apis"`.
 - Комментарии оставляй короткими и только там, где они объясняют неочевидное compatibility, security, routing или class-loading поведение.
 - Не форматируй несвязанные файлы и не меняй generated docs, если твоя задача не требует их обновления.