chore: add CloudLockFixer test workflow

Author: Lukas Geiger

.github/workflows/tests.yml

@@ -0,0 +1,40 @@
+name: CloudLockFixer tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  tests:
+    runs-on: windows-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v6
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -r requirements.txt pytest
+
+      - name: Run tests
+        env:
+          PYTHONPATH: src
+          PYTHONIOENCODING: utf-8
+        run: python -m pytest -q

CHANGELOG.md

@@ -6,7 +6,14 @@ Format basiert auf [Keep a Changelog](https://keepachangelog.com/de/1.1.0/).
 ## [Unreleased]
 
 ### Hinzugefügt / Added
--
+- GitHub Actions workflow for Windows smoke tests on Python 3.10, 3.11 and 3.12.
+- `llms.txt` with canonical machine-readable project context.
+
+### Geändert / Changed
+- Roadmap and README test counts now reflect the current i18n and multicloud implementation.
+
+### Behoben / Fixed
+- Locale detection no longer uses Python's deprecated `locale.getdefaultlocale()`.
 
 ## [1.0.0] - 2026-05-30
 

README.de.md

@@ -87,7 +87,7 @@ automatisch zu `#>` auskommentiert.
 - **P3 (fertig):** Präventiv-Wächter (Änderungsrate *konfigurierter* Ordner
   beobachten → Sync-Client automatisch pausieren/fortsetzen; bounded + stat-only,
   hydratisiert keine Online-only-Placeholder; opt-in).
-- **Tests:** `pytest`, **17 grün** (Core + P2/P3 + Regressionen).
+- **Tests:** `pytest`, **49 grün** (Core + P2/P3 + i18n + Multicloud-Regressionen).
 - **Im Lifetest gehärtet (2026-05-29):** `is_running()/pause()` robust gegen
   nicht-UTF-8-`tasklist`-Ausgabe; `delete` entfernt read-only-Attribute statt an
   WinError 5 zu scheitern. Erster echter Einsatz: ein Ordner-Rename, den manuelle

README.md

@@ -88,7 +88,7 @@ automatically commented out with `#>`.
 - **P3 (done):** Preventive watcher (observes the change rate of *configured*
   folders → pauses/resumes the sync client; bounded, stat-only, does not
   hydrate online-only placeholders; opt-in).
-- **Tests:** `pytest`, 17 passing (core + P2/P3 + regressions).
+- **Tests:** `pytest`, 49 passing (core + P2/P3 + i18n + multicloud regressions).
 - **Open/future:** more provider adapters (Dropbox / Google Drive / iCloud);
   optional suppression of sync-client relaunch during long operations.
 

ROADMAP.md

@@ -12,22 +12,22 @@
 - Autostart via Registry
 - PyInstaller-Build
 
-## v1.1.0 — i18n + Bugfixes (aktuell)
+## v1.1.0 — i18n + Bugfixes (erledigt)
 
 - [x] Bugfixes: Verify-Cleanup, Watcher-Resume, Queue-Race-Condition
-- [ ] Internationalisierung: Deutsch + Englisch
-- [ ] Sprachauswahl im Tray-Menü (de/en/auto)
-- [ ] Systemsprache-Erkennung via locale
-
-## v1.2.0 — Windows Multicloud
-
-- [ ] Google Drive Provider (GoogleDriveFS, virtueller Mount)
-- [ ] Dropbox Provider
-- [ ] iCloud Provider
-- [ ] Auto-Discovery installierter Cloud-Sync-Clients
-- [ ] Dynamische Provider-Anzeige im Tray
-- [ ] Virtual-mount Guard (kein Pause für gemountete Laufwerke)
-- [ ] Multi-Provider Präventiv-Wächter
+- [x] Internationalisierung: Deutsch + Englisch
+- [x] Sprachauswahl im Tray-Menü (de/en/auto)
+- [x] Systemsprache-Erkennung via locale
+
+## v1.2.0 — Windows Multicloud (erledigt)
+
+- [x] Google Drive Provider (GoogleDriveFS, virtueller Mount)
+- [x] Dropbox Provider
+- [x] iCloud Provider
+- [x] Auto-Discovery installierter Cloud-Sync-Clients
+- [x] Dynamische Provider-Anzeige im Tray
+- [x] Virtual-mount Guard (kein Pause für gemountete Laufwerke)
+- [x] Multi-Provider Präventiv-Wächter
 
 ## v2.0.0 — Cross-Platform
 

TODO.md

@@ -30,8 +30,17 @@
 - [x] ROADMAP.md (langfristige Planung)
 - [x] PORTIERUNGSPLAN.md (Linux/macOS)
 
+## Erkenntnisse aus MCP-Integration (2026-05-31)
+
+Beim Port der copy+delete-Logik in den ellmos-filecommander-mcp-Server (TypeScript) wurden folgende Punkte entdeckt:
+
+- [ ] **EBUSY als Fehlercode aufnehmen:** Windows gibt bei File-Locks durch andere Prozesse (inkl. Cloud-Sync) `EBUSY` zurück, nicht nur EPERM/EACCES. CLFs `ops.py` sollte EBUSY in die Retry-Trigger-Codes aufnehmen (aktuell nur EXDEV + Access Denied).
+- [ ] **Delete-nach-Copy bei aktivem Lock:** Wenn die Kopie erfolgreich ist aber das Löschen des Originals mit EBUSY scheitert (Datei noch vom Sync-Client gehalten), ist das ein Teilerfolg. CLF handhabt das bereits via Queue-Retry — aber der Status sollte explizit als "kopiert, Löschung ausstehend" im queue.txt sichtbar sein.
+- [ ] **Verzeichnis-Rename mit gelockter Innendatei:** Bei `fs.rename()` auf ein Verzeichnis, dessen Inhalt einen gelockten File enthält, gibt Windows EPERM (nicht EBUSY). Die copy+delete-Strategie funktioniert hier korrekt (rekursives Kopieren + rekursives Löschen), aber das Löschen des Quellverzeichnisses scheitert wenn eine Innendatei noch gelockt ist. CLFs `ops.py` sollte diesen Fall explizit behandeln.
+
 ## Nächste Schritte (aus ROADMAP.md)
 
+- [ ] Test-CI beobachten und bei Bedarf Windows-spezifische Runtime-Abhängigkeiten ergänzen
 - [ ] Cross-Platform: Linux-Support (siehe PORTIERUNGSPLAN.md)
 - [ ] Cross-Platform: macOS-Support (siehe PORTIERUNGSPLAN.md)
 - [ ] Weitere Provider: Box, Nextcloud, pCloud, Synology Drive

llms.txt

@@ -0,0 +1,29 @@
+# CloudLockFixer
+
+CloudLockFixer is a Windows tray and CLI tool for delayed rename, move and delete
+operations in cloud-sync folders. It is designed for OneDrive, Dropbox, Google
+Drive and iCloud folders where Windows Cloud Files locks can make normal file
+operations fail.
+
+Canonical repository: https://github.com/file-bricks/CloudLockFixer
+
+Primary interfaces:
+- Tray app: `START.bat` or `PYTHONPATH=src python -m cloudlockfixer`
+- CLI: `PYTHONPATH=src python -m cloudlockfixer.cli`
+- Queue file: `%LOCALAPPDATA%\CloudLockFixer\queue.txt`
+- Tests: `PYTHONPATH=src python -m pytest -q`
+
+Safety boundaries:
+- The tool performs destructive filesystem operations only after queued user or
+  script instructions.
+- Move and rename operations use copy, verify and delete fallback logic so that
+  deletion happens only after a verified copy.
+- Runtime queues, logs and local credentials are not part of the repository.
+
+Key files:
+- `README.md`: English user overview and quickstart
+- `README.de.md`: German user overview and quickstart
+- `docs/DESIGN.md`: design and safety model
+- `src/cloudlockfixer/ops.py`: copy/delete and retry-safe filesystem operations
+- `src/cloudlockfixer/providers.py`: cloud provider detection and pause policy
+- `tests/`: regression tests for core, i18n, provider and tray-adjacent behavior

src/cloudlockfixer/i18n.py

@@ -290,7 +290,7 @@
 def detect_language() -> Language:
     """Sprache aus System-Locale ableiten (Fallback: Deutsch)."""
     try:
-        lang, _ = locale.getdefaultlocale()
+        lang, _ = locale.getlocale()
         if lang and lang.lower().startswith("en"):
             return "en"
     except (ValueError, TypeError):

tests/test_i18n.py

@@ -59,17 +59,17 @@ def test_format_missing_param_returns_template():
 
 
 def test_detect_language_german(monkeypatch):
-    monkeypatch.setattr("locale.getdefaultlocale", lambda: ("de_DE", "UTF-8"))
+    monkeypatch.setattr("locale.getlocale", lambda: ("de_DE", "UTF-8"))
     assert detect_language() == "de"
 
 
 def test_detect_language_english(monkeypatch):
-    monkeypatch.setattr("locale.getdefaultlocale", lambda: ("en_US", "UTF-8"))
+    monkeypatch.setattr("locale.getlocale", lambda: ("en_US", "UTF-8"))
     assert detect_language() == "en"
 
 
 def test_detect_language_fallback(monkeypatch):
-    monkeypatch.setattr("locale.getdefaultlocale", lambda: (None, None))
+    monkeypatch.setattr("locale.getlocale", lambda: (None, None))
     assert detect_language() == "de"
 
 
@@ -80,7 +80,7 @@ def test_available_keys_sorted():
 
 
 def test_resolve_language_auto(monkeypatch):
-    monkeypatch.setattr("locale.getdefaultlocale", lambda: ("en_US", "UTF-8"))
+    monkeypatch.setattr("locale.getlocale", lambda: ("en_US", "UTF-8"))
     assert resolve_language({"language": "auto"}) == "en"