OpenSpec-Review dokumentieren und ISAM-Vertragsabweichungen beheben

openspec/changes/laufzeit-eingabe-und-systemstatus/specs/datei-eio/spec.md

@@ -0,0 +1,84 @@
+## MODIFIED Requirements
+
+### Requirement: Sequenzielle Datenübertragung
+`PRINT #` SHALL wie `PRINT` formatieren (Druckzonen, Zahlendarstellung mit
+Vorzeichenspalte), `WRITE #` SHALL Elemente komma-getrennt mit Strings in
+Anführungszeichen schreiben. `INPUT #` SHALL komma-getrennte Felder lesen
+und dabei Anführungszeichen auswerten, `LINE INPUT #` die ganze Zeile ohne
+Zeilenende. `EOF` SHALL das Erreichen des Dateiendes melden; Lesen über das
+Dateiende hinaus MUST Laufzeitfehler 62 „Input past end of file" auslösen.
+
+INPUT # SHALL nicht konsumierte Felder einer Zeile für spätere Aufrufe bewahren und bei Bedarf über Zeilen hinweg weiterlesen. Fehlende geforderte Felder am Dateiende MUST Fehler 62 auslösen statt als leere Ersatzwerte zu gelten.
+
+#### Scenario: WRITE # und INPUT # sind gegenläufig
+- **WHEN** `WRITE #1, "a,b", 5` geschrieben und die Zeile mit `INPUT #1, s$, n` gelesen wird
+- **THEN** enthält `s$` den Text `a,b` und `n` den Wert 5
+
+#### Scenario: Lesen über das Dateiende
+- **WHEN** `INPUT #1, x` nach dem letzten Datensatz ausgeführt wird
+- **THEN** tritt Laufzeitfehler 62 auf
+
+#### Scenario: Felder über zwei Aufrufe
+- **WHEN** WRITE #1, "a", "b" geschrieben und nach Wiederöffnung zweimal INPUT #1 mit je einer Stringvariablen ausgeführt wird
+- **THEN** liefern die Aufrufe a und b
+
+#### Scenario: Zu wenige Felder
+- **WHEN** nur ein Feld vorhanden ist und INPUT #1 zwei Felder verlangt
+- **THEN** tritt Fehler 62 auf
+
+### Requirement: Record-Konvertierungsfunktionen
+Die Bibliothek SHALL die Konvertierungsfunktionen für Recordpuffer
+bereitstellen: `MKI$`, `MKL$`, `MKS$`, `MKD$` und `MKC$` wandeln einen
+numerischen Wert in seine Byte-Darstellung als String, `CVI`, `CVL`,
+`CVS`, `CVD` und `CVC` wandeln zurück. Jedes Paar MUST gegenläufig sein.
+Ein Argument, dessen Länge nicht zur Zielbreite passt, MUST
+Laufzeitfehler 5 „Illegal function call" auslösen. `MKSMBF$`, `MKDMBF$`,
+`CVSMBF` und `CVDMBF` SHALL dieselbe Rolle für das
+Microsoft-Binärformat älterer BASIC-Versionen erfüllen; ist dieses
+Format ein deklariertes Non-Feature, MUST die Ablehnung namentlich
+erfolgen und in der Sprachreferenz unter „Abweichungen" stehen.
+
+Die Argumentlänge der CV-Funktionen SHALL exakt ihrer Zielbreite entsprechen, nicht nur einer Mindestbreite.
+
+#### Scenario: MK und CV sind gegenläufig
+- **WHEN** `CVL(MKL$(123456))` ausgewertet wird
+- **THEN** ist das Ergebnis 123456
+
+#### Scenario: Falsche Argumentlänge
+- **WHEN** `CVI("x")` mit einem ein Zeichen langen String ausgewertet wird
+- **THEN** tritt Laufzeitfehler 5 auf
+
+#### Scenario: Zu langes CVI-Argument
+- **WHEN** CVI("abc") ausgewertet wird
+- **THEN** tritt Laufzeitfehler 5 auf
+
+### Requirement: Dateisystem-Anweisungen mit plattformübergreifender Pfadsemantik
+`KILL`, `NAME … AS`, `FILES`, `CHDIR`, `CHDRIVE`, `MKDIR`, `RMDIR`,
+`CURDIR$`, `DIR$` sowie `SHELL` als Anweisung **und** als Funktion SHALL
+verfügbar sein. `CURDIR$` SHALL das aktuelle Verzeichnis liefern, `DIR$`
+den ersten bzw. — bei leerem Argument — den nächsten Treffer eines
+Suchmusters und den leeren String, wenn keiner mehr folgt. Die
+`SHELL`-Funktion SHALL den Beendigungsstatus des aufgerufenen Prozesses
+liefern. `CHDRIVE` SHALL auf Plattformen ohne Laufwerksbuchstaben
+namentlich abgewiesen oder als Non-Feature dokumentiert werden. Pfade SHALL sowohl `\` als auch `/` als Trennzeichen
+akzeptieren und auf die Konvention der laufenden Plattform abgebildet
+werden; Laufwerksbuchstaben SHALL auf Nicht-Windows-Plattformen als
+gewöhnlicher Namensbestandteil behandelt oder mit benannter Ablehnung
+abgewiesen werden. Fehlende Dateien MUST Fehler 53 auslösen, fehlende
+Pfade Fehler 76 „Path not found".
+
+#### Scenario: Rückwärts-Schrägstrich auf Unix
+- **WHEN** `OPEN "unter\d.txt" FOR OUTPUT AS #1` auf einer Unix-Plattform ausgeführt wird
+- **THEN** entsteht die Datei `d.txt` im Verzeichnis `unter`
+
+#### Scenario: Verzeichnis durchlaufen
+- **WHEN** `DIR$("*.txt")` und danach `DIR$("")` wiederholt ausgewertet werden
+- **THEN** liefern sie nacheinander alle passenden Namen und zuletzt den leeren String
+
+#### Scenario: Fehlender Pfad
+- **WHEN** `MKDIR` in einem nicht existierenden Elternverzeichnis aufgerufen wird
+- **THEN** tritt Laufzeitfehler 76 auf
+
+#### Scenario: OPEN mit fehlendem Elternpfad
+- **WHEN** OPEN FOR INPUT einen Dateinamen in einem nicht vorhandenen Elternverzeichnis verwendet
+- **THEN** tritt Fehler 76 auf; fehlt nur die Datei in einem vorhandenen Verzeichnis, tritt Fehler 53 auf

