Client 1.0: двомовний каталог і canonical CLI / bilingual catalog and canonical CLI

.github/workflows/ci.yml

@@ -19,4 +19,4 @@ jobs:
           cache: pip
       - run: python -m pip install --requirement requirements.lock
       - run: python -m unittest discover -s tests -v
-      - run: python scripts/validate_registry.py
+      - run: python scripts/validate_catalog.py

CATALOG.md

@@ -1,6 +1,8 @@
 <!-- GENERATED by scripts/catalog_admin.py; DO NOT EDIT. -->
 # Public iVINS MAV dataset catalog
 
+[Українська версія](CATALOG.uk.md)
+
 Dataset Server schema: `1.0`  
 Snapshot: `49d1190e971b8b778cab209c2b1632c42b509a72394960ec7081b6de7dd09343`
 

CATALOG.uk.md

@@ -0,0 +1,11 @@
+<!-- GENERATED by scripts/catalog_admin.py; DO NOT EDIT. -->
+# Публічний каталог наборів даних iVINS MAV
+
+[English version](CATALOG.md)
+
+Схема DataSetsManager Server: `1.0`  
+Snapshot: `49d1190e971b8b778cab209c2b1632c42b509a72394960ec7081b6de7dd09343`
+
+| Dataset | Опис | Опубліковані артефакти |
+|---|---|---|
+| [iVINS Dev 4 Flight Field 01](generated/datasets/iv.dev.4.ff.1.uk.md) | Flight-field recording captured with the iVINS dev_04 hardware profile. | rosbag v1 (17 байтів) |

README.md

@@ -25,7 +25,7 @@ importer. `--check` is read-only and exits nonzero when they are stale.
 
 Fetched payloads live below
 `datasets/<family>/artifacts/<stable-id>/<format>/` and are narrowly ignored by
-Git. This replaces the former sibling `../iVINS-mav-dataset-raw` default;
+Git. This replaces the former raw-data sibling-checkout default;
 `--raw-root` remains an expert/test migration override.
 
 Publication requires `DSM_SERVER_TOKEN`:
@@ -160,7 +160,7 @@ proof of validated runtime compatibility.
 |---|---|---:|---|---|---|---|
 | Not assigned | `dev_01` | Not yet registered | Not yet registered | Not yet registered | Declared in [`manifest.yaml`](datasets/ivins/dev_01/manifest.yaml) when available | [OpenVINS](configurations/ivins/OpenVINS/dev_01), [VINS-Mono](configurations/ivins/VINS-Mono/dev_01), [VINS-Fusion](configurations/ivins/VINS-Fusion/dev_01), [VINS-NEO](configurations/ivins/VINS-NEO/dev_01) |
 | Not assigned | `dev_02`, `dev_03`, `prod`, `future-products` | Not yet registered | Not yet registered | Not yet registered | Declared per [profile manifest](datasets/ivins) | [OpenVINS](configurations/ivins/OpenVINS), [VINS-Mono](configurations/ivins/VINS-Mono), [VINS-Fusion](configurations/ivins/VINS-Fusion), [VINS-NEO](configurations/ivins/VINS-NEO) |
