# kompat-testkorpus Specification

## Purpose
Der Kompatibilitäts-Testkorpus hält das Sollverhalten des Dialekts als
ausführbare Spezifikation fest: Referenzprogramme mit byte-genau
dokumentierter Ausgabe, gegen die Frontend und (ab Phase 2) Laufzeit
geprüft werden.

## Requirements

### Requirement: Korpusdateien mit byte-genauer Sollausgabe
Jedes Korpusprogramm `tests/compat/<name>.bas` SHALL eine `<name>.out`
mit der exakten Konsolenausgabe besitzen (UTF-8, LF-Zeilenenden).
Nachgestellte Leerzeichen sind signifikant — `PRINT` gibt Zahlen mit
führendem Vorzeichen-/Leerzeichen und nachgestelltem Leerzeichen aus,
auch am Zeilenende; `.gitattributes` MUST die `.out`-Dateien vor
Zeilenenden-Konvertierung schützen.

#### Scenario: Zahlformatierung in der Sollausgabe
- **WHEN** ein Korpusprogramm `PRINT 1; 2; 3` enthält
- **THEN** lautet die Sollzeile ` 1  2  3 ` (mit nachgestelltem Leerzeichen)

### Requirement: Frontend-Meilenstein über den Korpus
Ein automatischer Test SHALL alle `tests/compat/*.bas` durch das
Sprach-Frontend führen und fehlschlagen, sobald eine Datei Diagnosen
liefert. (Ab Phase 2 kommt der Laufzeitvergleich `tbc run` ↔ `.out`
hinzu.)

#### Scenario: Korpus bleibt kompilierbar
- **WHEN** die Frontend-Testsuite läuft
- **THEN** parsen alle Korpusdateien diagnose-frei und der Test nennt andernfalls Datei und Diagnose

### Requirement: Laufzeitvergleich über den Korpus
Ein automatischer Test SHALL jede Korpusdatei `tests/compat/*.bas`
kompilieren, über die VM mit Capture-Host ausführen und die Ausgabe
byte-genau (inklusive nachgestellter Leerzeichen und LF-Zeilenenden)
gegen die zugehörige `.out`-Datei vergleichen. Bei Abweichung MUST der
Test Datei, erste abweichende Zeile sowie Soll und Ist nennen.

#### Scenario: Korpus läuft mit korrekter Ausgabe
- **WHEN** die Laufzeit-Testsuite läuft
- **THEN** stimmt die Ausgabe jeder Korpusdatei byte-genau mit ihrer `.out` überein

#### Scenario: Abweichung wird benannt
- **WHEN** ein Korpusprogramm eine abweichende Ausgabe erzeugt
- **THEN** schlägt der Test fehl und nennt Datei, Zeilennummer, Soll- und Ist-Zeile

### Requirement: Korpusabdeckung der Phase-2-Semantik
Der Korpus SHALL um Referenzprogramme mit dokumentierter Sollausgabe für
die Zahlenkonvertierungs-Matrix (Rundung, Ganzzahldivision, logische
Operatoren, Überlauf-Randfälle über Fehlerbehandlung), die
Fehlerbehandlung (`ON ERROR`, `RESUME`-Varianten, `ERR`/`ERL`) sowie
Prozeduraufrufe mit BYREF-/BYVAL-Wirkung erweitert werden.

#### Scenario: Konvertierungsmatrix als Korpustest
- **WHEN** die Laufzeit-Testsuite läuft
- **THEN** existiert ein Korpusprogramm, das die Matrix-Randfälle ausgibt, und seine Ausgabe entspricht der dokumentierten Sollausgabe