sdd-es 2.0.0 → 2.6.0

package/skills/vercel-deploy/estado.json.example

@@ -0,0 +1,205 @@
+{
+  "skill": "vercel-deploy",
+  "version": "1.0.0",
+  "execution": {
+    "timestamp_start": "2026-06-13T14:25:30Z",
+    "timestamp_end": "2026-06-13T14:30:15Z",
+    "duration_seconds": 285,
+    "status": "SUCCESS",
+    "exit_code": 0
+  },
+  "ultimo_despliegue": {
+    "timestamp": "2026-06-13T14:30:00Z",
+    "url": "https://mi-proyecto.vercel.app",
+    "status": "OK",
+    "health_check": "200 OK",
+    "framework": "nextjs",
+    "environment": "production"
+  },
+  "pre_checks": {
+    "vercel_token": {
+      "status": "OK",
+      "message": "Token presente y válido"
+    },
+    "branch_clean": {
+      "status": "OK",
+      "message": "Sin cambios sin stagear"
+    },
+    "secrets_scan": {
+      "status": "OK",
+      "message": "No secretos detectados"
+    },
+    "tests": {
+      "status": "OK",
+      "message": "Tests pasando (42/42)",
+      "exit_code": 0
+    }
+  },
+  "build": {
+    "status": "OK",
+    "command": "npm run build",
+    "duration_seconds": 120,
+    "output": {
+      "lines": 45,
+      "first_line": "Linting source files...",
+      "last_line": "✓ Build complete"
+    }
+  },
+  "deploy": {
+    "status": "OK",
+    "platform": "vercel",
+    "deployment_id": "dpl_abc123def456ghi789",
+    "url": "https://mi-proyecto.vercel.app",
+    "production_url": "https://mi-proyecto.vercel.app",
+    "console_url": "https://vercel.com/dashboard/deployments/dpl_abc123def456ghi789",
+    "duration_seconds": 85,
+    "regions": ["iad1", "sfo1"]
+  },
+  "health_check": {
+    "status": "OK",
+    "attempts": 1,
+    "max_attempts": 3,
+    "http_code": "200",
+    "response_time_ms": 145,
+    "checks": [
+      {
+        "attempt": 1,
+        "timestamp": "2026-06-13T14:30:10Z",
+        "http_code": "200",
+        "response_time_ms": 145,
+        "status": "OK"
+      }
+    ]
+  },
+  "rollback": {
+    "status": "NOT_NEEDED",
+    "previous_deployment": "dpl_xyz789abc456def123",
+    "previous_url": "https://mi-proyecto-prev.vercel.app"
+  },
+  "configuration": {
+    "vercel_json": {
+      "buildCommand": "npm run build",
+      "outputDirectory": ".next",
+      "framework": "nextjs",
+      "auto_generated": false
+    },
+    "environment_vars": {
+      "NODE_ENV": "production",
+      "VERCEL_ENV": "production"
+    },
+    "secrets_detected": 0
+  },
+  "files_generated": {
+    ".sdd/estado.json": {
+      "size_bytes": 2845,
+      "timestamp": "2026-06-13T14:30:15Z"
+    }
+  },
+  "next_steps": [
+    "Comparte URL con testers: https://mi-proyecto.vercel.app",
+    "Monitorea por anomalías (15 minutos)",
+    "Ejecuta /sdd.snapshot para actualizar estado del producto",
+    "En caso de issues: /sdd.revertir para rollback manual"
+  ],
+  "metrics": {
+    "total_duration_seconds": 285,
+    "build_duration_seconds": 120,
+    "deploy_duration_seconds": 85,
+    "health_check_duration_seconds": 5,
+    "files_deployed": 342,
+    "uncompressed_size_mb": 45.2,
+    "compressed_size_mb": 8.7
+  },
+  "network": {
+    "git_commits_deployed": 3,
+    "last_commit_hash": "abc123def456",
+    "last_commit_message": "Add new feature: user dashboard",
+    "branch_deployed": "main",
+    "tag_created": "v1.2.3"
+  },
+  "notifications": {
+    "slack": {
+      "status": "SENT",
+      "channel": "#deployments",
+      "message_ts": "1686751815.000100"
+    },
+    "email": {
+      "status": "QUEUED",
+      "recipients": ["dev-team@company.com"],
+      "subject": "Deployment successful: v1.2.3 → production"
+    }
+  },
+  "compliance": {
+    "security_scan": {
+      "status": "OK",
+      "vulnerabilities_found": 0,
+      "scanner": "npm audit"
+    },
+    "code_quality": {
+      "status": "OK",
+      "linting_errors": 0,
+      "warnings": 2,
+      "tool": "eslint"
+    },
+    "performance": {
+      "lighthouse_score": 98,
+      "first_contentful_paint_ms": 850,
+      "largest_contentful_paint_ms": 1200
+    }
+  },
+  "audit_trail": [
+    {
+      "timestamp": "2026-06-13T14:25:30Z",
+      "action": "PRE_CHECKS_START",
+      "actor": "user@company.com",
+      "result": "OK"
+    },
+    {
+      "timestamp": "2026-06-13T14:27:45Z",
+      "action": "BUILD_START",
+      "actor": "vercel-cli",
+      "result": "OK"
+    },
+    {
+      "timestamp": "2026-06-13T14:29:15Z",
+      "action": "DEPLOY_START",
+      "actor": "vercel-api",
+      "result": "OK"
+    },
+    {
+      "timestamp": "2026-06-13T14:30:10Z",
+      "action": "HEALTH_CHECK",
+      "actor": "curl",
+      "result": "OK"
+    },
+    {
+      "timestamp": "2026-06-13T14:30:15Z",
+      "action": "COMPLETE",
+      "actor": "system",
+      "result": "SUCCESS"
+    }
+  ],
+  "error_history": [],
+  "previous_deployments": [
+    {
+      "timestamp": "2026-06-12T10:15:00Z",
+      "url": "https://mi-proyecto-v1-2-2.vercel.app",
+      "status": "SUCCESS",
+      "deployment_id": "dpl_xyz789abc456def123"
+    },
+    {
+      "timestamp": "2026-06-11T16:45:30Z",
+      "url": "https://mi-proyecto-v1-2-1.vercel.app",
+      "status": "SUCCESS",
+      "deployment_id": "dpl_prev123abc789def456"
+    }
+  ],
+  "environment_info": {
+    "vercel_cli_version": "28.16.4",
+    "node_version": "18.16.0",
+    "npm_version": "9.6.2",
+    "git_version": "2.40.0",
+    "os": "Linux ubuntu-latest",
+    "arch": "x64"
+  }
+}