openspec/changes/laufzeit-eingabe-und-systemstatus/specs/konsolen-basisbibliothek/spec.md

@@ -0,0 +1,23 @@
+## MODIFIED Requirements
+
+### Requirement: Zonenermittlung mit Rückfallebene
+Die Laufzeit SHALL die Zeitzone des Rechners über die
+Betriebssystemeinstellung bestimmen. Lässt sie sich nicht ermitteln,
+SHALL UTC gelten und das Programm ohne Fehler weiterlaufen. Ob die
+Rückfallebene greift, MUST für ein Programm erkennbar sein und in
+docs/sprachreferenz.md beschrieben stehen; ein stiller Wechsel auf UTC
+MUST NOT vorkommen.
+
+Die parameterlose INTEGER-Funktion TIMEZONEKNOWN SHALL -1 für eine ermittelte Systemzone und 0 für den UTC-Rückfall liefern. Auch eine nach Programmstart scheiternde Zonenermittlung SHALL diesen Zustand sichtbar ändern; die Abfrage SHALL keine Zeitzone oder Systemuhr verstellen.
+
+#### Scenario: Zone nicht ermittelbar
+- **WHEN** die Zeitzone des Rechners nicht bestimmt werden kann
+- **THEN** rechnen die Zeitfunktionen in UTC und das Programm läuft ohne Fehler weiter
+
+#### Scenario: Rückfallebene ist erkennbar
+- **WHEN** ein Programm den Zonenzustand abfragt
+- **THEN** unterscheidet die Antwort erkennbar zwischen ermittelter Zone und Rückfall auf UTC
+
+#### Scenario: Rückfall nach Programmstart
+- **WHEN** zunächst eine Zone ermittelt wurde, eine spätere Ermittlung aber scheitert
+- **THEN** verwenden die Zeitfunktionen UTC und TIMEZONEKNOWN liefert 0

openspec/changes/laufzeit-eingabe-und-systemstatus/specs/sprach-frontend/spec.md

