Files
TerminalBasic/openspec/changes/phase-2-bytecode-vm/specs/kompat-testkorpus/spec.md
Chili Palmer f7e57b0bd8 Phase 2 abgeschlossen: Bytecode, TBVM, Runtime-Scheibe, tbc run
- Sema zum Lowering-Pass umgebaut: typisiertes HIR (Slots, explizite
  Konvertierungsknoten) als Codegen-Eingabe; BYREF verlangt exakten Typ
- Bytecode-Feindesign umgesetzt: monomorpher Opcode-Satz,
  .tbc-Container (Formatversion 1) mit eigenem Writer/Reader
- Codegenerator HIR -> Bytecode (Fixup-Listen, keine globalen Passes)
- TBVM-Interpreter: Kontrollfluss, GOSUB-Stack je Frame, BYREF/BYVAL,
  STATIC, DEF FN, DATA/READ/RESTORE, ON [LOCAL] ERROR/RESUME/ERR/ERL,
  Breakpoints/Einzelschritt/Inspektion, STOP fortsetzbar
- Runtime-Scheibe: Host-Trait (Konsole/Capture), Builtin-Tabelle,
  Konvertierungsmatrix, PRINT-Formatierung/Druckzonen, Stringfunktionen
- tbc run/build/check mit Exit-Codes nach Entscheidung D6
- Korpus-Harness (byte-genauer Vergleich) + 3 neue Korpusdateien
  (konvertierung, fehlerbehandlung, byref); 137 Tests gruen
- Benchmarks: Einzelmodul 1,2 ms / Projekt 49.760 Zeilen 124 ms
  (Budgets eingehalten), VM ~5 Mio Schleifeniterationen/s
- Doku fortgeschrieben (tbvm-design, sprachreferenz, PLAN);
  verlagerte Punkte als explizite Aufgaben in Phase 3
- OpenSpec-Change phase-2-bytecode-vm (27/27 Tasks)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-09-02 11:28:07 +02:00

1.4 KiB

ADDED Requirements

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