nightly: 0.9.27-nightly5

- Workflows: docker-publish.yml → nightly.yml + release.yml + pr-check.yml
  (nightly: Branch-Push + Cron 02:00, release: v*-Tag, pr-check: lint+tests)
- Issue-Templates: bug_report.md + feature_request.md (englisch)
- PR-Template: pull_request_template.md (englisch)
- Claude-Agenten: reviewer, changelog, test-writer, nightly-prep,
  docker-check, moonraker-debug + settings.json
- agents.md: Agenten-Übersicht im Repo-Root
- .gitignore: .runner-token + secrets/ ausgeschlossen

.claude/agents/changelog.md

@@ -0,0 +1,31 @@
+---
+name: KX-Bridge Changelog
+description: Generiert einen CHANGELOG.md Eintrag aus Git-Commits seit dem letzten Tag.
+tools:
+  - run_command
+  - read_file
+  - write_file
+---
+
+Du generierst CHANGELOG.md Einträge für KX-Bridge.
+
+Vorgehen:
+1. Führe aus: `git log $(git describe --tags --abbrev=0)..HEAD --oneline`
+2. Gruppiere Commits nach Präfix: feat → Neu, fix → Behoben, chore/refactor/docs → Geändert
+3. Frage nach der Versionsnummer (SemVer: feat→MINOR, fix→PATCH, breaking→MAJOR)
+4. Schreibe den Abschnitt im Format:
+
+```
+## [VERSION] - DATUM
+
+### Neu
+- ...
+
+### Behoben
+- ...
+
+### Geändert
+- ...
+```
+
+5. Füge den Abschnitt am Anfang der bestehenden CHANGELOG.md ein, ohne vorhandene Einträge zu ändern.

.claude/agents/docker-check.md

@@ -0,0 +1,32 @@
+---
+name: KX-Bridge Docker Check
+description: Prüft Dockerfile, docker-compose und das gebaute Image auf häufige Probleme.
+tools:
+  - read_file
+  - run_command
+  - search_files
+---
+
+Du prüfst die Docker-Konfiguration von KX-Bridge.
+
+**Dockerfile:**
+- Base-Image aktuell? (`python:3.11-slim` oder neuer)
+- `.dockerignore` vorhanden und vollständig?
+- Keine Secrets oder Zertifikate im Image (`anycubic_slicer.crt/.key` darf NICHT eingebettet sein)
+- Healthcheck vorhanden?
+- Kein `COPY . .` ohne `.dockerignore`
+
+**docker-compose.yml:**
+- Port 7125 korrekt gemappt
+- Config-Volume gemountet (`/app/config`)
+- `restart: unless-stopped` gesetzt
+- Logging-Limits konfiguriert (`max-size`, `max-file`)
+
+**Image-Check (falls lokal vorhanden):**
+```bash
+docker image inspect gitea.it-drui.de/viewit/kx-bridge:nightly
+```
+- Image-Größe sinnvoll (< 500MB)?
+- Keine privaten Keys eingebettet: `docker history --no-trunc`
+
+Berichte nach Schweregrad: Kritisch / Warnung / Hinweis.

.claude/agents/moonraker-debug.md

@@ -0,0 +1,23 @@
+---
+name: KX-Bridge Moonraker Debug
+description: Analysiert Moonraker/Klipper Logs und KX-Bridge Ausgaben auf Fehlerursachen.
+tools:
+  - read_file
+  - search_files
+---
+
+Du analysierst Logs für KX-Bridge im Kontext Moonraker/Klipper/AFC.
+
+**Bekannte Problemquellen:**
+- AFC lane_data Indizierung: korrekt ist `lane1`–`lane4` (flat), nicht Slot 0–3
+- `filament_id` muss als String übertragen werden, nicht als Integer
+- Moonraker WebSocket trennt bei Inaktivität → keep-alive prüfen
+- OrcaSlicer sendet Bambu MQTT Format → KX-Bridge muss übersetzen
+- ACE 2 Pro meldet Fehler wenn Lane leer aber als belegt markiert ist
+- MQTT mTLS: Zertifikat muss neben dem Binary liegen (`anycubic_slicer.crt/.key`)
+
+**Bei einem Log:**
+1. Identifiziere den **ersten** Fehler (nicht den letzten Symptom)
+2. Zeige den relevanten Log-Kontext (±10 Zeilen um den Fehler)
+3. Nenne die wahrscheinliche Ursache
+4. Schlage einen konkreten Fix vor (Datei + Funktion wenn möglich)

.claude/agents/nightly-prep.md

@@ -0,0 +1,25 @@
+---
+name: KX-Bridge Nightly Prep
+description: Bereitet den PR von nightly nach main vor. Prüft ob alle Voraussetzungen für ein Stable Release erfüllt sind.
+tools:
+  - run_command
+  - read_file
+---
+
+Du bereitest einen nightly → main Merge für KX-Bridge vor.
+
+Führe folgende Checks aus und berichte:
+
+1. `git log main..nightly --oneline` → alle Commits die noch nicht in main sind
+2. `git diff main..nightly -- CHANGELOG.md` → ist CHANGELOG.md für alle Änderungen aktualisiert?
+3. Prüfe ob `tests/` alle geänderten Module abdeckt
+4. Prüfe ob Dockerfile ein aktuelles Base-Image verwendet
+5. Schlage eine SemVer-Versionsnummer vor:
+   - `feat:` Commits → MINOR erhöhen
+   - `fix:` Commits → PATCH erhöhen
+   - Breaking Change im Commit-Body → MAJOR erhöhen
+
+Abschlussbericht:
+- ✅ Bereit für Release
+- ⚠️ Offen: [Liste]
+- ❌ Blockiert durch: [Grund]

.claude/agents/reviewer.md

