fix(terminal,output): fix PowerShell cd command, output encoding, and process error handling

- features/terminal.py: fix working directory change in PowerShell by omitting unsupported /d flag; use dynamic _output_encoding() for cmd vs PowerShell/POSIX; connect errorOccurred signal
- core/output.py: connect errorOccurred to _on_error in OutputPanel to prevent hanging stop button and silent launch failures; add waitForFinished(1000) after kill and closeEvent cleanup
- tests: add regression tests in test_terminal_encoding.py and test_output_panel.py (115 passed)
- docs: update CHANGELOG.md, README.md, README_de.md, and llms.txt

Author: lukisch

CHANGELOG.md

@@ -13,6 +13,12 @@ Format basiert auf [Keep a Changelog](https://keepachangelog.com/de/1.1.0/).
 
 ## [0.1.2] - 2026-08-16
 
+### Terminal- & Prozess-Streaming-Härtung (2026-08-22)
+
+- `features/terminal.py`: Verzeichniswechsel via `set_working_dir()` für PowerShell korrigiert (PowerShell unterstützt keinen `/d`-Schalter von cmd.exe; `cd` führte zuvor zu `PositionalParameterNotFound`-Fehlern und verweigerte das Wechseln des Arbeitsordners). Output-Dekodierung in `_on_stdout` und `_on_stderr` auf dynamisches `_output_encoding()` (cp1252 für cmd unter Windows, sonst utf-8) umgestellt. Signalverwaltung um `errorOccurred` und sauberes Exception-Handling erweitert.
+- `core/output.py`: `OutputPanel` mit `errorOccurred`-Signalbehandlung (`_on_error`) gegen hängende Stop-Buttons und unterdrückte Fehlermeldungen bei nicht auffindbaren Compilern/Programmen (`FailedToStart`, `Crashed`) abgesichert. `waitForFinished(1000)` nach `kill()` und `closeEvent` für zuverlässige Prozessbereinigung ergänzt.
+- `tests/test_terminal_encoding.py` & `tests/test_output_panel.py`: 6 neue Regressionstests für PowerShell-Verzeichniswechsel, Output-Encoding, Signal-Entkopplung, Fehlerausgabe und Prozessbeendigung ergänzt (115 passed, 1 skipped).
+
 ### UX, Barrierefreiheit & Accessibility-Härtung (2026-08-21)
 
 - `ui/main_window.py`: StatusTips auf allen Menü- und Toolbar-Aktionen (`Neu`, `Öffnen`, `Speichern`, `Beenden`, `Rückgängig`, `Wiederherstellen`, `Suchen`, `Gehe zu Zeile`, `Plugins`, `Einstellungen`, `Ausführen`, `Stoppen`, `Projektbaum`, `Terminal`, `Tastenkürzel`, `Über`); `setToolTip()`, `setWhatsThis()`, `setAccessibleName()` und `setAccessibleDescription()` für Hauptleiste, Sprach-Auswahl (`lang_combo`), Statusleisten-Widgets (`pos_label`, `lang_label`, `enc_label`) und Reiter im unteren Bedienpanel (`bottom_tabs`).

README.md

@@ -8,7 +8,7 @@
 [![Ecosystem: dev-bricks](https://img.shields.io/badge/ecosystem-dev--bricks-blue.svg)](https://github.com/dev-bricks)
 [![Part of: open-bricks](https://img.shields.io/badge/part%20of-open--bricks-blue.svg)](https://github.com/open-bricks)
 [![LSP Ready](https://img.shields.io/badge/LSP-ready-purple.svg)]()
-[![Tests](https://img.shields.io/badge/tests-109%20passed-brightgreen.svg)]()
+[![Tests](https://img.shields.io/badge/tests-115%20passed-brightgreen.svg)]()
 [![llms.txt](https://img.shields.io/badge/llms.txt-available-green.svg)](llms.txt)
 
 [Deutsch](README_de.md) | English

README_de.md

@@ -8,7 +8,7 @@
 [![Ecosystem: dev-bricks](https://img.shields.io/badge/ecosystem-dev--bricks-blue.svg)](https://github.com/dev-bricks)
 [![Part of: open-bricks](https://img.shields.io/badge/part%20of-open--bricks-blue.svg)](https://github.com/open-bricks)
 [![LSP Ready](https://img.shields.io/badge/LSP-ready-purple.svg)]()
-[![Tests](https://img.shields.io/badge/tests-109%20passed-brightgreen.svg)]()
+[![Tests](https://img.shields.io/badge/tests-115%20passed-brightgreen.svg)]()
 [![llms.txt](https://img.shields.io/badge/llms.txt-available-green.svg)](llms.txt)
 
 [English](README.md) | Deutsch

core/output.py

@@ -89,13 +89,15 @@ def run_command(self, command: list):
                 self.process.readyReadStandardOutput,
                 self.process.readyReadStandardError,
                 self.process.finished,
+                self.process.errorOccurred,
             ):
                 try:
                     sig.disconnect()
                 except (TypeError, RuntimeError):
                     pass
             if self.process.state() != QProcess.ProcessState.NotRunning:
                 self.process.kill()
+                self.process.waitForFinished(1000)
 
         self.output.clear()
         self.status_label.setText(f"Ausführung: {' '.join(command)}")
@@ -105,14 +107,17 @@ def run_command(self, command: list):
         self.process.readyReadStandardOutput.connect(self._on_stdout)
         self.process.readyReadStandardError.connect(self._on_stderr)
         self.process.finished.connect(self._on_finished)
+        self.process.errorOccurred.connect(self._on_error)
 
         program = command[0]
+        self._current_program = program
         args = command[1:] if len(command) > 1 else []
         self.process.start(program, args)
 
     def stop_process(self):
         if self.process and self.process.state() != QProcess.ProcessState.NotRunning:
             self.process.kill()
+            self.process.waitForFinished(1000)
             self.append_text("\n--- Prozess abgebrochen ---\n", color="#ff8888")
 
     def clear(self):
@@ -148,3 +153,23 @@ def _on_finished(self, exit_code, exit_status):
         self.append_text(f"\n--- Prozess beendet ({status}) ---\n",
                          color="#88ff88" if exit_code == 0 else "#ff8888")
         self.processFinished.emit(exit_code, self.output.toPlainText())
+
+    def _on_error(self, error):
+        self.stop_btn.setEnabled(False)
+        program = getattr(self, "_current_program", "Programm")
+        if error == QProcess.ProcessError.FailedToStart:
+            self.status_label.setText("Fehler: Programm konnte nicht gestartet werden")
+            self.append_text(
+                f"\n--- Fehler: Programm '{program}' konnte nicht gestartet werden (Befehl nicht gefunden oder keine Ausführungsrechte) ---\n",
+                color="#ff8888",
+            )
+            self.processFinished.emit(-1, self.output.toPlainText())
+        elif error == QProcess.ProcessError.Crashed:
+            self.status_label.setText("Fehler: Prozess abgestürzt")
+            self.append_text(f"\n--- Fehler: Prozess '{program}' ist abgestürzt ---\n", color="#ff8888")
+
+    def closeEvent(self, event):
+        if self.process and self.process.state() != QProcess.ProcessState.NotRunning:
+            self.process.kill()
+            self.process.waitForFinished(1000)
+        super().closeEvent(event)

features/terminal.py

@@ -164,6 +164,7 @@ def _start_shell(self):
                 self.process.readyReadStandardOutput,
                 self.process.readyReadStandardError,
                 self.process.finished,
+                self.process.errorOccurred,
             ):
                 try:
                     sig.disconnect()
@@ -178,6 +179,7 @@ def _start_shell(self):
         self.process.readyReadStandardOutput.connect(self._on_stdout)
         self.process.readyReadStandardError.connect(self._on_stderr)
         self.process.finished.connect(self._on_finished)
+        self.process.errorOccurred.connect(self._on_error)
 
         program, args = self._get_shell_command()
         self.process.start(program, args)
@@ -196,6 +198,14 @@ def _input_encoding(self) -> str:
                 return "cp1252"
         return "utf-8"
 
+    def _output_encoding(self) -> str:
+        """Encoding für Shell-Ausgaben — cp1252 für cmd/Windows, sonst utf-8."""
+        if sys.platform == "win32":
+            shell = self.shell_combo.currentText() if hasattr(self, "shell_combo") else "cmd"
+            if shell == "cmd":
+                return "cp1252"
+        return "utf-8"
+
     def _execute_command(self):
         """Führt den eingegebenen Befehl aus."""
         cmd = self.input.text().strip()
@@ -253,22 +263,27 @@ def set_working_dir(self, path: str):
         self.cwd_label.setText(path)
         if self.process and self.process.state() == QProcess.ProcessState.Running:
             encoding = self._input_encoding()
-            if sys.platform == "win32":
+            shell = self.shell_combo.currentText() if hasattr(self, "shell_combo") else "cmd"
+            if sys.platform == "win32" and shell == "cmd":
                 self.process.write(f"cd /d \"{path}\"\n".encode(encoding, errors='replace'))
             else:
                 self.process.write(f"cd \"{path}\"\n".encode(encoding, errors='replace'))
 
     def _on_stdout(self):
-        data = self.process.readAllStandardOutput().data().decode('utf-8', errors='replace')
+        data = self.process.readAllStandardOutput().data().decode(self._output_encoding(), errors='replace')
         self.append_text(data)
 
     def _on_stderr(self):
-        data = self.process.readAllStandardError().data().decode('utf-8', errors='replace')
+        data = self.process.readAllStandardError().data().decode(self._output_encoding(), errors='replace')
         self.append_text(data, "#ff8888")
 
     def _on_finished(self, exit_code, exit_status):
         self.append_text(f"\n--- Shell beendet (Code {exit_code}) ---\n", "#888888")
 
+    def _on_error(self, error):
+        if error == QProcess.ProcessError.FailedToStart:
+            self.append_text("--- Fehler: Shell konnte nicht gestartet werden ---\n", "#ff8888")
+
     def closeEvent(self, event):
         if self.process:
             self.process.kill()

llms.txt

@@ -1,6 +1,6 @@
 # CodeBox - local PySide6 desktop code editor
 
-## Last-checked: 2026-08-21
+## Last-checked: 2026-08-22
 
 > CodeBox is a local-first desktop IDE for Windows developers who want a lightweight PySide6 code editor with tabs, a project tree, an integrated terminal, Git helpers, syntax highlighting, Language Server Protocol diagnostics, and an extensible JSON/Python language plugin system.
 
@@ -31,7 +31,7 @@ Part of the dev-bricks family. Python, MIT.
 - `python main.py`: Launches the CodeBox desktop interface.
 - `python main.py --open <file>`: Launches and directly opens a target file path.
 - `build_exe.bat`: Uses PyInstaller to bundle the application into a standalone executable.
-- `python -m pytest`: Runs the automated test suite (109 passed, 1 skipped).
+- `python -m pytest`: Runs the automated test suite (115 passed, 1 skipped).
 
 ## Related Projects (dev-bricks & ellmos family)
 

tests/test_output_panel.py

@@ -37,6 +37,7 @@ def test_run_command_disconnects_old_process_signals(self):
         mock_old.readyReadStandardOutput.disconnect.assert_called_once_with()
         mock_old.readyReadStandardError.disconnect.assert_called_once_with()
         mock_old.finished.disconnect.assert_called_once_with()
+        mock_old.errorOccurred.disconnect.assert_called_once_with()
         mock_old.kill.assert_called_once()
 
     def test_run_command_no_disconnect_when_no_prior_process(self):
@@ -83,8 +84,41 @@ def test_output_controls_expose_accessible_context(self):
         self.assertEqual(self.panel.clear_btn.accessibleName(), "Ausgabe leeren")
         self.assertIn("Meldungen", self.panel.clear_btn.accessibleDescription())
 
-        self.assertEqual(self.panel.status_label.accessibleName(), "Ausführungsstatus")
-        self.assertEqual(self.panel.output.accessibleName(), "Programmausgabe")
+    def test_run_command_failed_to_start_disables_stop_btn_and_emits_finished(self):
+        """Wenn ein Programm nicht gestartet werden kann, muss stop_btn deaktiviert,
+        der Status aktualisiert und ein Fehler ausgegeben werden."""
+        emitted_results = []
+        self.panel.processFinished.connect(lambda code, text: emitted_results.append((code, text)))
+
+        self.panel._current_program = "non_existent_compiler_xyz"
+        self.panel.stop_btn.setEnabled(True)
+        self.panel._on_error(QProcess.ProcessError.FailedToStart)
+
+        self.assertFalse(self.panel.stop_btn.isEnabled(), "stop_btn muss nach FailedToStart deaktiviert sein")
+        self.assertIn("Fehler", self.panel.status_label.text())
+        self.assertIn("nicht gestartet werden", self.panel.output.toPlainText())
+        self.assertEqual(len(emitted_results), 1)
+        self.assertEqual(emitted_results[0][0], -1)
+
+    def test_run_command_crashed_updates_status(self):
+        """Absturz eines Prozesses muss im Statuslabel und Output protokolliert werden."""
+        self.panel._current_program = "crashing_app"
+        self.panel.stop_btn.setEnabled(True)
+        self.panel._on_error(QProcess.ProcessError.Crashed)
+
+        self.assertFalse(self.panel.stop_btn.isEnabled())
+        self.assertIn("abgestürzt", self.panel.status_label.text())
+        self.assertIn("abgestürzt", self.panel.output.toPlainText())
+
+    def test_output_panel_close_event_terminates_running_process(self):
+        """Beim Schließen des Panels muss ein aktiver Prozess beendet werden."""
+        mock_proc = MagicMock()
+        mock_proc.state.return_value = QProcess.ProcessState.Running
+        self.panel.process = mock_proc
+
+        self.panel.close()
+        mock_proc.kill.assert_called_once()
+        mock_proc.waitForFinished.assert_called_once_with(1000)
 
 
 if __name__ == "__main__":

tests/test_terminal_encoding.py

@@ -85,6 +85,40 @@ def test_set_working_dir_uses_same_encoding_as_execute_command(self):
                          "set_working_dir() muss denselben cp1252-Encoding-Pfad wie _execute_command() nutzen")
         widget.close()
 
+    @unittest.skipUnless(sys.platform == "win32", "Windows-only")
+    def test_set_working_dir_powershell_does_not_use_d_flag(self):
+        """Regression: PowerShell kennt keinen /d Schalter für Set-Location/cd.
+        set_working_dir() muss für PowerShell 'cd \"path\"' ohne '/d' senden."""
+        widget = self._make_widget("powershell")
+
+        from PySide6.QtCore import QProcess
+        written = []
+        mock_proc = MagicMock()
+        mock_proc.state.return_value = QProcess.ProcessState.Running
+        mock_proc.write.side_effect = lambda data: written.append(data)
+        widget.process = mock_proc
+
+        path = "C:/Projects/CodeBox"
+        widget.set_working_dir(path)
+
+        self.assertEqual(len(written), 1)
+        encoded_cmd = written[0]
+        expected = f'cd "{path}"\n'.encode("utf-8", errors="replace")
+        self.assertEqual(encoded_cmd, expected,
+                         "PowerShell darf keinen /d-Schalter erhalten")
+        widget.close()
+
+    @unittest.skipUnless(sys.platform == "win32", "Windows-only")
+    def test_output_encoding_matches_shell(self):
+        """_output_encoding() muss für cmd cp1252 und für PowerShell utf-8 liefern."""
+        widget_cmd = self._make_widget("cmd")
+        self.assertEqual(widget_cmd._output_encoding(), "cp1252")
+        widget_cmd.close()
+
+        widget_ps = self._make_widget("powershell")
+        self.assertEqual(widget_ps._output_encoding(), "utf-8")
+        widget_ps.close()
+
 
 class TerminalStartShellTests(unittest.TestCase):
     """Regressionstests für _start_shell() Signal-Verwaltung (B-012)."""
@@ -117,6 +151,7 @@ def test_start_shell_disconnects_old_process_signals(self):
         mock_old.readyReadStandardOutput.disconnect.assert_called_once_with()
         mock_old.readyReadStandardError.disconnect.assert_called_once_with()
         mock_old.finished.disconnect.assert_called_once_with()
+        mock_old.errorOccurred.disconnect.assert_called_once_with()
         mock_old.kill.assert_called_once()
         widget.close()
 
@@ -151,6 +186,14 @@ def test_start_shell_no_disconnect_when_no_prior_process(self):
         # Kein AttributeError, kein Kill-Aufruf — Test besteht wenn kein Fehler
         widget.close()
 
+    def test_terminal_on_error_failed_to_start(self):
+        """errorOccurred mit FailedToStart soll eine Fehlermeldung ausgeben."""
+        from PySide6.QtCore import QProcess
+        widget = self._make_widget_no_shell()
+        widget._on_error(QProcess.ProcessError.FailedToStart)
+        self.assertIn("Fehler: Shell konnte nicht gestartet werden", widget.output.toPlainText())
+        widget.close()
+
 
 if __name__ == "__main__":
     unittest.main()