zugzbot 1.0.30 → 1.0.31

package/.opencode/agents/sdd-deployer.md

@@ -17,16 +17,16 @@ Eres el Desplegador de Software (sdd-deployer) del flujo SDD. Tu único trabajo
 </identity>
 
 <constraints>
-- **Operación Aislada**: Tienes estrictamente prohibido usar comandos de limpieza global (como `docker system prune -f` o `--volumes` global) o detener contenedores ajenos al proyecto activo.
+- **Lienzo en Blanco Obligatorio**: Es un requerimiento crítico del sistema limpiar completamente el entorno de Docker (todos los contenedores e imágenes, sin importar el proyecto o contenedor que sea) antes de iniciar un despliegue para evitar cualquier colisión o fallo por recursos heredados.
 - **Modo Detach Obligatorio**: Tienes prohibido ejecutar contenedores en primer plano. Ejecútalos siempre en segundo plano (`-d`) para no bloquear la terminal.
 </constraints>
 
 <deployment>
-  - **Chequeo de Docker**: Ejecuta comandos rápidos (como `docker info`) para verificar que el daemon esté activo. Si no, levántalo de forma proactiva (ej. `open -a Docker` en macOS).
+  - **Chequeo de Docker**: El daemon de Docker debe estar activo. La herramienta de limpieza `sdd_clean_docker_environment` se encargará de verificar su estado y levantarlo automáticamente si es necesario (ej. `open -a Docker` en macOS).
   - **Limpieza y Liberación (OBLIGATORIO)**:
     1. Ejecuta la herramienta `sdd_free_port` con el puerto objetivo (ej. 3000) para terminar de forma proactiva cualquier proceso que esté ocupándolo.
-    2. Ejecuta la herramienta `sdd_clean_docker_environment` para limpiar de forma segura contenedores detenidos, imágenes huérfanas y redes inactivas.
-    3. Detiene y limpia el entorno anterior ejecutando `docker compose down -v --remove-orphans`.
+    2. Ejecuta la herramienta `sdd_clean_docker_environment` para detener y eliminar TODOS los contenedores existentes, y remover TODAS las imágenes, volúmenes y redes del sistema, garantizando un lienzo en blanco.
+    3. Detiene y limpia el entorno anterior ejecutando `docker compose down -v --remove-orphans` (si existe un archivo docker-compose previo en el proyecto).
   - **Generar Docker artifacts (RECOMENDADO)**: Usa la tool `sdd_generate_dockerfile({ stack: "nextjs", port: 3000 })` para crear `Dockerfile` + `.dockerignore` + `docker-compose.yml` en **una sola llamada** (detecta automáticamente npm/pnpm/yarn).
   - **Plantillas Docker (FALLBACK)**: Si la tool no está disponible, carga la skill `docker-templates` para obtener configuraciones optimizadas de acuerdo a tu stack.
   - **Dockerignore**: Asegúrate de que existe un `.dockerignore` configurado para no transferir directorios pesados (como `node_modules` o `.next`) al contexto del build.

package/.opencode/plugins/plugin_tui.tsx