-| `iv.dev.4.ff.1` | `dev_4_flight_field_01` | Unknown | Registry: local import, not a public download. An authenticated LAN server has the artifact under this standard ID. The [OneDrive share](https://1drv.ms/u/c/43b02ab6ed7aabf6/IQDBuTo3UtHXSof4k6cDPAWiAaR3vkQkJit8j5QlpO7ZRP0?e=7Xa9pH) is provenance only; see the [raw catalog guide](docs/raw-data-catalog.md) | Registry: not published. The authenticated LAN server has a locally derived artifact | Not provided | [dev_04 profile catalog](configurations/ivins/profiles/dev_04/README.md) (canonical profile; legacy aliases are declared in `config/profile-aliases.yaml`) |
+| `iv.dev.4.ff.1` | `dev_4_flight_field_01` | Unknown | Catalog: local import, not a public download. An authenticated LAN server has the artifact under this standard ID. The [OneDrive share](https://1drv.ms/u/c/43b02ab6ed7aabf6/IQDBuTo3UtHXSof4k6cDPAWiAaR3vkQkJit8j5QlpO7ZRP0?e=7Xa9pH) is provenance only; see the [raw catalog guide](docs/raw-data-catalog.md) | Catalog: not published. The authenticated LAN server has a locally derived artifact | Not provided | [dev_04 profile catalog](configurations/ivins/profiles/dev_04/README.md) (canonical profile; legacy aliases are declared in `config/profile-aliases.yaml`) |
 
 ### iCU
 
@@ -211,8 +211,10 @@ calibration reports may be committed with their run metadata. Before adding any
 large binary artifact, define and review a Git LFS tracking rule in
 `.gitattributes`; do not commit large binaries first and migrate them later.
 
-Run `python scripts/validate_registry.py` to check manifest YAML and expected
-catalog structure. The validator requires PyYAML (`python -m pip install pyyaml`).
+Run `python scripts/validate_catalog.py` or `dsm-client validate` to check
+manifest YAML and expected catalog structure. The validator requires PyYAML
+(`python -m pip install pyyaml`). The former `validate_registry.py` entrypoint
+is a deprecated compatibility wrapper through Client 1.x.
 
 Use [`scripts/raw_catalog.py`](scripts/raw_catalog.py) to fetch, publish,
 resolve, and inspect server artifacts in the ignored repository hierarchy. See the

README.uk.md

@@ -137,7 +137,7 @@ dsm-client validate
 |---|---|---:|---|---|---|---|
 | Не призначено | `dev_01` | Ще не зареєстровано | Ще не зареєстровано | Ще не зареєстровано | Буде оголошено в [`manifest.yaml`](datasets/ivins/dev_01/manifest.yaml), коли стане доступним | [OpenVINS](configurations/ivins/OpenVINS/dev_01), [VINS-Mono](configurations/ivins/VINS-Mono/dev_01), [VINS-Fusion](configurations/ivins/VINS-Fusion/dev_01), [VINS-NEO](configurations/ivins/VINS-NEO/dev_01) |
 | Не призначено | `dev_02`, `dev_03`, `prod`, `future-products` | Ще не зареєстровано | Ще не зареєстровано | Ще не зареєстровано | Оголошується у [маніфесті профілю](datasets/ivins) | [OpenVINS](configurations/ivins/OpenVINS), [VINS-Mono](configurations/ivins/VINS-Mono), [VINS-Fusion](configurations/ivins/VINS-Fusion), [VINS-NEO](configurations/ivins/VINS-NEO) |
-| `iv.dev.4.ff.1` | `dev_4_flight_field_01` | Невідомо | Каталог: локальне імпортування, не публічне завантаження. Артефакт доступний на автентифікованому LAN-сервері за цим стандартним ID. [Спільний файл OneDrive](https://1drv.ms/u/c/43b02ab6ed7aabf6/IQDBuTo3UtHXSof4k6cDPAWiAaR3vkQkJit8j5QlpO7ZRP0?e=7Xa9pH) вказує лише походження; див. [інструкцію raw catalog](docs/raw-data-catalog.md) | Каталог: не опубліковано. На автентифікованому LAN-сервері є локально отриманий конвертуванням артефакт | Не надано | [Каталог профілю dev_04](configurations/ivins/profiles/dev_04/README.md) (відповідність застарілій назві `dev_04` очікує підтвердження) |
+| `iv.dev.4.ff.1` | `dev_4_flight_field_01` | Невідомо | Каталог: локальне імпортування, не публічне завантаження. Артефакт доступний на автентифікованому LAN-сервері за цим стандартним ID. [Спільний файл OneDrive](https://1drv.ms/u/c/43b02ab6ed7aabf6/IQDBuTo3UtHXSof4k6cDPAWiAaR3vkQkJit8j5QlpO7ZRP0?e=7Xa9pH) вказує лише походження; див. [інструкцію raw catalog](docs/raw-data-catalog.uk.md) | Каталог: не опубліковано. На автентифікованому LAN-сервері є локально отриманий конвертуванням артефакт | Не надано | [Каталог профілю dev_04](configurations/ivins/profiles/dev_04/README.uk.md) (канонічний профіль; застарілі псевдоніми оголошені в `config/profile-aliases.yaml`) |
 
 ### iCU
 
@@ -188,9 +188,10 @@ dsm-client validate
 Перед додаванням великого двійкового артефакту визначте й перевірте правило Git LFS
 у `.gitattributes`; не додавайте великі файли до звичайної історії Git.
 
-Запустіть `python scripts/validate_registry.py`, щоб перевірити YAML-маніфести та
-очікувану структуру каталогу. Валідатор потребує PyYAML
-(`python -m pip install pyyaml`).
+Запустіть `python scripts/validate_catalog.py` або `dsm-client validate`, щоб
+перевірити YAML-маніфести й очікувану структуру каталогу. Валідатор потребує
+PyYAML (`python -m pip install pyyaml`). Старий entrypoint
+`validate_registry.py` залишається deprecated wrapper протягом Client 1.x.
 
 Використовуйте [`scripts/raw_catalog.py`](scripts/raw_catalog.py) для ініціалізації,
 отримання, визначення шляхів і перевірки зовнішніх даних ROS у сусідньому каталозі

calibration-reports/ivins/dev_01/README.md

@@ -1,5 +1,7 @@
 # iVINS dev_01 calibration report catalog
 
+[Українська версія](README.uk.md)
+
 Status: Not available yet.
 
 The repository has canonical `dev_01` Kalibr chain templates, but no completed

calibration-reports/ivins/dev_01/README.uk.md

@@ -0,0 +1,9 @@
+# Каталог звітів калібрування iVINS dev_01
+
+[English version](README.md)
+
+Статус: поки недоступний.
+
+Репозиторій містить канонічні шаблони Kalibr chain для `dev_01`, але жодний
+завершений звіт калібрування не підтверджено. Колишнє значення `dev_0` є
+псевдонімом. Дивіться [каталог конфігурацій профілю](../../../configurations/ivins/profiles/dev_01/README.uk.md).

calibration-reports/ivins/dev_02/README.md

@@ -1,5 +1,7 @@
 # iVINS dev_02 calibration report catalog
 
+[Українська версія](README.uk.md)
+
 Status: Not available yet.
 
 No calibration report is currently registered for displayed profile `dev_02`.

calibration-reports/ivins/dev_02/README.uk.md

@@ -0,0 +1,9 @@
+# Каталог звітів калібрування iVINS dev_02
+
+[English version](README.md)
+
+Статус: поки недоступний.
+
+Для відображуваного профілю `dev_02` не зареєстровано звітів калібрування.
+Колишній placeholder `dev_2` зіставляється з канонічним `dev_02`. Дивіться
+[каталог конфігурацій профілю](../../../configurations/ivins/profiles/dev_02/README.uk.md).

calibration-reports/ivins/dev_03/README.md

@@ -1,5 +1,7 @@
 # iVINS dev_03 calibration report catalog
 
+[Українська версія](README.uk.md)
+
 Status: Not available yet.
 
 No calibration report is currently registered for displayed profile `dev_03`.

calibration-reports/ivins/dev_03/README.uk.md

@@ -0,0 +1,9 @@
+# Каталог звітів калібрування iVINS dev_03
+
+[English version](README.md)
+
+Статус: поки недоступний.
+
+Для відображуваного профілю `dev_03` не зареєстровано звітів калібрування.
+Колишній placeholder `dev_3` зіставляється з канонічним `dev_03`. Дивіться
+[каталог конфігурацій профілю](../../../configurations/ivins/profiles/dev_03/README.uk.md).

calibration-reports/ivins/dev_04/README.md

@@ -1,5 +1,7 @@
 # iVINS dev_04 calibration report catalog
 
+[Українська версія](README.uk.md)
+
 [Back to the repository catalog](../../../README.md) ·
 [Profile configuration catalog](../../../configurations/ivins/profiles/dev_04/README.md)
 

calibration-reports/ivins/dev_04/README.uk.md

@@ -0,0 +1,19 @@
+# Каталог звітів калібрування iVINS dev_04
+
+[English version](README.md)
+
+[До каталогу репозиторію](../../../README.uk.md) ·
+[Каталог конфігурацій профілю](../../../configurations/ivins/profiles/dev_04/README.uk.md)
+
+Статус: candidate-результати Kalibr існують у канонічному профілі `dev_04`.
+
+- [Політика й каталог артефактів Kalibr dev_04](../../../configurations/ivins/kalibr/dev_04/README.uk.md)
+- [Provenance Kalibr try1](../../../configurations/ivins/kalibr/dev_04/try1/README.uk.md)
+- [Результат camera chain](../../../configurations/ivins/kalibr/dev_04/try1/data-camchain.yaml)
+- [Результат camera-IMU chain](../../../configurations/ivins/kalibr/dev_04/try1/data-camchain-imucam.yaml)
+- [Результат калібрування IMU](../../../configurations/ivins/kalibr/dev_04/try1/data-imu.yaml)
+- [Звіт калібрування camera-IMU](../../../configurations/ivins/kalibr/dev_04/try1/data-report-imucam.pdf)
+- [Журнал результату калібрування camera-IMU](../../../configurations/ivins/kalibr/dev_04/try1/data-results-imucam.txt)
+
+Колишній шлях Kalibr `dev4` представлений канонічним `dev_04`; старе значення
+залишається псевдонімом протягом Client 1.x.

configurations/ivins/kalibr/dev_04/README.md

@@ -1,5 +1,7 @@
 # Kalibr outputs for iVINS dev_04
 
+[Українська версія](README.uk.md)
+
 This directory is reserved for calibration artifacts generated for the iVINS
 `dev_04` profile by [ethz-asl/kalibr](https://github.com/ethz-asl/kalibr).
 

configurations/ivins/kalibr/dev_04/README.uk.md

@@ -0,0 +1,22 @@
+# Результати Kalibr для iVINS dev_04
+
+[English version](README.md)
+
+Цей каталог зарезервовано для calibration artifacts, створених для профілю
+iVINS `dev_04` через [ethz-asl/kalibr](https://github.com/ethz-asl/kalibr).
+
+Типові результати:
+
+- `camchain.yaml` — camera intrinsics, distortion і camera chain;
+- `imu.yaml` — параметри шуму відкаліброваного IMU;
+- `imucam.yaml` — калібрування camera-to-IMU і time alignment;
+- `report.pdf` — створений звіт калібрування;
+- журнали для відстеження команди, inputs, diagnostics і результату запуску.
+
+Додавайте лише справжні результати фактичного Kalibr run для відповідного
+обладнання й записів `dev_04`. Не вигадуйте, не оцінюйте й не копіюйте значення
+з іншого пристрою чи профілю. Зберігайте metadata, достатні для traceability і
+review кожного артефакту.
+
+Kalibr artifacts зберігають явно зарезервований шлях `dev_04`. Конфігурації VINS
+використовують `dev_04` відповідно до convention `dev_01`, `dev_02`, `dev_03`.

configurations/ivins/kalibr/dev_04/try1/README.md

@@ -1,5 +1,7 @@
 # Kalibr outputs for iVINS dev_04
 
+[Українська версія](README.uk.md)
+
 This directory is reserved for calibration artifacts generated for the iVINS
 `dev_04` profile by [ethz-asl/kalibr](https://github.com/ethz-asl/kalibr).
 

configurations/ivins/kalibr/dev_04/try1/README.uk.md

@@ -0,0 +1,15 @@
+# Результати Kalibr для iVINS dev_04 — try1
+
+[English version](README.md)
+
+Цей каталог містить calibration artifacts, створені для профілю iVINS
+`dev_04` через [ethz-asl/kalibr](https://github.com/ethz-asl/kalibr).
+
+Типові outputs: `camchain.yaml` для camera intrinsics, distortion і chain;
+`imu.yaml` для IMU noise; `imucam.yaml` для camera-to-IMU calibration та time
+alignment; `report.pdf` і журнали provenance запуску.
+
+Додавайте лише реальні результати фактичного Kalibr run для відповідного
+обладнання та recording `dev_04`. Не вигадуйте, не оцінюйте й не копіюйте
+калібрування з іншого пристрою або профілю. Зберігайте inputs, command,
+diagnostics і result, достатні для перевірки кожного артефакту.

configurations/ivins/profiles/dev_01/README.md

@@ -1,5 +1,7 @@
 # iVINS dev_01 configuration catalog
 
+[Українська версія](README.uk.md)
+
 Status: Not available yet as a confirmed `dev_01` configuration set.
 
 The repository contains canonical `dev_01` OpenVINS templates:

configurations/ivins/profiles/dev_01/README.uk.md

@@ -0,0 +1,16 @@
+# Каталог конфігурацій iVINS dev_01
+
+[English version](README.md)
+
+Статус: підтверджений набір конфігурацій `dev_01` поки недоступний.
+
+Репозиторій містить канонічні OpenVINS templates `dev_01`:
+
+- [Шаблон estimator configuration](../../OpenVINS/dev_01/estimator_config.yaml)
+- [Шаблон Kalibr IMU chain](../../OpenVINS/dev_01/kalibr_imu_chain.yaml)
+- [Шаблон Kalibr IMU-camera chain](../../OpenVINS/dev_01/kalibr_imucam_chain.yaml)
+
+Колишня назва `dev_0` — compatibility alias канонічного `dev_01`. Посилання є
+інвентарем; templates усе ще потребують runtime validation.
+
+Дивіться [шаблон конфігурації обладнання](equipment-configuration.uk.md).

configurations/ivins/profiles/dev_01/equipment-configuration.md

@@ -1,5 +1,7 @@
 # iVINS dev_01 equipment configuration
 
+[Українська версія](equipment-configuration.uk.md)
+
 ## Profile identity and status
 
 - Displayed profile: `dev_01`

configurations/ivins/profiles/dev_01/equipment-configuration.uk.md

@@ -0,0 +1,55 @@
+# Конфігурація обладнання iVINS dev_01
+
+[English version](equipment-configuration.md)
+
+## Ідентичність і статус профілю
+
+- Відображуваний профіль: `dev_01`
+- Статус: TODO — не вказано
+- Зв'язок із legacy-назвами: TODO — зіставлення очікує підтвердження
+
+## Транспортний засіб і платформа
+
+- Vehicle/platform: TODO — не вказано
+- Compute platform: TODO — не вказано
+- Монтаж: TODO — не вказано
+
+## Камери
+
+- Кількість/моделі камер: TODO — не вказано
+- Об'єктив: TODO — не вказано
+- Роздільна здатність: TODO — не вказано
+- Частота кадрів: TODO — не вказано
+
+## IMU та інші сенсори
+
+- Кількість/моделі IMU: TODO — не вказано
+- Інші сенсори: TODO — не вказано
+
+## Час і системи координат
+
+- Метод синхронізації: TODO — не вказано
+- Джерело/convention timestamp: TODO — не вказано
+- Coordinate frames і transforms: TODO — не вказано
+
+## Калібрування й ПЗ
+
+- Посилання на калібрування: TODO — не вказано; дивіться [каталог калібрувань](../../../../calibration-reports/ivins/dev_01/README.uk.md)
+- Конфігурація ПЗ: дивіться [каталог конфігурацій](README.uk.md)
+
+## Запис даних
+
+- Комп'ютер/ПЗ запису: TODO — не вказано
+- Topics, rates і формат зберігання: TODO — не вказано
+- Процедура запуску й зупинки: TODO — не вказано
+
+## Валідація та приймання
+
+- Процедура validation: TODO — не вказано
+- Критерії приймання: TODO — не вказано
+
+## Історія змін
+
+| Дата | Зміна | Автор |
+|---|---|---|
+| TODO | Початковий опис обладнання очікується | TODO |

configurations/ivins/profiles/dev_01/vins-configurations.md

@@ -1,5 +1,7 @@
 # iVINS dev_01 VINS configurations
 
+[Українська версія](vins-configurations.uk.md)
+
 Status: A canonical candidate exists; runtime validation is pending.
 
 | Implementation | Parameter Directory | Status |

configurations/ivins/profiles/dev_01/vins-configurations.uk.md

@@ -0,0 +1,12 @@
+# Конфігурації VINS для iVINS dev_01
+
+[English version](vins-configurations.md)
+
+Статус: є канонічний candidate; runtime validation очікується.
+
+| Реалізація | Каталог параметрів | Статус |
+|---|---|---|
+| OpenVINS | [Канонічний каталог параметрів `dev_01`](../../OpenVINS/dev_01/) | Очікує validation |
+
+Каталог містить наявні estimator і Kalibr chain templates для канонічного
+`dev_01`. Старе `dev_0` є compatibility alias; templates ще не пройшли runtime validation.