houseplan-card/docs/specs/006-vacuum-xcme-path.md

# ТЗ #6 — XCME: многосегментный путь без ложных перемычек

- Issue: https://github.com/Matysh/houseplan-card/issues/6
- Приоритет: P1
- Статус ТЗ: реализовано по HP-VAC-02 rev.7; целевой gate v1.61.0-beta.1 пройден, ожидается публикация
- Родительский контракт: `docs/superpowers/specs/2026-08-09-vacuum-integration-coverage-design.md`, §4.1

## Цель

Корректно принимать Xiaomi Cloud Map Extractor `attributes.path.path` как набор
независимых траекторий. Разрыв между подмаршрутами не должен превращаться в
нарисованный переезд робота.

## Требования

1. Канонический тип frontend — `VacPath = Pt[][]`, где каждая внутренняя
   последовательность является отдельным drawable subpath.
2. Парсер принимает плоский legacy path, `path.points` и `path.path`.
3. Невалидные точки отбрасываются; subpath короче двух валидных точек не
   участвует в отображении и арбитраже источников.
4. Сначала фильтруются недорисовываемые сегменты, затем остаются последние 64.
5. Общий бюджет — 4000 точек. У каждого subpath сохраняются обе крайние точки;
   остаток распределяется largest-remainder, при равенстве выигрывает более
   старый из оставшихся subpath.
6. Рендер формирует один SVG `path` с отдельной командой `M` на каждый subpath,
   без `L` между ними.
7. Один resolver выбирает drawable integration path, затем server trail, затем
   локальный runtime trail. Пустой/одноточечный integration path не блокирует
   следующий источник.
8. При скрытии terminal target изменяется только последний drawable subpath.

## Совместимость и ограничения

- Сохранённый server trail и формат backend не мигрируют.
- Dreame/Valetudo integration path не заявляется без подтверждённого формата.
- Никаких CSS-фильтров или соединительных пунктирных линий между subpath.

## Проверки

- unit: все поддерживаемые формы, невалидные точки, cap после фильтрации;
- unit: точный бюджет, сохранение концов и old→new tie-break;
- unit: drawable arbitration и обрезка последнего target;
- browser: несколько `M`, отсутствие моста между удалёнными сегментами;
- performance: 64/4000 остаются в текущем render budget.

## Приёмка

- XCME history виден полностью в пределах бюджета;
- визуальных перемычек между разрывами нет;
- fallback trail появляется, если integration path не рисуем;
- flat legacy path выглядит как до изменения.