[FEAT] VF-Linienzug aus Eingabedaten bauen (Stufe 1: Spec -> Journal -> Replay)

Stufe 1 des Fahrplans in doc/TODO-plan-vf-interactive.md, fertig fuer
Modus 1. Eine SPEC beschreibt eine Kette in Domaenenwerten ("links",
"winkel", "aussen", ja/nein) statt in Menue-Codes; vsp-journal uebersetzt sie
in ein Eingabe-Journal, vsp-bau-aus-spec spielt es per
vfl-journal-replay-start durch den UNVERAENDERTEN vf-linienzug-modus. Der
fertige Block traegt damit dasselbe SSG_VF_EDIT-Journal wie eine handgebaute
Kette und bleibt per Doppelklick editier- und 2D/3D-konvertierbar - kein
Journal-Konsument muss etwas von Specs wissen.

CAD-Lauf VF_SPEC_BAU: 5 OK, 0 Fehler. Je Kette status "executed",
prompts 0 (keine Live-Eingabe erreicht), eingaben_offen 0, keine
Spec-Fehler, keine Bau-Meldungen, glieder_ist == glieder_soll,
Einfuegepunkt gleich dem Kettenstart der Spec.

Neu:
- Lisp/vf_spec.lsp: Code-Tabellen, Emitter vsp-journal, Validierung
  vsp-pruefen, flacher JSON-Loader, Headless-Rahmen vsp-headless-an/-aus,
  Ergebnis-Record, vsp-bau-aus-spec/-liste, c:VF_SPEC_BAU. Von vf_core.lsp
  NACH vf_linienzug.lsp geladen - damit sind beide Ladewege abgedeckt (Menue
  und der .scr-Loader), das MNL bleibt unveraendert.
- lib/vf_spec_export.py: derselbe Emitter in Python PLUS die Umkehrung
  (spec_aus_journal), erzeugt die Spec-Testdaten.
- tests/testdata/vf_spec_hundm05.json: die 5 echten Ketten als Spec,
  erzeugt statt handgeschrieben.
- tests/test_vf_spec.lsp (C:TEST_VF_SPEC, in alltests.json): 7 Faelle je
  Glied-Typ, 7 Validierungsfaelle, Gruppieren, und die 5 echten Ketten gegen
  ihr aufgezeichnetes Journal.
- tests/test_vf_spec.py: 36 Tests (Rundlauf, Spec-Daten, Validierung,
  Erwartungswert-Abgleich, Ergebnisse von VF_SPEC_BAU).

Drei Regeln, die der Uebersetzer besitzen muss - jede wuerde sonst die ganze
Replay-Queue verschieben:
- Der Menue-Code haengt am Frame: erste Sektion 4 Optionen (kein GF-Bogen,
  es gibt noch keine Richtung), jede spaetere 5.
- hz steht genau EINMAL im Journal, beim ersten Segment (vfl-in-abstand
  journalisiert die Richtung nur bei freier Richtungswahl).
- Nur ein HORIZONTALER Erstkoerper einer VF-Einheit stellt die Separator-/
  Endpunktfragen vorab (winkel1=0 laeuft durch vfl-baue-horizontal-koerper);
  ein gewinkelter wird ohne jede Frage gebaut.

Wie die Richtigkeit belegt ist - drei Implementierungen derselben Grammatik,
die einander pruefen:
- Rundlauf gegen echte Daten: journal_aus_spec(spec_aus_journal(tok)) == tok
  fuer alle 5 HundM-Ketten, tokenweise numerisch verglichen. Damit ist
  bewiesen, dass die Spec das Journal verlustfrei abbildet.
- Der Weg, den LISP nimmt (flaches JSON -> Spec -> Journal), ergibt separat
  geprueft dieselben Journale wie das aufgezeichnete Protokoll.
- Der unabhaengige Dekoder aus lib/vf_journal_export.py verdaut alle 7
  synthetischen Emitter-Ausgaben restlos, auch die zwei Zweige, die in den
  echten Daten fehlen (Linie-VF, gewinkelter Erstkoerper).
- Die Erwartungswerte im LISP-Test kommen aus dem geprueften Python-Emitter;
  TestLispErwartungen liest sie zurueck und vergleicht erneut. Ohne das
  koennte ein Uebertragungsfehler einen falschen Erwartungswert
  festschreiben und der CAD-Lauf waere gruen, obwohl der Emitter falsch
  liegt.

Abweichungen von der Planung (Begruendungen in doc/TODO-plan-vf-interactive.md
Abschnitt 4.6): vsp-pruefen ruft den Emitter statt eine zweite Regelmenge zu
pflegen; das vollstaendige Journal steht nicht im Record (statt dessen
glieder_soll/glieder_ist als Desync-Detektor); Zusatzfeld segment_typ am
Glied "Linie", weil dort vfl-segment-entscheidung selbst zwischen GF und VF
waehlt; vf_ende-Werte "automatisch"/"zielpunkt-ohne-es" fuer die Faelle ohne
Frage; Praefix vsp- statt vfs- (das gehoert vf_standard.lsp).

Zusaetzlich:
- tests/test_vf_headless_statisch.py prueft jetzt auch, dass
  Lisp/vf_spec.lsp UEBERHAUPT keine Eingabe-/Dialogfunktion aufruft - beim
  Daten-Pfad ist die Null die Vorgabe.
- tests/testdata/mubea.json: die drei einzeln eingefuegten S-LP-Separatoren
  entfernt (Fortsetzung von 699744e - die Separatoren stecken jetzt in den
  Staustreckenbloecken).