@@ -12,7 +12,7 @@ const PluginTuiSidebar: TuiPlugin = async (api) => {
         const [sessionIds, setSessionIds] = createSignal<string[]>([props.session_id])
 
         const getZugzbotVersion = (): string => {
-          const fallback = "1.0.30"
+          const fallback = "1.0.31"
           try {
             // 1. Try reading the dynamic version.json written during install
             const versionJsonPath = path.join(process.cwd(), ".opencode/version.json")

package/.opencode/templates/fastapi-sdd/Dockerfile

@@ -13,7 +13,8 @@ WORKDIR /app
 
 ENV PYTHONDONTWRITEBYTECODE=1 \
     PYTHONUNBUFFERED=1 \
-    ENV=production
+    ENV=production \
+    PYTHONPATH=/app
 
 RUN addgroup --system --gid 1001 app \
  && adduser --system --uid 1001 appuser
@@ -26,6 +27,6 @@ USER appuser
 EXPOSE 8000
 
 HEALTHCHECK --interval=30s --timeout=5s --start-period=10s --retries=3 \
-  CMD python -c "import httpx; httpx.get('http://localhost:8000/health').raise_for_status()" || exit 1
+  CMD python -c "import urllib.request; urllib.request.urlopen('http://localhost:8000/health', timeout=5).read()" || exit 1
 
-CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000"]
+CMD ["uvicorn", "src.main:app", "--host", "0.0.0.0", "--port", "8000"]

package/.opencode/templates/fastapi-sdd/README.md

@@ -5,19 +5,19 @@ Backend FastAPI bootstrapped por el arnés SDD.
 ## Quickstart
 
 ```bash
-# Con uv (recomendado)
-uv sync
-uv run uvicorn app.main:app --reload --port 8000
-
-# O con pip
+# Con pip (con o sin venv activo)
 pip install -e ".[dev]"
-uvicorn app.main:app --reload --port 8000
+uvicorn src.main:app --reload --port 8000
+
+# Con uv (si está disponible)
+uv sync
+uv run uvicorn src.main:app --reload --port 8000
 ```
 
 ## Tests
 
 ```bash
-uv run pytest
+python -m pytest
 # o
 pytest
 ```
@@ -25,8 +25,8 @@ pytest
 ## Lint + format
 
 ```bash
-uv run ruff check .
-uv run ruff format .
+ruff check .
+ruff format .
 ```
 
 ## Docker
@@ -40,12 +40,11 @@ curl http://localhost:8000/health
 
 ```
 src/
-├── app/
-│   ├── main.py             # FastAPI app
-│   ├── core/config.py      # Settings (pydantic-settings)
-│   ├── routers/            # Endpoints (vacío por defecto)
-│   └── schemas/            # Pydantic models (vacío por defecto)
-└── tests/                  # Pytest suite
+├── main.py             # FastAPI app
+├── core/config.py      # Settings (pydantic-settings)
+├── routers/            # Endpoints (vacío por defecto)
+├── schemas/            # Pydantic models (vacío por defecto)
+└── tests/              # Pytest suite
 ```
 
 ## Stack
@@ -57,4 +56,4 @@ src/
 - Pytest 8 + pytest-asyncio
 - Ruff 0.8+ (lint + format)
 
-Ver `.opencode/templates/fastapi-sdd/pyproject.toml` para versiones pinneadas.
+Ver `pyproject.toml` para versiones pinneadas.

package/.opencode/templates/fastapi-sdd/docker-compose.yml

@@ -9,7 +9,7 @@ services:
       - ENV=production
     restart: unless-stopped
     healthcheck:
-      test: ["CMD", "python", "-c", "import httpx; httpx.get('http://localhost:8000/health').raise_for_status()"]
+      test: ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://localhost:8000/health', timeout=5).read()"]
       interval: 30s
       timeout: 5s
       retries: 3

package/.opencode/templates/fastapi-sdd/pyproject.toml

@@ -23,7 +23,7 @@ requires = ["hatchling"]
 build-backend = "hatchling.build"
 
 [tool.hatch.build.targets.wheel]
-packages = ["src/app"]
+packages = ["src"]
 
 [tool.ruff]
 line-length = 100
@@ -36,4 +36,4 @@ ignore = ["E501"]
 [tool.pytest.ini_options]
 testpaths = ["src/tests", "tests"]
 asyncio_mode = "auto"
-pythonpath = ["src"]
+pythonpath = [".", "src"]

package/.opencode/templates/fastapi-sdd/src/{app/main.py → main.py}

@@ -1,7 +1,7 @@
 """FastAPI application entry point."""
 from fastapi import FastAPI
 
-from app.core.config import settings
+from src.core.config import settings
 
 
 def create_app() -> FastAPI:

package/.opencode/templates/fastapi-sdd/src/tests/conftest.py

@@ -2,7 +2,7 @@
 import pytest
 from fastapi.testclient import TestClient
 
-from app.main import app
+from src.main import app
 
 
 @pytest.fixture

package/.opencode/templates/fastapi-sdd/src/tests/test_main.py

@@ -11,7 +11,7 @@ def test_health_endpoint_returns_ok(client: TestClient) -> None:
 
 
 def test_app_metadata() -> None:
-    from app.main import app
+    from src.main import app
 
     assert app.title
     assert app.version

package/.opencode/tools/sdd_bootstrap.ts

@@ -375,7 +375,7 @@ export const bootstrap_fastapi = tool({
     }
 
     const isInitialized =
-      fs.existsSync(path.resolve(root, "src/app/main.py")) &&
+      fs.existsSync(path.resolve(root, "src/main.py")) &&
       fs.existsSync(path.resolve(root, "pyproject.toml"))
 
     if (isInitialized && !args.force) {
@@ -430,12 +430,12 @@ export const bootstrap_fastapi = tool({
       ".dockerignore",
       "docker-compose.yml",
       "README.md",
-      "src/app/__init__.py",
-      "src/app/main.py",
-      "src/app/core/__init__.py",
-      "src/app/core/config.py",
-      "src/app/routers/__init__.py",
-      "src/app/schemas/__init__.py",
+      "src/__init__.py",
+      "src/main.py",
+      "src/core/__init__.py",
+      "src/core/config.py",
+      "src/routers/__init__.py",
+      "src/schemas/__init__.py",
       "src/tests/__init__.py",
       "src/tests/conftest.py",
       "src/tests/test_main.py",
@@ -522,7 +522,7 @@ export const bootstrap_fastapi = tool({
       installDuration,
       extrasInstalled,
       finalPyprojectToml,
-      nextSteps: "Run `uv run uvicorn app.main:app --reload --port 8000` (o `uvicorn ...` con venv activo) para arrancar el dev server.",
+      nextSteps: "Run `uvicorn src.main:app --reload --port 8000` (o `python -m uvicorn src.main:app --reload --port 8000`) para arrancar el dev server.",
       _bootstrapRecord: bootstrapRecord,
     }, null, 2)
   }

package/.opencode/tools/sdd_docker.ts

@@ -13,31 +13,79 @@ const getRoot = (context: any) => {
 
 // Tool: sdd_clean_docker_environment
 export const clean_docker_environment = tool({
-  description: "Limpia de forma agresiva y segura el entorno de Docker: remueve contenedores detenidos, imágenes huérfanas/dangling creadas por compilaciones fallidas, y redes no utilizadas. Se debe ejecutar antes de desplegar un nuevo contenedor para liberar recursos y evitar colisiones.",
+  description: "Asegura que Docker esté abierto y realiza una limpieza total y agresiva: detiene y elimina TODOS los contenedores (activos o inactivos), remueve TODAS las imágenes, volúmenes y redes para garantizar un lienzo en blanco absoluto antes de desplegar.",
   args: {},
   async execute(args, context) {
     const results: Record<string, string> = {}
+    const sleep = (ms: number) => new Promise(resolve => setTimeout(resolve, ms))
+
+    // 1. Asegurar que Docker daemon esté listo
+    let dockerReady = false
+    for (let i = 0; i < 12; i++) {
+      try {
+        execSync("docker info", { stdio: "ignore", timeout: 3000 })
+        dockerReady = true
+        break
+      } catch (e) {
+        if (i === 0) {
+          try { execSync("open -a Docker", { stdio: "ignore" }) } catch (err) {}
+        }
+        await sleep(5000)
+      }
+    }
+
+    if (!dockerReady) {
+      return JSON.stringify({
+        status: "ERROR",
+        message: "No se pudo iniciar o conectar al demonio de Docker. Por favor, asegúrese de que Docker Desktop esté corriendo."
+      }, null, 2)
+    }
+
+    // 2. Detener y eliminar todos los contenedores de forma agresiva
     try {
-      results.containers = execSync("docker container prune -f", { encoding: "utf8" }).toString().trim()
+      const containerIds = execSync("docker ps -aq", { encoding: "utf8" }).toString().trim()
+      if (containerIds) {
+        const ids = containerIds.split(/\s+/).join(" ")
+        execSync(`docker rm -f ${ids}`, { encoding: "utf8" })
+        results.containers = `Todos los contenedores detenidos y eliminados con éxito: ${ids}`
+      } else {
+        results.containers = "No se encontraron contenedores para eliminar."
+      }
+    } catch (e: any) {
+      results.containers = `Error eliminando contenedores: ${e.message}`
+    }
+
+    // 3. Eliminar todas las imágenes de forma agresiva
+    try {
+      const imageIds = execSync("docker images -aq", { encoding: "utf8" }).toString().trim()
+      if (imageIds) {
+        const ids = imageIds.split(/\s+/).join(" ")
+        execSync(`docker rmi -f ${ids}`, { encoding: "utf8" })
+        results.images = `Todas las imágenes eliminadas con éxito: ${ids}`
+      } else {
+        results.images = "No se encontraron imágenes para eliminar."
+      }
     } catch (e: any) {
-      results.containers = `Error: ${e.message}`
+      results.images = `Error eliminando imágenes: ${e.message}`
     }
 
+    // 4. Eliminar volúmenes huérfanos
     try {
-      results.images = execSync("docker image prune -f", { encoding: "utf8" }).toString().trim()
+      results.volumes = execSync("docker volume prune -af", { encoding: "utf8" }).toString().trim()
     } catch (e: any) {
-      results.images = `Error: ${e.message}`
+      results.volumes = `Error podando volúmenes: ${e.message}`
     }
 
+    // 5. Eliminar redes inactivas
     try {
       results.networks = execSync("docker network prune -f", { encoding: "utf8" }).toString().trim()
     } catch (e: any) {
-      results.networks = `Error: ${e.message}`
+      results.networks = `Error podando redes: ${e.message}`
     }
 
     return JSON.stringify({
       status: "SUCCESS",
-      message: "Entorno de Docker limpiado de forma segura y exitosa.",
+      message: "Lienzo en blanco garantizado: Docker limpio al 100%.",
       details: results
     }, null, 2)
   }

package/.utils/export_opencode_session.py

@@ -9,7 +9,7 @@ DB_PATH = "/Users/wavesbyte/.local/share/opencode/opencode.db"
 
 # Escribe aquí el ID de la sesión que deseas exportar (ejemplo: "ses_1234...")
 # Si se deja vacío, el script requerirá el ID como argumento al ejecutarlo
-TARGET_SESSION_ID = "ses_12f8"
+TARGET_SESSION_ID = "ses_11e1"
 
 
 def format_timestamp(ts):

package/bin/init.js

@@ -20,7 +20,7 @@ const pkgRoot = join(__dirname, '..');
 const targetDir = process.cwd();
 
 // Load dynamic version from package.json
-let pkgVersion = '1.0.30';
+let pkgVersion = '1.0.31';
 try {
   const pkgJsonPath = join(pkgRoot, 'package.json');
   if (fs.existsSync(pkgJsonPath)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zugzbot",
-  "version": "1.0.30",
+  "version": "1.0.31",
   "description": "Fácil instalador del arnés SDD de Zugzbot para proyectos OpenCode",
   "type": "module",
   "bin": {