@@ -0,0 +1,27 @@
+## MODIFIED Requirements
+
+### Requirement: Jedes dokumentierte Element besitzt eine Signatur
+Die Semantik SHALL für jedes im Sprachinventar geführte Element eine
+Signatur besitzen (Argumentanzahl und -typen) — auch für Elemente, deren
+Laufzeitverhalten noch aussteht. Ein im Inventar geführtes Element MUST
+NOT als unbekannter Bezeichner oder mit einem generischen Syntaxfehler
+abgewiesen werden; die Diagnose bzw. der Laufzeitfehler MUST es
+namentlich nennen (Guiding Principle). Das gilt insbesondere für die
+Gruppen, die bisher gar keine Signatur haben: die finanzmathematischen
+Funktionen, die Record-Konvertierungsfunktionen (`MK…$`/`CV…`), die
+Dateisystem-Funktionen `CURDIR$`, `DIR$`, `CHDRIVE`, sowie `LPOS`,
+`STACK`, `SYSTEM`, `ERDEV`/`ERDEV$` und `SetFormatCC`.
+
+Die TerminalBasic-Erweiterung TIMEZONEKNOWN SHALL als parameterlose INTEGER-Funktion eine Signatur besitzen und im Inventar mit ihrer tatsächlichen Umsetzung geführt sein.
+
+#### Scenario: Element ohne Laufzeitverhalten wird namentlich abgewiesen
+- **WHEN** ein Modul eine im Inventar als `offen` geführte Funktion verwendet
+- **THEN** nennt die Ablehnung deren Namen und nicht „unbekannter Bezeichner"
+
+#### Scenario: Argumentprüfung ohne Laufzeitverhalten
+- **WHEN** ein Modul `MKL$()` ohne Argument enthält
+- **THEN** meldet die Semantik eine Argumentanzahl-Diagnose, die `MKL$` nennt
+
+#### Scenario: Signatur der Zonenzustandsabfrage
+- **WHEN** PRINT TIMEZONEKNOWN übersetzt wird
+- **THEN** entsteht eine INTEGER-Funktionsabfrage; TIMEZONEKNOWN(1) wird mit benannter Argumentanzahl-Diagnose abgewiesen

openspec/changes/laufzeit-eingabe-und-systemstatus/specs/textbildschirm/spec.md

@@ -0,0 +1,26 @@
+## MODIFIED Requirements
+
+### Requirement: Tastatureingabe ohne Zeilenmodell
+`INKEY$` SHALL ohne zu blockieren die nächste anstehende Taste liefern:
+den leeren String bei leerem Puffer, ein Zeichen bei einer
+Zeichentaste, eine zwei Zeichen lange Folge mit führendem Nullzeichen bei
+einer Sondertaste. `INPUT$(n [, #dateinummer])` SHALL genau `n` Zeichen
+lesen und dabei blockieren, ohne sie am Bildschirm zu wiederholen.
+
+INPUT$ SHALL n Unicode-Codepoints liefern. Nicht verbrauchte Zeichen einer Sondertastenfolge und noch nicht gelesene Dateizeichen SHALL für Folgeaufrufe erhalten bleiben. Dateieingabe SHALL UTF-8 vor der Zeichenzählung decodieren.
+
+#### Scenario: INKEY$ bei leerem Tastaturpuffer
+- **WHEN** `INKEY$` ohne anstehende Taste ausgewertet wird
+- **THEN** liefert es den leeren String und blockiert nicht
+
+#### Scenario: Sondertaste als zwei Zeichen
+- **WHEN** F1 gedrückt wurde und `INKEY$` ausgewertet wird
+- **THEN** hat das Ergebnis die Länge 2 und beginnt mit dem Nullzeichen
+
+#### Scenario: Sondertastenfolge in zwei Reads
+- **WHEN** F1 ansteht und zweimal INPUT$(1) ausgeführt wird
+- **THEN** liefert der erste Aufruf das Nullzeichen und der zweite den Scancode, jeweils genau ein Zeichen
+
+#### Scenario: Unicode aus Datei
+- **WHEN** eine UTF-8-Datei mit ä beginnt und INPUT$(1,#1) aufgerufen wird
+- **THEN** liefert der Aufruf ä ohne Ersatzzeichen