[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:
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user