@@ -0,0 +1,24 @@
+---
+name: KX-Bridge Reviewer
+description: Reviewt geänderte Dateien vor einem PR auf nightly. Prüft Logik, Fehlerbehandlung, Moonraker-Kompatibilität und Stil.
+tools:
+  - read_file
+  - list_directory
+  - search_files
+---
+
+Du bist Code-Reviewer für KX-Bridge — eine Python-Bridge zwischen OrcaSlicer und Moonraker/Klipper für den Anycubic Kobra X.
+
+Beim Review prüfst du:
+- Korrekte Fehlerbehandlung bei Moonraker HTTP/MQTT Calls (keine unbehandelten Exceptions)
+- Keine hardcodierten IPs oder Ports (müssen aus config.ini kommen)
+- Thread-Sicherheit bei parallelen Moonraker-Abfragen (asyncio korrekt verwendet)
+- AFC lane_data Struktur: flache Indizierung lane1–lane4, kein Slot-Mapping 0–3
+- Kein `print()` statt `logging` (außer in CLI-Hilfsfunktionen)
+- Typ-Annotationen vorhanden, Python 3.8+ kompatibel (kein `X | Y` Syntax)
+- Tests für neue öffentliche Funktionen vorhanden
+
+Ausgabeformat:
+1. **Kritische Fehler** — blockieren den Merge
+2. **Warnungen** — sollten vor Merge behoben werden
+3. **Hinweise** — optional, für zukünftige Verbesserungen

.claude/agents/test-writer.md

@@ -0,0 +1,26 @@
+---
+name: KX-Bridge Test Writer
+description: Leitet pytest-Tests aus geänderten oder neuen Python-Dateien ab.
+tools:
+  - read_file
+  - write_file
+  - list_directory
+  - search_files
+---
+
+Du schreibst pytest-Tests für KX-Bridge.
+
+Kontext:
+- Moonraker API läuft auf Port 7125 (HTTP + WebSocket)
+- AFC lane_data: flache Indizierung lane1–lane4
+- Externe HTTP-Calls zu Moonraker werden mit `unittest.mock` gemockt
+- Python 3.8+ Kompatibilität (kein `X | Y` Union-Syntax)
+
+Für jede zu testende Funktion schreibst du:
+1. Happy Path (Normalfall mit validen Eingaben)
+2. Fehlerfall (Moonraker nicht erreichbar, Timeout, falsche Antwort)
+3. Grenzwerte (leere lane_data, ungültige filament_id, None-Werte)
+
+Dateiname: `tests/test_<modulname>.py`
+Verwende pytest-Fixtures für Moonraker-Mock-Responses.
+Keine echten Netzwerkaufrufe in Tests.

.claude/settings.json

@@ -0,0 +1,12 @@
+{
+  "project": "KX-Bridge",
+  "language": "de",
+  "defaultAgent": "reviewer",
+  "context": {
+    "repoBase": "gitea.it-drui.de/viewit/KX-Bridge-Release",
+    "defaultBranch": "nightly",
+    "stableBranch": "main",
+    "registry": "gitea.it-drui.de/viewit/kx-bridge",
+    "moonrakerPort": 7125
+  }
+}

.gitea/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,29 @@
+---
+name: Bug Report
+about: Report a bug in KX-Bridge
+labels: bug
+---
+
+## Description
+<!-- What is happening? -->
+
+## Steps to Reproduce
+1.
+2.
+3.
+
+## Expected Behavior
+
+## Actual Behavior
+
+## Environment
+- KX-Bridge Version:
+- OrcaSlicer Version:
+- Moonraker/Klipper Version:
+- Operating System:
+- Installation: Docker / Binary
+
+## Logs
+```
+<!-- docker logs kx-bridge --tail 50 -->
+```

.gitea/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,14 @@
+---
+name: Feature Request
+about: Suggest a new feature or improvement
+labels: enhancement
+---
+
+## Description
+<!-- What should be added or improved? -->
+
+## Motivation
+<!-- Why is this useful? What problem does it solve? -->
+
+## Proposed Implementation
+<!-- Optional: How could this be implemented technically? -->

.gitea/pull_request_template.md

@@ -0,0 +1,21 @@
+## Description
+<!-- What does this PR change? -->
+
+## Related Issue
+Closes #
+
+## Type
+- [ ] Bug fix
+- [ ] Feature
+- [ ] Documentation
+- [ ] Refactoring
+
+## Tested with
+- OrcaSlicer Version:
+- Printer:
+- Moonraker/Klipper Version:
+
+## Checklist
+- [ ] Tests added/updated
+- [ ] CHANGELOG.md updated
+- [ ] No debug code included

.gitea/workflows/nightly.yml

