Files

Chili Palmer a6f005d023 OpenSpec: phase-2-bytecode-vm archiviert, Delta-Specs in Hauptspecs gesynct

- 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>

2026-09-02 11:33:51 +02:00

2.7 KiB

Raw Blame History

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

2.7 KiB Raw Blame History