Add GitHub Actions CI and update project metadata

- Add test workflow: matrix Python 3.11/3.12/3.13 on push and PR
- Bump version to 0.2.0 (sync pyproject.toml with __init__.py)
- Update Python requirement from >=3.9 to >=3.11
- Document lessons learned: manageBackupJob API, -D param format, disabled field
- Add JetBackup5 API quick reference table

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: abkrim

.github/workflows/tests.yml

@@ -0,0 +1,25 @@
+name: Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Run tests
+        run: PYTHONPATH=src python -m unittest discover -s tests -v

CLAUDE.md

@@ -50,7 +50,9 @@ server/
 git push
 # 2. Pull en raspxer
 ssh raspxer 'cd /opt/jetbackup-remote && git pull origin main'
-# 3. Si cambió el SSH gate, desplegar a los 4 servidores
+# 3. Si cambió el SSH gate, desplegar a los 4 servidores:
+#    - servidor02, servidor20, servidor30: root directo (sed o scp)
+#    - central: root por puerto 51514 (centralxer conecta como secxer sin sudo)
 # 4. Si cambió el systemd service:
 ssh raspxer 'cp /opt/jetbackup-remote/systemd/jetbackup-remote.service /etc/systemd/system/ && systemctl daemon-reload'
 ```
@@ -86,3 +88,42 @@ PYTHONPATH=src python3 -m unittest discover -s tests
 **Causa raíz:** El código buscaba `group["job_id"]` pero JetBackup5 almacena la referencia al job en `group["data"]["_id"]`
 **Solución:** Cambiar a `group.get("data", {}).get("_id")` para el matching
 **Regla derivada:** Las fixtures de test DEBEN reflejar la estructura real de la API. Usar respuestas capturadas de producción como base para fixtures.
+
+### 2026-02-25 — editBackupJob no existe, usar manageBackupJob
+
+**Contexto:** jetbackup_api.py — `set_job_enabled`
+**Problema:** Jobs con `disabled=1` nunca arrancaban. El orquestador enviaba `editBackupJob -D "enabled=1"` (luego corregido a `disabled=0`), JetBackup devolvía rc=0 pero el campo `disabled` no cambiaba. El job se triggeaba con `runBackupJobManually` pero nunca pasaba a `running=true`, causando startup timeout de 120s.
+**Causa raíz:** `editBackupJob` no existe en la API de JetBackup5. La API la acepta silenciosamente (rc=0, 267 bytes) sin hacer nada. La función correcta es **`manageBackupJob`** con `action=modify`.
+**Evidencia:** servidor20 funcionaba por casualidad (sus jobs ya tenían `disabled=0`). servidor30 fallaba (jobs con `disabled=1`). El `runBackupJobManually` devolvía 219 bytes (error silencioso) vs 3098 bytes cuando el job realmente arranca.
+**Solución:** Cambiar a `manageBackupJob` con params `_id`, `action=modify`, `disabled=0/1`
+**Regla derivada:** Listar funciones disponibles con `jetbackup5api -F ""` antes de asumir nombres. El patrón de la API es `manage*` para modificar estado (no `edit*`).
+
+### 2026-02-25 — Formato de parámetros -D en jetbackup5api
+
+**Contexto:** jetbackup_api.py — `_api_call`, `_api_call_no_json`
+**Problema:** Múltiples flags `-D "key=value"` funcionaban para algunas funciones pero no para `manageBackupJob` (ignoraba `action=modify` silenciosamente).
+**Causa raíz:** El formato documentado de JetBackup5 es un solo `-D` con parámetros separados por `&`: `-D "key1=value1&key2=value2"`. El formato con múltiples `-D` es un comportamiento no documentado que funciona para funciones simples pero no para todas.
+**Solución:** Cambiar ambos helpers (`_api_call` y `_api_call_no_json`) para usar `&`-separated params en un solo `-D`.
+**Regla derivada:** Usar SIEMPRE el formato canónico `&`-separated. Nunca múltiples `-D`, aunque parezca funcionar.
+
+### 2026-02-25 — JetBackup5 usa campo disabled (no enabled) para jobs
+
+**Contexto:** jetbackup_api.py, fixtures de test
+**Problema:** Las fixtures usaban `"enabled": true/false` pero la API real devuelve `"disabled": 0/1`.
+**Causa raíz:** Se asumió la estructura del campo sin verificar con la API real.
+**Solución:** Fixtures actualizadas a `"disabled": 0` / `"disabled": 1`. El campo `enabled` no existe en la respuesta de `getBackupJob`.
+**Regla derivada:** Para destinos Y para jobs, el campo de estado es `disabled` (0/1 o true/false). Nunca `enabled`.
+
+## Referencia rápida API JetBackup5
+
+| Acción | Función API | Params clave |
+|--------|-------------|--------------|
+| Listar funciones | `jetbackup5api -F ""` | — |
+| Estado destino | `manageDestinationState` | `_id`, `disabled=0/1` |
+| Modificar job | `manageBackupJob` | `_id`, `action=modify`, `disabled=0/1` |
+| Trigger job | `runBackupJobManually` | `_id` |
+| Info job | `getBackupJob` | `_id` |
+| Info destino | `getDestination` | `_id` |
+| Queue groups | `listQueueGroups` | `type=1` (backups) |
+
+**Formato de parámetros:** siempre `&`-separated en un solo `-D`: `-D "_id=xxx&action=modify&disabled=0"`

pyproject.toml

@@ -4,11 +4,11 @@ build-backend = "setuptools.backends._legacy:_Backend"
 
 [project]
 name = "jetbackup-remote"
-version = "0.1.0"
+version = "0.2.0"
 description = "Remote orchestrator for JetBackup5 backup serialization"
 readme = "README.md"
 license = "AGPL-3.0-or-later"
-requires-python = ">=3.9"
+requires-python = ">=3.11"
 authors = [
     {name = "Abdelkarim Mateos", email = "abdelkarim@aichadigital.es"},
 ]
@@ -20,10 +20,9 @@ classifiers = [
     "License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)",
     "Operating System :: POSIX :: Linux",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.9",
-    "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
     "Topic :: System :: Archiving :: Backup",
 ]