@@ -0,0 +1,132 @@
+name: Nightly Build
+
+on:
+  push:
+    branches:
+      - nightly
+    paths:
+      - '**.py'
+      - 'Dockerfile'
+      - 'requirements.txt'
+      - 'web/**'
+      - 'data/**'
+  schedule:
+    - cron: '0 2 * * *'
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: server-runner
+    steps:
+      - name: Checkout
+        run: |
+          if [ -d .git ]; then
+            git fetch origin nightly
+            git reset --hard origin/nightly
+            git clean -fd
+          else
+            git clone --depth=1 --branch nightly https://gitea.it-drui.de/viewit/KX-Bridge-Release.git .
+          fi
+
+      - name: Install Docker CLI
+        run: |
+          if ! command -v docker >/dev/null 2>&1; then
+            ARCH=$(uname -m)
+            if [ "$ARCH" = "x86_64" ]; then
+              DARCH="x86_64"
+              BARCH="amd64"
+            else
+              DARCH="aarch64"
+              BARCH="arm64"
+            fi
+            wget -qO- "https://download.docker.com/linux/static/stable/${DARCH}/docker-27.5.1.tgz" \
+              | tar xz --strip-components=1 -C /usr/local/bin docker/docker
+            chmod +x /usr/local/bin/docker
+            mkdir -p /usr/local/lib/docker/cli-plugins
+            wget -qO /usr/local/lib/docker/cli-plugins/docker-buildx \
+              "https://github.com/docker/buildx/releases/download/v0.23.0/buildx-v0.23.0.linux-${BARCH}"
+            chmod +x /usr/local/lib/docker/cli-plugins/docker-buildx
+          fi
+          docker version --format '{{.Client.Version}}'
+
+      - name: Set up QEMU
+        run: |
+          docker run --rm --privileged tonistiigi/binfmt:latest --install all
+
+      - name: Set up buildx
+        run: |
+          docker buildx inspect kxbuilder 2>/dev/null || \
+            docker buildx create --name kxbuilder --use
+          docker buildx use kxbuilder
+
+      - name: Login to Gitea registry
+        run: |
+          echo "${{ secrets.REGISTRY_TOKEN }}" | \
+            docker login gitea.it-drui.de -u "${{ secrets.REGISTRY_USER }}" --password-stdin
+
+      - name: Build & push (amd64 + arm64)
+        run: |
+          VERSION=$(cat VERSION)
+          docker buildx build \
+            --platform linux/amd64,linux/arm64 \
+            --push \
+            --provenance=false \
+            --no-cache \
+            -t "gitea.it-drui.de/viewit/kx-bridge:nightly" \
+            -t "gitea.it-drui.de/viewit/kx-bridge:nightly-${VERSION}" \
+            .
+
+      - name: Create Gitea Nightly Release
+        env:
+          GITEA_TOKEN: ${{ secrets.RELEASE_TOKEN }}
+        run: |
+          VERSION=$(cat VERSION)
+          TAG="nightly-${VERSION}"
+          git config user.name "gitea-actions"
+          git config user.email "actions@it-drui.de"
+
+          # Letzten nightly-Tag finden (für Changelog-Range)
+          git fetch --tags origin 2>/dev/null || true
+          PREV_TAG=$(git tag | grep '^nightly-' | sort | tail -1)
+
+          # Commits seit letztem Tag sammeln
+          if [ -n "$PREV_TAG" ]; then
+            COMMITS=$(git log "${PREV_TAG}..HEAD" --pretty=format:"- %s" --no-merges 2>/dev/null || true)
+          else
+            COMMITS=$(git log --pretty=format:"- %s" --no-merges -20 2>/dev/null || true)
+          fi
+          [ -z "$COMMITS" ] && COMMITS="- Automatischer Nightly-Build"
+
+          # Body in Temp-Datei (vermeidet YAML-Probleme mit Sonderzeichen wie > oder ```)
+          BODY_FILE=$(mktemp)
+          printf '## KX-Bridge %s -- Nightly Build\n\n' "$VERSION" > "$BODY_FILE"
+          printf '[experimentell] Ungetestete Features, nur fuer Tester geeignet.\n\n' >> "$BODY_FILE"
+          printf '### Aenderungen seit `%s`\n\n' "${PREV_TAG:-erstem Commit}" >> "$BODY_FILE"
+          printf '%s\n\n---\n\n' "$COMMITS" >> "$BODY_FILE"
+          printf '### Docker-Image aktualisieren\n\n```bash\ndocker compose pull && docker compose up -d\n```\n\n' >> "$BODY_FILE"
+          printf 'Image-Tag: `gitea.it-drui.de/viewit/kx-bridge:nightly`\n' >> "$BODY_FILE"
+
+          # Tag setzen
+          git tag -f "$TAG"
+          git push https://gitea-actions:${GITEA_TOKEN}@gitea.it-drui.de/viewit/KX-Bridge-Release.git "$TAG" --force
+
+          # Altes Release loeschen falls vorhanden
+          wget -q --method=DELETE \
+            --header="Authorization: token ${GITEA_TOKEN}" \
+            "https://gitea.it-drui.de/api/v1/repos/viewit/KX-Bridge-Release/releases/tags/${TAG}" \
+            2>/dev/null || true
+
+          # Release erstellen (JSON-Body via awk escapen, kein python3/curl nötig)
+          BODY_JSON=$(awk '{
+            gsub(/\\/, "\\\\"); gsub(/"/, "\\\""); gsub(/\t/, "\\t");
+            printf "%s\\n", $0
+          }' "$BODY_FILE" | awk 'BEGIN{printf "\""} {printf "%s", $0} END{printf "\""}')
+          JSON_PAYLOAD="{\"tag_name\":\"${TAG}\",\"name\":\"KX-Bridge ${VERSION} Nightly\",\"body\":${BODY_JSON},\"draft\":false,\"prerelease\":true}"
+          printf '%s' "$JSON_PAYLOAD" > /tmp/release_body.json
+          wget -q -O- \
+            --method=POST \
+            --header="Authorization: token ${GITEA_TOKEN}" \
+            --header="Content-Type: application/json" \
+            --body-file=/tmp/release_body.json \
+            "https://gitea.it-drui.de/api/v1/repos/viewit/KX-Bridge-Release/releases"
+          rm -f "$BODY_FILE" /tmp/release_body.json

.gitea/workflows/pr-check.yml

@@ -0,0 +1,34 @@
+name: PR Check
+
+on:
+  pull_request:
+    branches:
+      - nightly
+
+jobs:
+  lint-and-test:
+    runs-on: server-runner
+    steps:
+      - name: Checkout
+        run: |
+          if [ -d .git ]; then
+            git fetch origin
+            git reset --hard origin/nightly
+            git clean -fd
+          else
+            git clone --depth=1 --branch nightly https://gitea.it-drui.de/viewit/KX-Bridge-Release.git .
+          fi
+
+      - name: Dependencies installieren
+        run: pip3 install -r requirements.txt
+
+      - name: Lint
+        run: |
+          pip3 install flake8
+          flake8 *.py --max-line-length=120 --extend-ignore=E501
+
+      - name: Tests
+        run: |
+          pip3 install pytest
+          pytest tests/ -v
+        if: ${{ hashFiles('tests/') != '' }}

.gitea/workflows/release.yml

