Chili Palmer
a6f005d023
- Neue Hauptspecs: bytecode-kompilat, vm-ausfuehrung, vm-fehlerbehandlung, konsolen-basisbibliothek - Erweitert: sprach-frontend (Typisiertes HIR als Sema-Ausgabe), kompat-testkorpus (Laufzeitvergleich, Phase-2-Korpusabdeckung) - Change nach openspec/changes/archive/2026-09-02-phase-2-bytecode-vm verschoben; openspec validate --all: 9/9 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
58 lines
2.7 KiB
Markdown
58 lines
2.7 KiB
Markdown
# 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
|