packages/shared/src/rules/README.md

# Regel-Interpreter (TS) – Spiegel von `fp_engines/rules`

Wertet das deklarative Regel-JSON (`data/rules/`, Schema `regel`) gegen eine
Szene (Raummodell + Plan + Katalog) aus und liefert den `constraintReport`
mit Konfidenz-Ampel: **ok | knapp | verletzt | nicht-geprueft**.
«knapp» = erfüllt, aber Marge < Messunsicherheit (`estimatedError_cm`; 0 nach
`geometryConfirmed`).

## Parameter-Konventionen je Regel-Typ (v0)

| `type`            | params                                             | Semantik                                                                                                          |
| ----------------- | -------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| `collision`       | –                                                  | kein Überlappen; vollständig im Raum (Ecken-Heuristik)                                                            |
| `wall-distance`   | `minDist`                                          | Objekt-**Mitte** → nächste massive Wand ≥ minDist                                                                 |
| `object-distance` | `target`, `minDist`, `measure: edge\|center`       | Abstand zu Objekten vom Typ target                                                                                |
| `clearance`       | `depth`, `width?` (Default Objektbreite)           | Zone vor der Objekt-**Front** (lokal +z) frei + im Raum                                                           |
| `door-swing`      | `radius`                                           | v0: Rechteck Türbreite × radius ins Rauminnere (statt Viertelkreis – konservative Näherung)                       |
| `keep-clear`      | `depth`, `maxObjektHoehe`                          | Streifen vor Fenster frei von Objekten mit Gesamthöhe > maxObjektHoehe                                            |
| `host-binding`    | `mount`, `maxWandabstand`, `minHoehe?`/`maxHoehe?` | Wand-/Bodenbindung; Höhenfenster prüft die **Oberkante** = `mountHeight` (Unterkante, Plan) + Korpushöhe          |
| `connection`      | `anschluss`, `maxDist`                             | passender Fixpunkt in Reichweite des Footprints                                                                   |
| `circulation`     | `minWidth`                                         | v0 **soft**: Grid/Erosion-Freiraumanalyse – durchgehender Korridor ≥ minWidth zwischen Türen (Marge grob ±Raster) |
| `relation`        | `relation`                                         | soft, **nicht-geprueft** bis M3 (Solver-Scoring)                                                                  |

## ⚠️ Paritäts-Gesetz

`geometry.ts`/`scene.ts`/`interpreter.ts` sind 1:1 in
`services/engines/src/fp_engines/rules/` gespiegelt – gleiche Formeln, gleiche
Operationsreihenfolge. Wer eine Seite ändert, ändert **im selben Commit** die
andere Seite und die goldenen Fixtures (`packages/shared/fixtures/`). Der
Paritätstest (vitest **und** pytest) erzwingt identische Urteile.