Noch offen: die Uebersetzer fuer Modus 2 und 3. Modus 2 braucht laut
Fahrplan erst 2-3 echte "linienzug2"-Journale als Referenz -
tests/testdata/hundm05.json enthaelt ausschliesslich Modus-1-Ketten.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-09-03 10:44:38 +02:00
parent ba01455d52
commit 428f1ced70
13 changed files with 3268 additions and 31 deletions
+63
View File
@@ -487,6 +487,69 @@ Sektion warum nicht baubar war - bleibt erhalten. Die reinen Interaktiv-Alerts
`alert` geblieben. `vfl-journal-reset` loescht `*vfl-meldungen*` und
`*vfl-headless-fehler*` mit: beides gehoert zum einzelnen Lauf.
### Spec-Pfad: Kette aus Eingabedaten (`VF_SPEC_BAU`)
Auf dem Headless-Rahmen sitzt `Lisp/vf_spec.lsp`. Eine **Spec** beschreibt
eine Kette in Domaenenwerten statt in Menue-Codes:
```json
{ "spec_id": "VF_spec_LZ_01", "modus": 1,
"start_punkt": [4912.2, 1230.9, 2154.0], "start_hoehe": 2154.0,
"as": 1, "as_winkel": "90", "as_seite": "links" }
{ "glied": "Linie-GF", "nr": 1, "dl": 2249.3, "hz": 90.0,
"gefaelle": "winkel", "winkel": 3.0, "ende": "nein" }
{ "glied": "Horizontal-VF", "nr": 2, "dl": 3256.9,
"gf_verteilung": "einlauf", "vf_sep_vor": 0, "vf_sep_nach": 0,
"vf_ende": "nein", "vf_separator": 0 }
{ "sub": "vario-kurve", "winkel": 90, "seite": "rechts", "variante": "innen" }
{ "sub": "motorstation" }
{ "glied": "ES", "winkel": "90", "seite": "links" }
```
Flach, weil `ssg-load-json` zeilenweise liest; Wahrheitswerte als `1`/`0`.
`vsp-journal` uebersetzt das in ein Eingabe-Journal, `vsp-bau-aus-spec`
spielt es per `vfl-journal-replay-start` durch den **unveraenderten**
`vf-linienzug-modus`. Der fertige Block traegt danach dasselbe
`SSG_VF_EDIT`-Journal wie eine handgebaute Kette.
Drei Regeln, die der Uebersetzer besitzen muss (sie sind der Grund, warum die
Spec nicht einfach "die Antworten" ist):
1. **Der Menue-Code haengt am Frame.** Nur die erste Sektion laeuft ohne
Frame und bekommt 4 Optionen (kein GF-Bogen - es gibt noch keine Richtung,
an die er anschliessen koennte), jede spaetere 5. `Linie-GF` ist also in
Sektion 1 der Code `"1"`, ab Sektion 2 der Code `"2"`.
2. **`hz` steht genau einmal im Journal**, beim allerersten Segment
(`vfl-in-abstand` journalisiert die gesnappte Richtung nur bei freier
Richtungswahl). Ein `hz` an spaeterer Stelle verschiebt die ganze
Replay-Queue - darum ein harter Spec-Fehler.
3. **Der erste Koerper einer VF-Einheit** stellt nur dann Separator- und
Endpunktfragen vorab, wenn er HORIZONTAL ist (`winkel1 = 0` in
`vfl-vf-einheit` laeuft durch `vfl-baue-horizontal-koerper`). Ein
gewinkelter Erstkoerper (`Linie-VF`, `Linie` -> VF) wird ohne jede Frage
gebaut.
Nicht vorhersagbar bleibt die Winkelwahl: `vfl-waehle-winkel` fragt nur, wenn
mehrere Kandidaten geometrisch gueltig sind, was von der real gemessenen
Restlaenge abhaengt. Dafuer das optionale Feld `winkel_idx`; fehlt es und der
Bau braucht die Antwort, greift der Headless-Riegel und nennt Glied und
Eingabe-Nummer. Geraten wird nichts.
Ergebnis je Kette als Record (`tests/output/vf_spec_results.json`): `status`
(`executed`/`warnung`/`desync`/`abbruch`/`spec-fehler`), Block, Handle,
Einfuegepunkt, Attribute, `eingaben_offen`, `prompts` (muss 0 sein),
`glieder_soll` gegen `glieder_ist` und die gesammelten `meldungen`. Der
Glied-Vergleich ist der Desync-Detektor, der auch dann greift, wenn die Queue
aufgeht: eine geometrisch abgewiesene Sektion wirft keinen Fehler, sie
verbraucht nur weniger Eintraege.
Gegenstueck in Python: `lib/vf_spec_export.py` enthaelt denselben Emitter
PLUS die Umkehrung und erzeugt daraus die Spec-Testdaten. Der Rundlauf
`Journal -> Spec -> Journal` laeuft in `tests/test_vf_spec.py` gegen die 5
echten HundM-Ketten - er beweist, dass die Spec das Journal verlustfrei
abbildet. Modus 2 und 3 haben noch keinen Uebersetzer (Modus 2 braucht erst
echte `"linienzug2"`-Journale als Referenz).
Beispiel: `tests/test_hundm05.lsp` (5 echte Ketten aus `data/polylines.dxf`)
setzt alle drei Schalter mit Save/Restore, ersetzt `getpoint`/`getstring`/
`getint`/`getreal`/`alert` zusaetzlich durch **zaehlende** Stubs (Netz fuer