package/skills/vercel-deploy/skill.yaml

@@ -0,0 +1,323 @@
+---
+# Metadatos del skill: vercel-deploy
+# Sistema: SDD (Software Deployment Dashboard)
+
+metadata:
+  id: vercel-deploy
+  name: "Despliegue Automático en Vercel"
+  version: 1.0.0
+  author: "SDD Framework"
+  last_updated: 2026-06-13
+  status: production
+
+description:
+  short: "Despliega automáticamente a Vercel con pre-checks, health checks y rollback automático"
+  long: |
+    Cierra el ciclo idea→producción sin salir del flujo.
+    Diferenciador vs Bolt/v0: verificación independiente PRE-deploy, no post-deploy.
+
+    Flujo sincrónico bloqueante con 6 pasos:
+    1. Pre-checks (valida VERCEL_TOKEN, rama limpia, sin secretos, tests verdes)
+    2. Auto-generar vercel.json (detecta framework automáticamente)
+    3. Build y deploy (npm run build + vercel deploy --prod)
+    4. Health check (retry 3x con backoff)
+    5. Rollback automático (si health check falla)
+    6. Registrar resultado (.sdd/estado.json)
+
+tags:
+  - deployment
+  - vercel
+  - ci-cd
+  - production
+  - automation
+  - devops
+
+requirements:
+  tools:
+    - name: Bash
+      version: "4+"
+    - name: vercel-cli
+      version: "latest"
+      install: "npm install -g vercel"
+    - name: git
+      version: "2+"
+    - name: npm
+      version: "8+"
+    - name: curl
+      version: "7+"
+
+environment:
+  required:
+    - VERCEL_TOKEN
+      description: "Token de autenticación en Vercel"
+      generate_at: "https://vercel.com/account/tokens"
+  optional:
+    - VERCEL_PROJECT_ID
+      description: "ID del proyecto si ya existe en Vercel"
+      source: "Vercel Dashboard > Settings > General"
+
+inputs:
+  framework:
+    type: enum
+    values: [auto, nextjs, react, vue, astro, python, flask, fastapi]
+    default: auto
+    description: "Framework detectado automáticamente si es 'auto'"
+
+  environment:
+    type: enum
+    values: [staging, production]
+    default: production
+    description: "Entorno a desplegar"
+
+  retry_count:
+    type: integer
+    default: 3
+    description: "Número de reintentos para health check"
+
+  retry_delay:
+    type: integer
+    default: 5
+    description: "Segundos entre reintentos (backoff)"
+
+outputs:
+  deploy_url:
+    type: string
+    description: "URL de la aplicación desplegada"
+    example: "https://mi-proyecto.vercel.app"
+
+  health_check_status:
+    type: enum
+    values: [OK, FAILED]
+    description: "Estado del health check"
+
+  deployment_timestamp:
+    type: string
+    format: "ISO 8601"
+    description: "Timestamp del despliegue"
+    example: "2026-06-13T14:30:00Z"
+
+  stato_file:
+    type: string
+    description: "Ruta al archivo de estado"
+    value: ".sdd/estado.json"
+
+flow:
+  steps:
+    - id: "paso-1-prechecks"
+      name: "Pre-checks"
+      description: "Valida VERCEL_TOKEN, rama limpia, sin secretos, tests verdes"
+      blocking: true
+      timeout_seconds: 60
+
+    - id: "paso-2-config"
+      name: "Configuración"
+      description: "Detecta framework y auto-genera vercel.json"
+      blocking: false
+      timeout_seconds: 30
+
+    - id: "paso-3-deploy"
+      name: "Deploy"
+      description: "Build local y envío a Vercel"
+      blocking: true
+      timeout_seconds: 900  # 15 minutos
+
+    - id: "paso-4-health"
+      name: "Health Check"
+      description: "Verificación de que la URL responde (HTTP 200)"
+      blocking: true
+      timeout_seconds: 60
+      retries:
+        count: 3
+        delay_seconds: 5
+        strategy: exponential_backoff
+
+    - id: "paso-5-rollback"
+      name: "Rollback"
+      description: "Revertir a deploy anterior si health check falla"
+      blocking: true
+      timeout_seconds: 300
+      condition: "health_check_failed"
+
+    - id: "paso-6-log"
+      name: "Registrar"
+      description: "Guardar metadatos en .sdd/estado.json"
+      blocking: false
+      timeout_seconds: 10
+
+invocation:
+  automatic:
+    trigger: "sdd.implementar-paso-5"
+    condition: "deploy.plataforma == 'vercel'"
+    gate: "user_confirmation"  # Requiere confirmación humana
+
+  manual:
+    commands:
+      - "/sdd.desplegar"
+      - "/sdd.desplegar --environment staging"
+      - "/sdd.desplegar --environment production"
+
+error_handling:
+  - error_code: "VERCEL_TOKEN_MISSING"
+    http_code: 401
+    message: "VERCEL_TOKEN no configurado"
+    action: "user_must_set_token"
+
+  - error_code: "TESTS_FAILING"
+    http_code: 422
+    message: "Tests fallando"
+    action: "user_must_fix_tests"
+
+  - error_code: "HEALTH_CHECK_FAILED"
+    http_code: 502
+    message: "Health check falló después de reintentos"
+    action: "automatic_rollback"
+
+  - error_code: "BUILD_FAILED"
+    http_code: 422
+    message: "Build local falló"
+    action: "user_must_fix_code"
+
+  - error_code: "UNCOMMITTED_CHANGES"
+    http_code: 422
+    message: "Cambios sin stagear"
+    action: "user_must_commit"
+
+  - error_code: "SECRETS_FOUND"
+    http_code: 422
+    message: "Secretos detectados en código"
+    action: "user_must_move_secrets"
+
+atomic: true
+idempotent: true
+supports_rollback: true
+
+documentation:
+  files:
+    - path: "./SKILL.md"
+      type: "spec"
+      primary: true
+    - path: "./README.md"
+      type: "quickstart"
+    - path: "./CHECKLIST.md"
+      type: "prerequisites"
+    - path: "./INTEGRATION.md"
+      type: "integration"
+    - path: "./deploy.sh"
+      type: "executable"
+    - path: "./INDEX.md"
+      type: "navigation"
+
+examples:
+  - name: "Despliegue simple"
+    commands:
+      - "export VERCEL_TOKEN='vercel_xxx_abc123...'"
+      - "/sdd.desplegar"
+
+  - name: "Despliegue a staging"
+    commands:
+      - "export VERCEL_TOKEN='vercel_xxx_abc123...'"
+      - "/sdd.desplegar --environment staging"
+
+  - name: "Despliegue manual con script"
+    commands:
+      - "bash ./skills/vercel-deploy/deploy.sh"
+
+post_deployment:
+  actions:
+    - "/sdd.snapshot"
+      description: "Actualizar estado del producto"
+    - "/sdd.canary"
+      description: "Monitorear por 15 minutos"
+    - "/sdd.revertir"
+      description: "Rollback manual si es necesario"
+
+monitoring:
+  state_file: ".sdd/estado.json"
+  logs_location: "~/.sdd/logs/vercel-deploy/"
+  dashboard_link: "https://vercel.com/dashboard"
+
+security:
+  secrets_detected: true
+  secrets_patterns:
+    - "VERCEL_TOKEN"
+    - "API_KEY"
+    - "SECRET"
+    - "password"
+  token_exposure: "never"
+  git_safe: true
+
+performance:
+  typical_duration_seconds: 240  # 4 minutos
+  max_duration_seconds: 1800     # 30 minutos
+  parallelizable: false
+
+ci_cd_integrations:
+  - name: "GitHub Actions"
+    supported: true
+    docs: "https://vercel.com/docs/concepts/git/vercel-for-github"
+
+  - name: "GitLab CI"
+    supported: true
+    docs: "https://vercel.com/docs/concepts/git/vercel-for-gitlab"
+
+  - name: "Jenkins"
+    supported: true
+    example: "vercel deploy --prod --token=$VERCEL_TOKEN"
+
+frameworks_supported:
+  - next.js
+  - React
+  - Vue
+  - Astro
+  - Python (Flask, FastAPI)
+  - Node.js
+  - Express
+  - Nuxt
+  - SvelteKit
+
+pricing:
+  skill_cost: "free"
+  vercel_cost: "see https://vercel.com/pricing"
+
+changelog:
+  - version: "1.0.0"
+    date: "2026-06-13"
+    changes:
+      - "Initial release"
+      - "6-step deployment flow"
+      - "Automatic health checks"
+      - "Atomic rollback support"
+      - "Framework auto-detection"
+
+maintainers:
+  - "SDD Team"
+  - "DevOps"
+
+license: "MIT"
+
+---
+
+# Uso en YAML de proyectos
+
+```yaml
+# En tu sdd.implementar.md o configuración:
+deploy:
+  plataforma: vercel
+  framework: auto          # O específico: nextjs, react, vue, etc.
+  environment: production
+  skill: vercel-deploy
+```
+
+# Invocación desde CLI
+
+```bash
+# Automática (con gate de confirmación)
+/sdd.implementar
+
+# Manual
+/sdd.desplegar
+/sdd.desplegar --environment staging
+
+# Directamente (si se expone como skill)
+/vercel-deploy
+```