@@ -0,0 +1,87 @@
+name: Stable Release
+
+on:
+  push:
+    tags:
+      - 'v[0-9]+.[0-9]+.[0-9]+'
+
+jobs:
+  release:
+    runs-on: server-runner
+    steps:
+      - name: Checkout
+        run: |
+          TAG="${GITHUB_REF#refs/tags/}"
+          if [ -d .git ]; then
+            git fetch --tags origin
+            git checkout "$TAG"
+            git clean -fd
+          else
+            git clone --depth=1 --branch "$TAG" https://gitea.it-drui.de/viewit/KX-Bridge-Release.git .
+          fi
+
+      - name: Install Docker CLI
+        run: |
+          if ! command -v docker >/dev/null 2>&1; then
+            ARCH=$(uname -m)
+            if [ "$ARCH" = "x86_64" ]; then
+              DARCH="x86_64"
+              BARCH="amd64"
+            else
+              DARCH="aarch64"
+              BARCH="arm64"
+            fi
+            wget -qO- "https://download.docker.com/linux/static/stable/${DARCH}/docker-27.5.1.tgz" \
+              | tar xz --strip-components=1 -C /usr/local/bin docker/docker
+            chmod +x /usr/local/bin/docker
+            mkdir -p /usr/local/lib/docker/cli-plugins
+            wget -qO /usr/local/lib/docker/cli-plugins/docker-buildx \
+              "https://github.com/docker/buildx/releases/download/v0.23.0/buildx-v0.23.0.linux-${BARCH}"
+            chmod +x /usr/local/lib/docker/cli-plugins/docker-buildx
+          fi
+          docker version --format '{{.Client.Version}}'
+
+      - name: Set up QEMU
+        run: |
+          docker run --rm --privileged tonistiigi/binfmt:latest --install all
+
+      - name: Set up buildx
+        run: |
+          docker buildx inspect kxbuilder 2>/dev/null || \
+            docker buildx create --name kxbuilder --use
+          docker buildx use kxbuilder
+
+      - name: Login to Gitea registry
+        run: |
+          echo "${{ secrets.REGISTRY_TOKEN }}" | \
+            docker login gitea.it-drui.de -u "${{ secrets.REGISTRY_USER }}" --password-stdin
+
+      - name: Build & push (amd64 + arm64)
+        run: |
+          VERSION="${GITHUB_REF#refs/tags/}"
+          docker buildx build \
+            --platform linux/amd64,linux/arm64 \
+            --push \
+            --provenance=false \
+            --no-cache \
+            -t "gitea.it-drui.de/viewit/kx-bridge:latest" \
+            -t "gitea.it-drui.de/viewit/kx-bridge:${VERSION}" \
+            .
+
+      - name: Create Gitea Release
+        env:
+          GITEA_TOKEN: ${{ secrets.RELEASE_TOKEN }}
+        run: |
+          VERSION="${GITHUB_REF#refs/tags/}"
+          CHANGELOG=$(awk "/^## \[${VERSION}\]/{found=1; next} found && /^## \[/{exit} found{print}" CHANGELOG.md || echo "")
+          curl -s -X POST \
+            -H "Authorization: token ${GITEA_TOKEN}" \
+            -H "Content-Type: application/json" \
+            "https://gitea.it-drui.de/api/v1/repos/viewit/KX-Bridge-Release/releases" \
+            -d "{
+              \"tag_name\": \"${VERSION}\",
+              \"name\": \"KX-Bridge ${VERSION}\",
+              \"body\": $(echo "$CHANGELOG" | python3 -c 'import sys,json; print(json.dumps(sys.stdin.read()))'),
+              \"draft\": false,
+              \"prerelease\": false
+            }"

.gitignore

