houseplan-card/docs/specs/310-pair-apex.md

# ТЗ #310 — Парный острый стык: полное остриё и срез выступающего торца

Issue: https://github.com/Matysh/houseplan-card/issues/310
Статус: ревизия 2 (после SPEC-REVIEW-310-r1: контракт «без дыр» для узлов-двоек — собственная сеточная проверка, детектор #302 их не видит).
База: #309 (визуальный лимит и фаска), #302 (веера, детектор дыр), #271 (адресный латеральный трим).

## 0. Сценарий

Владелец сводит две стены под острым углом (перегородки, свободные стены). На чертеже такие стены сходятся в точку — остриё легитимно. #309 ошибочно срезал остриё фаской, а настоящий дефект — маленький зубец: прямоугольный торец толстой стены выступает вбок за грань тонкой у самого узла — остался (он виден и на исходном скрине владельца при старом полном mitre, и как ступенька на грани в `junction-309-spike-dark`).

**До:** остриё срезано плоско (фаска 1.5·h), на грани у узла ступенька-зубец от торца толстой стены.
**После:** чистый клин: остриё доведено до пересечения граней, зубец срезан продолжением грани тонкой стены. Узлы ≥3 лучей не меняются.

## 1. Решения владельца (2026-08-25, чат)

1. Узел ровно двух лучей: **полный mitre без визуального лимита** — вершина на пересечении внешних граней. Фаска `VISUAL_MITRE_LIMIT` (#309) остаётся только в веерах узлов ≥3 канонических лучей.
2. **Зубец торца срезается по граням острия**: выступающая за наружную грань тонкой стены часть тела толстой в окрестности узла обрезается продолжением этой грани (столярный mitre-joint), не по биссектрисе.

## 2. Контракт

### 2.1 Парная ветка `linearWallJoinPatches`

Для узла ровно двух лучей (после мультиволл-скипа #309 в эту ветку попадают только такие) mitre-патч строится как до #309: `[node, pA, hit, pB]` при существующем `hit` — **без** проверки `VISUAL_MITRE_LIMIT` и без `chamferApex`; фолбэк `[node, pA, pB]` для параллельных/вырожденных пар сохраняется. `MITRE_LIMIT` в парной ветке не применяется (санитарная граница остаётся только в веерах, где её сопровождает фаска).

### 2.2 Срез выступающего торца (новый адресный трим)

В узле ровно двух лучей с принятым mitre для каждой стены пары строится **вычитаемый клин торца**: часть её тела, лежащая снаружи наружной грани соседа (полуплоскость грани, образующей сторону острия) и в окрестности узла — вдоль оси стены не дальше `2·halfDepth(собственной)` от узла. Практически выступ существует только у более толстой стены; правило симметрично и у тонкой даёт пустое множество. Реализация — второе адресное вычитание рядом с тримом #271 (той же фазой в потребителях), с теми же требованиями: строгая локальность, никакого влияния на тела вне окрестности узла.

Инвариант #302 AC6 обновляется: «вычитания из тела — только два адресных трима: латеральный #271 и торцевой #310»; правка фиксируется в docs/WALL-THICKNESS.md.

### 2.3 Узлы ≥3 лучей и всё остальное — не меняются

Веера с фаской 1.5·h (#309), их мутанты и сцены `junction-309-step/hump-dark`, 16 junction-сцен, owner-repro — байтово прежние. Механизм #249 (`MULTI_WALL_JOIN_LIMIT`, `multiWallBevelCutsAt`, mitre контуров комнат) не тронут. Превью цепочки использует ту же парную логику — форма превью и персиста совпадает.

## 3. Скоуп и не-скоуп

**Скоуп:** парная ветка `linearWallJoinPatches`, новый торцевой трим и его прокладка в потребителях парных патчей (`physicalBodyParts`, превью, карта), golden `junction-309-spike-dark`, юниты/мутанты, docs/WALL-THICKNESS.md.
**Не-скоуп:** веера и фаска #309, узловая карта, #249-механизм, #271-трим, модель данных, hit-зоны, снап, touch (форма кладки, слушателей нет).

## 4. UX, данные, i18n

Нет новых контролов; нет миграций и полей; нет строк i18n. Меняется только форма кладки у парных узлов на всех поверхностях (общий структурный кэш).

## 5. Риски

1. **Возврат «хвостов»**: полный mitre на почти-параллельных встречных парах формально даёт очень длинное остриё — это осознанное решение владельца (стены, сходящиеся под 5°, сходятся далеко); вырожденные пары (`hit` нет) сохраняют бевел.
2. **Новое вычитание** — дыры на границе среза. Детектор #302 узлы-двойки не видит (`buildMultiWallNodeMap` требует ≥3 лучей): гейт для пар — парный сеточный контракт из AC5; для узлов ≥3 — прежний детектор. Плюс юнит на неизменность тела вне окрестности узла.
3. **Двойной трим** (#271 + #310) в одном узле — интерференция; покрыть юнитом на коротком толстом саппорте пары.

## 6. Release-артефакты

CHANGELOG RU+EN (User-Visible: yes), docs/WALL-THICKNESS.md (§ mitre-joint пары + инвариант о двух тримах), fingerprint скриншотов, пересъёмка `junction-309-spike-dark` (`--reviewed`).

## 7. AC

1. **Остриё**: на паре 10+20 (фикстура `309-junction-teeth`) патч — полный mitre `[node, pA, hit, pB]`, вершина на пересечении граней (юнит формы; вылет больше 1.5·h — юнит доказывает отсутствие фаски).
2. **Зубец срезан**: контур узла-двойки — чистый клин; проба в прежней зоне зубца (снаружи грани тонкой, внутри прежнего тела толстой у торца) пуста (юнит по `physicalBodySet.geometry` + пересмотренная сцена `junction-309-spike-dark`).
3. **Адресность**: тело толстой стены на расстоянии > 2·halfDepth от узла байтово прежнее (юнит сравнения колец).
4. **Узлы ≥3 не тронуты**: `junction-309-step/hump-dark` и 16 junction-сцен + owner-repro байтово прежние (golden verify).
5. **Без дыр**: два гейта по типам узлов. Узлы ≥3 лучей — прежний `junctionContractHoles` (фикстура, сцены). Узлы-двойки в него не попадают по построению (`buildMultiWallNodeMap` отбрасывает узлы <3 лучей) — для них вводится **парный сеточный контракт** в юните: в квадратной окрестности узла (радиус 3·max(h), шаг ≤ h/4) точка обязана быть кладкой ⇔ она лежит в (полоса A ∪ полоса B ∪ mitre-патч) − (клинья #310); сверка с фактическим `physicalBodySet.geometry` на узле spike фикстуры `309-junction-teeth` и на синтетических парах (острая, 90°, почти-параллельная). Обоснование корректности вычитания: клин лежит строго снаружи наружной грани соседа, а полоса соседа и патч — не снаружи её, поэтому контракт достижим без дыр.
6. **90° равных толщин**: патч байтово прежний, трим пуст (юнит #309 AC4 остаётся зелёным).
7. **Мутанты**: (a) фаска возвращена в парную ветку — красный; (b) торцевой трим отключён — красный; (c) трим не ограничен окрестностью узла (режет всё тело) — красный. Гварды с типовым прологом tsc+fix-test-build.

## 8. План тестов

Юниты: пара 10+20 (остриё+зубец+адресность), 90°, почти-параллельная пара (ограничение reach и бевел-фолбэк), пара с коротким толстым саппортом (#271+#310), парный сеточный контракт (AC5) на spike-узле и синтетике, детектор #302 на фикстуре (узлы ≥3). Мутанты §7.7. Golden: пересъёмка spike-сцены, verify остальных.

## 9. Откат

Один revert: чистая рендер-геометрия.