@@ -17,3 +17,4 @@ config/*.ini
 data/
 
 !data/orca_filaments.json
+.runner-token

.runner-token

@@ -1 +0,0 @@
-GITEA_RUNNER_TOKEN=YF9I7H3BI5ovPnMC7iU2I86Hga8dcWUakqH9qT85

CONTRIBUTING.md

@@ -0,0 +1,102 @@
+# Contributing to KX-Bridge
+
+Thanks for taking the time to contribute! Here's everything you need to know.
+
+---
+
+## How to report a bug or request a feature
+
+Use the issue tracker:
+
+- **Bug:** [New Bug Report](https://gitea.it-drui.de/viewit/KX-Bridge-Release/issues/new?template=bug_report.md)
+- **Feature:** [New Feature Request](https://gitea.it-drui.de/viewit/KX-Bridge-Release/issues/new?template=feature_request.md)
+
+Please fill in the template — especially the **KX-Bridge version** and **logs**.  
+Issues without version info are hard to debug.
+
+---
+
+## How to submit a Pull Request
+
+### 1. Fork the repository
+
+Click **Fork** at the top of this page.  
+You now have your own copy at `gitea.it-drui.de/your-username/KX-Bridge-Release`.
+
+### 2. Clone your fork
+
+```bash
+git clone https://gitea.it-drui.de/your-username/KX-Bridge-Release.git
+cd KX-Bridge-Release
+```
+
+### 3. Create a branch
+
+Always branch off `nightly`:
+
+```bash
+git checkout nightly
+git checkout -b feature/my-feature   # or fix/my-fix
+```
+
+### 4. Make your changes
+
+- Test your changes locally with Docker:
+  ```bash
+  docker build -t kx-bridge:dev .
+  docker run -p 7125:7125 -v ./config:/app/config kx-bridge:dev
+  ```
+- No debug `print()` statements — use `logging`
+- Keep commits focused; one thing per commit
+
+### 5. Push and open a PR
+
+```bash
+git push origin feature/my-feature
+```
+
+Gitea will show a banner — click **"Create Pull Request"**.  
+The PR template will be pre-filled. Set the target branch to **`nightly`**.
+
+---
+
+## Branch model
+
+```
+main      ← stable releases only (merged by maintainer)
+nightly   ← integration branch — PRs go here
+feature/* ← your feature branch (in your fork)
+fix/*     ← your bugfix branch (in your fork)
+```
+
+Your PR always targets `nightly`. The maintainer periodically merges `nightly → main` for a new stable release.
+
+---
+
+## Commit style
+
+Use conventional commit prefixes:
+
+| Prefix | When |
+|---|---|
+| `feat:` | new feature |
+| `fix:` | bug fix |
+| `docs:` | documentation only |
+| `chore:` | maintenance, dependencies |
+| `refactor:` | code change without new feature or fix |
+
+Example: `fix: prevent crash when printer is offline during startup`
+
+---
+
+## Language
+
+- **Code and comments:** English
+- **Issue comments:** match the language of the issue (if someone writes in German, reply in German)
+- **Commit messages:** English
+
+---
+
+## Questions?
+
+Open a [Discussion](https://gitea.it-drui.de/viewit/KX-Bridge-Release/issues) or leave a comment on the relevant issue.

README.es.md

@@ -14,6 +14,15 @@ ninguna está oficialmente probada ni soportada. Se agradece el feedback.</sub>
 
 <sub>🇬🇧 <a href="README.md">English version</a>  ·  🇩🇪 <a href="README.de.md">Deutsche Version</a></sub>
 
+</div>
+
+> [!CAUTION]
+> **Trabajos de mantenimiento en curso esta semana** — Estamos reestructurando el repositorio (modelo de ramas, flujos CI, proceso de contribución). Es posible que notes cambios en los nombres de ramas, plantillas de PR y la forma en que se publican las versiones. Pedimos disculpas por los inconvenientes. El manejo, el flujo de trabajo y la mantenibilidad a largo plazo mejorarán significativamente como resultado.
+>
+> 👉 ¿Quieres contribuir? Por favor lee primero [CONTRIBUTING.md](CONTRIBUTING.md).
+
+<div align="center">
+
 <br>
 
 [![Ko-fi](https://img.shields.io/badge/Ko--fi-Apoya%20este%20proyecto-FF5E5B?style=for-the-badge&logo=ko-fi&logoColor=white)](https://ko-fi.com/viewitde)
@@ -130,11 +139,6 @@ Impresora → Tipo de conexión **Moonraker** → Host: `http://IP-DEL-PUENTE:71
 
 ---
 
-## 📺 Vídeo tutorial
-
-[![Configuración y uso de KX-Bridge](https://img.youtube.com/vi/1Ql4wfH27fM/hqdefault.jpg)](https://www.youtube.com/watch?v=1Ql4wfH27fM)
-
----
 
 ## 🎨 Slicer recomendado
 

VERSION

@@ -1 +1 @@
-0.9.27-nightly3
+0.9.27-nightly5

agents.md

@@ -0,0 +1,31 @@
+# KX-Bridge Claude Agents
+
+## Available Agents
+
+| Agent | File | When to use |
+|---|---|---|
+| Reviewer | `.claude/agents/reviewer.md` | Before every PR — checks logic, error handling, Moonraker compatibility |
+| Changelog | `.claude/agents/changelog.md` | After merge to nightly — generates CHANGELOG.md entry from commits |
+| Test Writer | `.claude/agents/test-writer.md` | When adding new functions — derives pytest tests |
+| Nightly Prep | `.claude/agents/nightly-prep.md` | Before a release — checks readiness of nightly → main merge |
+| Docker Check | `.claude/agents/docker-check.md` | Before image push — validates Dockerfile and compose config |
+| Moonraker Debug | `.claude/agents/moonraker-debug.md` | On runtime errors — analyzes Moonraker/Klipper logs |
+
+## Usage
+
+In VS Code with Claude Code extension:
+```
+@reviewer     → code review of current changes
+@changelog    → generate CHANGELOG entry
+@test-writer  → write tests for changed files
+@nightly-prep → check release readiness
+@docker-check → validate Docker config
+@moonraker-debug → analyze logs
+```
+
+## Context
+
+- Moonraker API: Port 7125
+- AFC lane_data: flat indexing lane1–lane4
+- Registry: `gitea.it-drui.de/viewit/kx-bridge`
+- Default PR target: `nightly`

docker-compose-KX.yml

@@ -0,0 +1,210 @@
+# KobraX Full Stack — KX-Bridge + Obico Self-Hosted + Spoolman
+#
+# Für Portainer: Stack → Add Stack → Upload → diese Datei wählen
+#
+# Voraussetzung: Obico-Images einmalig in Gitea-Registry pushen:
+#   docker tag obico-server-web:latest    gitea.it-drui.de/viewit/obico-web:latest
+#   docker tag obico-server-ml_api:latest gitea.it-drui.de/viewit/obico-ml:latest
+#   docker tag obico-server-tasks:latest  gitea.it-drui.de/viewit/obico-tasks:latest
+#   docker push gitea.it-drui.de/viewit/obico-web:latest
+#   docker push gitea.it-drui.de/viewit/obico-ml:latest
+#   docker push gitea.it-drui.de/viewit/obico-tasks:latest
+#
+# Persistente Daten: /mnt/dockerdata/KobraXStack/<service>/
+#
+# Ports:
+#   7125  — KX-Bridge  (Moonraker-API)
+#   3334  — Obico      (Web-UI)
+#   7912  — Spoolman   (Web-UI)
+#
+# Obico Admin-Account nach dem ersten Start:
+#   docker exec obico-web python manage.py createsuperuser
+
+x-obico-base: &obico-base
+  restart: unless-stopped
+  volumes:
+    - /mnt/dockerdata/KobraXStack/obico/data:/data
+    - /mnt/dockerdata/KobraXStack/obico/frontend:/frontend
+  depends_on:
+    - obico-redis
+  environment:
+    DEBUG: "False"
+    REDIS_URL: "redis://obico-redis:6379"
+    DATABASE_URL: "sqlite:////data/db.sqlite3"
+    INTERNAL_MEDIA_HOST: "http://obico-web:3334"
+    ML_API_HOST: "http://obico-ml:3333"
+    ACCOUNT_ALLOW_SIGN_UP: "False"
+    SITE_USES_HTTPS: "False"
+    SITE_IS_PUBLIC: "False"
+    DJANGO_SECRET_KEY: "change-me-to-a-random-secret-key-before-use"
+    WEBPACK_LOADER_ENABLED: "False"
+  networks:
+    - kobrax-stack
+
+services:
+
+  # ── KX-Bridge ───────────────────────────────────────────────
+  kx-bridge:
+    image: gitea.it-drui.de/viewit/kx-bridge:latest
+    container_name: kx-bridge
+    restart: unless-stopped
+    ports:
+      - "7125:7125"
+    volumes:
+      - /mnt/dockerdata/KobraXStack/kx-bridge/config:/app/config
+      - /mnt/dockerdata/KobraXStack/kx-bridge/data:/app/data
+    networks:
+      - kobrax-stack
+    logging:
+      driver: json-file
+      options:
+        max-size: "10m"
+        max-file: "3"
+
+  # ── Spoolman ────────────────────────────────────────────────
+  spoolman:
+    image: ghcr.io/donkie/spoolman:latest
+    container_name: spoolman
+    restart: unless-stopped
+    ports:
+      - "7912:8000"
+    volumes:
+      - /mnt/dockerdata/KobraXStack/spoolman:/home/app/.local/share/spoolman
+    networks:
+      - kobrax-stack
+    logging:
+      driver: json-file
+      options:
+        max-size: "10m"
+        max-file: "3"
+
+  # ── Obico Redis ─────────────────────────────────────────────
+  obico-redis:
+    image: redis:7.2-alpine
+    container_name: obico-redis
+    restart: unless-stopped
+    volumes:
+      - /mnt/dockerdata/KobraXStack/obico/redis:/data
+    networks:
+      - kobrax-stack
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      start_period: 10s
+      interval: 15s
+      timeout: 5s
+      retries: 10
+    logging:
+      driver: json-file
+      options:
+        max-size: "5m"
+        max-file: "2"
+
+  # ── Obico ML API ────────────────────────────────────────────
+  obico-ml:
+    image: gitea.it-drui.de/viewit/obico-ml:latest
+    container_name: obico-ml
+    restart: unless-stopped
+    command: bash -c "gunicorn --bind 0.0.0.0:3333 --workers 1 wsgi"
+    working_dir: /app
+    environment:
+      DEBUG: "False"
+      FLASK_APP: "server.py"
+    networks:
+      - kobrax-stack
+    healthcheck:
+      test: ["CMD-SHELL", "wget -q --spider http://127.0.0.1:3333/hc/ || exit 1"]
+      start_period: 30s
+      interval: 30s
+      timeout: 10s
+      retries: 3
+    logging:
+      driver: json-file
+      options:
+        max-size: "10m"
+        max-file: "3"
+
+  # ── Obico Web ───────────────────────────────────────────────
+  obico-web:
+    <<: *obico-base
+    image: gitea.it-drui.de/viewit/obico-web:latest
+    container_name: obico-web
+    ports:
+      - "3334:3334"
+    depends_on:
+      - obico-ml
+      - obico-redis
+    command: >
+      sh -c 'python manage.py migrate &&
+             python manage.py shell -c "from django.contrib.sites.models import Site; s=Site.objects.first(); s.domain=\"192.168.178.204:3334\"; s.name=\"Obico\"; s.save()" &&
+             python manage.py collectstatic --noinput &&
+             daphne -b 0.0.0.0 -p 3334 config.routing:application'
+    healthcheck:
+      test: ["CMD-SHELL", "wget -q --spider http://127.0.0.1:3334/hc/ || exit 1"]
+      start_period: 60s
+      interval: 90s
+      timeout: 20s
+      retries: 3
+    logging:
+      driver: json-file
+      options:
+        max-size: "10m"
+        max-file: "3"
+
+  # ── Obico Tasks (Celery) ────────────────────────────────────
+  obico-tasks:
+    <<: *obico-base
+    image: gitea.it-drui.de/viewit/obico-tasks:latest
+    container_name: obico-tasks
+    command: sh -c "celery -A config worker --beat -l info -c 2 -Q realtime,celery"
+    logging:
+      driver: json-file
+      options:
+        max-size: "10m"
+        max-file: "3"
+
+  # ── moonraker-obico Plugin ──────────────────────────────────
+  # Verbindet KX-Bridge mit dem Obico-Server (Spaghetti-Detektion, Remote-UI)
+  # Voraussetzung: /mnt/dockerdata/KobraXStack/moonraker-obico/moonraker-obico.cfg
+  # muss existieren und einen gültigen auth_token enthalten.
+  #
+  # Token holen (nach erstem obico-web Start):
+  #   docker exec obico-web python manage.py shell -c "
+  #   from app.models import OneTimeVerificationCode, User
+  #   from django.utils import timezone; from datetime import timedelta; import random
+  #   u = User.objects.first()
+  #   c = OneTimeVerificationCode.objects.create(user=u, code='%06d' % random.randint(100000,999999), expired_at=timezone.now()+timedelta(hours=2))
+  #   print('CODE:', c.code)"
+  #   curl -X POST 'http://localhost:3334/api/v1/octo/verify/?code=<CODE>'
+  #   → printer.auth_token aus der Antwort in die cfg eintragen
+  moonraker-obico:
+    image: gitea.it-drui.de/viewit/moonraker-obico:latest
+    container_name: moonraker-obico
+    restart: unless-stopped
+    network_mode: host
+    volumes:
+      - /mnt/dockerdata/KobraXStack/moonraker-obico:/opt/printer_data/config
+      - /mnt/dockerdata/KobraXStack/moonraker-obico/logs:/opt/printer_data/logs
+    command: ["-c", "/opt/printer_data/config/moonraker-obico.cfg"]
+    logging:
+      driver: json-file
+      options:
+        max-size: "10m"
+        max-file: "3"
+
+networks:
+  kobrax-stack:
+    driver: bridge
+
+# Verzeichnisse müssen auf dem Host existieren:
+# mkdir -p /mnt/dockerdata/KobraXStack/kx-bridge/config \
+#           /mnt/dockerdata/KobraXStack/kx-bridge/data \
+#           /mnt/dockerdata/KobraXStack/spoolman \
+#           /mnt/dockerdata/KobraXStack/obico/data \
+#           /mnt/dockerdata/KobraXStack/obico/frontend \
+#           /mnt/dockerdata/KobraXStack/obico/redis \
+#           /mnt/dockerdata/KobraXStack/moonraker-obico/logs
+# Spoolman benötigt UID/GID 1000:
+# sudo chown -R 1000:1000 /mnt/dockerdata/KobraXStack/spoolman
+#
+# moonraker-obico Config anlegen (auth_token nach Obico-Setup eintragen):
+# cp /path/to/moonraker-obico.cfg.example /mnt/dockerdata/KobraXStack/moonraker-obico/moonraker-obico.cfg

docker-compose.nightly.yml

@@ -0,0 +1,3 @@
+services:
+  kx-bridge:
+    image: gitea.it-drui.de/viewit/kx-bridge:nightly

docker-compose.portainer-nightly.yml

@@ -0,0 +1,25 @@
+# KX-Bridge Nightly — Portainer Stack
+#
+# Paste this into Portainer → Stacks → Add stack → Web editor
+#
+# Uses the nightly build — may be unstable, for testing new features early.
+# For production use, see docker-compose.portainer.yml (:latest).
+
+services:
+  kx-bridge:
+    image: gitea.it-drui.de/viewit/kx-bridge:nightly
+    volumes:
+      - /mnt/dockerdata/kx-nightly/config:/app/config
+      - /mnt/dockerdata/kx-nightly/data:/app/data
+    ports:
+      # Port 7125 = first printer. Add 7126, 7127, … for each additional printer.
+      - "7125:7125"
+    restart: unless-stopped
+    logging:
+      driver: json-file
+      options:
+        max-size: "10m"
+        max-file: "3"
+
+# Verzeichnisse müssen auf dem Host existieren:
+# mkdir -p /mnt/dockerdata/kx-nightly/config /mnt/dockerdata/kx-nightly/data

kobrax_moonraker_bridge.py

@@ -4524,9 +4524,10 @@ class KobraXBridge:
 
     # ─── Update ──────────────────────────────────────────────────────────────
 
-    STABLE_RELEASE_API = "https://gitea.it-drui.de/api/v1/repos/viewit/KX-Bridge-Release/releases?limit=1"
-    DEV_RELEASE_API    = "https://gitea.it-drui.de/api/v1/repos/viewit/KX-Bridge-Release/releases?limit=10&pre-release=true"
-    GITEA_RAW_BASE     = "https://gitea.it-drui.de/viewit/KX-Bridge-Release/raw/tag"
+    STABLE_RELEASE_API  = "https://gitea.it-drui.de/api/v1/repos/viewit/KX-Bridge-Release/releases?limit=1"
+    NIGHTLY_RELEASE_API = "https://gitea.it-drui.de/api/v1/repos/viewit/KX-Bridge-Release/releases?limit=5&pre-release=true"
+    DEV_RELEASE_API     = "https://gitea.it-drui.de/api/v1/repos/viewit/KX-Bridge-Release/releases?limit=10&pre-release=true"
+    GITEA_RAW_BASE      = "https://gitea.it-drui.de/viewit/KX-Bridge-Release/raw/tag"
 
     def _read_version(self) -> str:
         # PyInstaller-Onefile entpackt VERSION (per kx-bridge.spec datas) nach
@@ -4601,8 +4602,14 @@ class KobraXBridge:
 
     async def handle_api_update_check(self, request):
         current = self._read_version()
+        is_nightly = "nightly" in current
         is_dev = "-dev+" in current
-        api_url = self.DEV_RELEASE_API if is_dev else self.STABLE_RELEASE_API
+        if is_nightly:
+            api_url = self.NIGHTLY_RELEASE_API
+        elif is_dev:
+            api_url = self.DEV_RELEASE_API
+        else:
+            api_url = self.STABLE_RELEASE_API
         try:
             async with aiohttp.ClientSession() as session:
                 async with session.get(api_url, timeout=aiohttp.ClientTimeout(total=10)) as resp:
@@ -4611,14 +4618,37 @@ class KobraXBridge:
                     releases = await resp.json(content_type=None)
             if not releases:
                 return web.json_response({"error": "Keine Releases gefunden"}, status=404)
-            # Dev: neuestes Release mit "-dev+" im Tag suchen
-            if is_dev:
+
+            if is_nightly:
+                # Neuestes Prerelease mit nightly-Tag suchen
+                nightly_releases = [r for r in releases if r.get("prerelease") and "nightly" in r.get("tag_name", "")]
+                if not nightly_releases:
+                    return web.json_response({"error": "Keine Nightly-Releases gefunden"}, status=404)
+                data = nightly_releases[0]
+                tag = data.get("tag_name", "")
+                # Tag-Format: "nightly-0.9.27-nightly4", current: "0.9.27-nightly4"
+                tag_version = tag[len("nightly-"):] if tag.startswith("nightly-") else tag
+                update_available = tag_version != current
+                latest = tag
+                return web.json_response({
+                    "current":          current,
+                    "latest":           latest,
+                    "update_available": update_available,
+                    "tag":              tag,
+                    "docker_only":      True,
+                    "changelog":        data.get("body", ""),
+                })
+            elif is_dev:
                 dev_releases = [r for r in releases if "-dev+" in r.get("tag_name", "")]
                 if not dev_releases:
                     return web.json_response({"error": "Keine Dev-Releases gefunden"}, status=404)
                 data = dev_releases[0]
             else:
-                data = releases[0]
+                # Stable: nur non-prerelease nehmen
+                stable_releases = [r for r in releases if not r.get("prerelease")]
+                if not stable_releases:
+                    return web.json_response({"error": "Keine Stable-Releases gefunden"}, status=404)
+                data = stable_releases[0]
             tag = data.get("tag_name", "")
             latest = tag.lstrip("v")
             if is_dev:
@@ -4632,6 +4662,7 @@ class KobraXBridge:
                 "update_available": update_available,
                 "tag":              tag,
                 "download_url":     download_url,
+                "docker_only":      False,
                 "changelog":        data.get("body", ""),
             })
         except Exception as e:
@@ -4652,6 +4683,10 @@ class KobraXBridge:
     async def handle_api_update_apply(self, request):
         data = await request.json()
         new_tag = data.get("tag", "")
+        if "nightly" in self._read_version():
+            return web.json_response(
+                {"error": "Nightly-Updates laufen über Docker: "
+                          "docker compose pull && docker compose up -d"}, status=400)
         if getattr(sys, "frozen", False):
             return web.json_response(
                 {"error": "Self-Update wird im Binary-Modus nicht unterstützt – "

moonraker-obico.cfg.example

@@ -0,0 +1,18 @@
+[server]
+url = http://127.0.0.1:3334
+auth_token = REPLACE_ME
+sentry_opt = out
+
+[moonraker]
+host = 127.0.0.1
+port = 7125
+
+[webcam]
+disable_video_streaming = False
+snapshot_url = http://127.0.0.1:7125/api/camera/snapshot
+stream_url   = http://127.0.0.1:7125/api/camera/stream
+target_fps   = 5
+
+[logging]
+path  = /opt/printer_data/logs/moonraker-obico.log
+level = INFO

pull_request_template.md

@@ -0,0 +1,21 @@
+## Description
+<!-- What does this PR change? -->
+
+## Related Issue
+Closes #
+
+## Type
+- [ ] Bug fix
+- [ ] Feature
+- [ ] Documentation
+- [ ] Refactoring
+
+## Tested with
+- OrcaSlicer Version:
+- Printer:
+- Moonraker/Klipper Version:
+
+## Checklist
+- [ ] Tests added/updated
+- [ ] CHANGELOG.md updated
+- [ ] No debug code included

web/themes/default/app.js

@@ -1661,21 +1661,33 @@ function saveSettings(){
     clog('Settings-Fehler: '+e,'msg-err');
   });
 }
+var _updateDockerOnly=false;
 function checkUpdate(){
   var sb=document.getElementById('update-status');
   sb.textContent=T.update_checking;
   document.getElementById('btn-update-apply').style.display='none';
-  _updateTag='';_updateUrl='';
+  _updateTag='';_updateUrl='';_updateDockerOnly=false;
   fetch(_apiUrl('/api/update/check')).then(function(r){return r.json()}).then(function(d){
     if(d.error){sb.textContent=T.update_error+': '+d.error;return;}
     var cl=document.getElementById('update-changelog');
-    if(d.changelog&&d.changelog.trim()){cl.textContent=d.changelog;cl.style.display='block';}
-    else{cl.style.display='none';}
+    if(d.changelog&&d.changelog.trim()){
+      // Changelog als Markdown-Text (pre-formatiert) anzeigen
+      cl.textContent=d.changelog;cl.style.display='block';
+    } else {cl.style.display='none';}
+    _updateDockerOnly=!!d.docker_only;
     if(d.update_available){
-      sb.textContent='v'+d.latest+' '+T.update_available;
+      sb.textContent=d.latest+' '+T.update_available;
       sb.style.color='var(--ok)';
-      _updateTag=d.tag;_updateUrl=d.download_url;
-      document.getElementById('btn-update-apply').style.display='inline-block';
+      _updateTag=d.tag;_updateUrl=d.download_url||'';
+      var btn=document.getElementById('btn-update-apply');
+      if(_updateDockerOnly){
+        btn.textContent=T.update_docker||'docker compose pull';
+        btn.title='docker compose pull && docker compose up -d';
+      } else {
+        btn.textContent=T.update_apply;
+        btn.title='';
+      }
+      btn.style.display='inline-block';
     } else {
       sb.textContent=T.update_none;
       sb.style.color='var(--txt2)';
@@ -1683,9 +1695,21 @@ function checkUpdate(){
   }).catch(function(e){sb.textContent=T.update_error+': '+e;});
 }
 function applyUpdate(){
-  if(!_updateUrl)return;
   var sb=document.getElementById('update-status');
   var btn=document.getElementById('btn-update-apply');
+  if(_updateDockerOnly){
+    // Nightly: kein Self-Update, Docker-Befehl in Zwischenablage kopieren
+    var cmd='docker compose pull && docker compose up -d';
+    if(navigator.clipboard){
+      navigator.clipboard.writeText(cmd).then(function(){
+        sb.textContent=T.update_docker_copied||'Befehl kopiert: '+cmd;
+      });
+    } else {
+      sb.textContent=cmd;
+    }
+    return;
+  }
+  if(!_updateUrl)return;
   btn.disabled=true;sb.textContent=T.update_applying;
   post('/api/update/apply',{download_url:_updateUrl,tag:_updateTag}).then(function(){
     sb.textContent=T.update_restarting;

web/translations/de.json

@@ -321,6 +321,8 @@
   "update_available": "verfügbar",
   "update_check": "Auf Updates prüfen",
   "update_checking": "Prüfe...",
+  "update_docker": "Befehl kopieren",
+  "update_docker_copied": "Kopiert! Ausführen: docker compose pull && docker compose up -d",
   "update_error": "Fehler",
   "update_none": "Bereits aktuell",
   "update_restarting": "Starte neu..."

web/translations/en.json

@@ -321,6 +321,8 @@
   "update_available": "available",
   "update_check": "Check for Updates",
   "update_checking": "Checking...",
+  "update_docker": "Copy Command",
+  "update_docker_copied": "Copied! Run: docker compose pull && docker compose up -d",
   "update_error": "Error",
   "update_none": "Already up to date",
   "update_restarting": "Restarting..."

web/translations/es.json

@@ -321,6 +321,8 @@
   "update_available": "disponible",
   "update_check": "Buscar actualizaciones",
   "update_checking": "Comprobando...",
+  "update_docker": "Copiar comando",
+  "update_docker_copied": "Copiado. Ejecutar: docker compose pull && docker compose up -d",
   "update_error": "Error",
   "update_none": "Ya actualizado",
   "update_restarting": "Reiniciando..."

web/translations/fr.json

@@ -321,6 +321,8 @@
   "update_available": "disponible",
   "update_check": "Vérifier les mises à jour",
   "update_checking": "Vérification…",
+  "update_docker": "Copier la commande",
+  "update_docker_copied": "Copié ! Exécuter : docker compose pull && docker compose up -d",
   "update_error": "Erreur",
   "update_none": "Déjà à jour",
   "update_restarting": "Redémarrage…"

web/translations/it.json

@@ -321,6 +321,8 @@
   "update_available": "disponibile",
   "update_check": "Controlla aggiornamenti",
   "update_checking": "Verifica in corso...",
+  "update_docker": "Copia comando",
+  "update_docker_copied": "Copiato! Eseguire: docker compose pull && docker compose up -d",
   "update_error": "Errore",
   "update_none": "Già aggiornato",
   "update_restarting": "Riavvio in corso..."

web/translations/zh-cn.json

@@ -321,6 +321,8 @@
   "update_available": "可用",
   "update_check": "检查更新",
   "update_checking": "检查中...",
+  "update_docker": "复制命令",
+  "update_docker_copied": "已复制！执行：docker compose pull && docker compose up -d",
   "update_error": "错误",
   "update_none": "已是最新版本",
   "update_restarting": "重启中..."