Integración de GitHub Actions

<!-- .github/pull_request_template.md -->
## Resumen
<!-- Qué cambió y por qué -->
 
## Ticket
<!-- SHIP-___ -->
 
## Evidencia de prueba en dispositivo (requerida para UI / nativo / navegación)
| Plataforma | Dispositivo / SO    | Origen de compilación| Resultado |
|------------|---------------------|---------------------|-----------|
| iOS        | p. ej. iPhone 14/17 | QR de vista previa de EAS   | PASS   |
| Android    | p. ej. Pixel 7/14   | QR de vista previa de EAS   | PASS   |
 
## Rutas de prueba ejercidas
- [ ] Inicio frío / login
- [ ] Pantalla(s) cambiada(s): ___
- [ ] Enlace profundo / push (si aplica)
 
## Capturas de pantalla / grabaciones
<!-- Arrastra enlace de nube de Maestro, grabación de pantalla o captura de pantalla -->
 
## CI
- [ ] verificación de `quality` verde
- [ ] ID de compilación de vista previa anotado: ___

# .github/workflows/pr-evidence.yml
name: PR Evidence
on:
  pull_request:
    types: [opened, edited, synchronize, reopened]
 
jobs:
  evidence:
    runs-on: ubuntu-latest
    steps:
      - name: Validate PR template
        uses: actions/github-script@v7
        with:
          script: |
            const body = context.payload.pull_request.body ?? '';
            const needsDevice = /native|navigation|gesture|camera|ui/i.test(body)
              || context.payload.pull_request.labels.some(l => l.name === 'needs-device-qa');
            if (!needsDevice) {
              core.info('No device-heavy paths detected - evidence check skipped');
              return;
            }
            const required = ['Device test evidence', 'Test paths exercised', 'iOS', 'Android', 'PASS'];
            const missing = required.filter(r => !body.includes(r));
            if (missing.length) {
              core.setFailed(`PR body missing: ${missing.join(', ')}`);
            }

# .github/workflows/pr-checks.yml (extracto - emparejar con evidence)
name: PR Checks
on:
  pull_request:
    branches: [main]
jobs:
  quality:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with: { node-version: 20, cache: npm }
      - run: npm ci
      - run: npx expo customize tsconfig.json
      - run: npm run format:check && npm run lint && npm run typecheck
      - run: npm run test -- --ci

mkdir -p .github

<!-- .github/pull_request_template.md -->
## Resumen
 
 
## Ticket
SHIP-
 
## Tipo de cambio
- [ ] JS / solo copia (OTA-safe)
- [ ] Diseño / estilo de UI
- [ ] Navegación / gestos
- [ ] Módulo nativo / plugin de configuración
- [ ] Actualización de SDK
 
## Evidencia de prueba en dispositivo
> Requerido cuando se marca cualquier casilla anterior excepto "JS / solo copia".
 
| Plataforma | Dispositivo / SO | Compilación (`build_id` o enlace de vista previa) | Resultado |
|------------|-----------------|--------------------------------------------------|-----------|
| iOS        |                 |                                                  | PASS / FAIL |
| Android    |                 |                                                  | PASS / FAIL |
 
## Rutas de prueba ejercidas
- [ ] Inicio frío
- [ ] Restauración de auth / sesión
- [ ] Función bajo cambio: ___
 
## Automatización
- [ ] Flujo de Maestro: `flows/smoke.yaml` (enlace o artefacto de CI)
- [ ] Captura de pantalla / grabación de pantalla adjunta
 
## Notas de reversión (si afecta a producción)
<!-- Canal de OTA, bandera de característica o plan de rama de hotfix -->

# Crear etiquetas de GitHub (gh CLI)
gh label create "needs-device-qa" --color B60205 --description "Requires device evidence in PR"
gh label create "skip-device-qa" --color C5DEF5 --description "Docs or CI-only - no device matrix"

# .github/workflows/pr-labeler.yml
name: PR Labeler
on:
  pull_request:
    types: [opened, synchronize]
 
jobs:
  label:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/labeler@v5
        with:
          repo-token: ${{ secrets.GITHUB_TOKEN }}

# .github/labeler.yml
needs-device-qa:
  - changed-files:
      - any-glob-to-any-file:
          - 'app/**'
          - 'src/**/*.tsx'
          - 'ios/**'
          - 'android/**'
          - 'app.json'
          - 'eas.json'

# .github/workflows/pr-evidence.yml
name: PR Evidence
on:
  pull_request:
    types: [opened, edited, synchronize, reopened]
 
permissions:
  pull-requests: read
 
jobs:
  evidence:
    if: >-
      !contains(github.event.pull_request.labels.*.name, 'skip-device-qa')
    runs-on: ubuntu-latest
    steps:
      - uses: actions/github-script@v7
        with:
          script: |
            const pr = context.payload.pull_request;
            const body = pr.body ?? '';
            const title = pr.title ?? '';
 
            const uiPaths = /(src\/|app\/|\.tsx|navigation|gesture|native|plugin)/i;
            const needsEvidence =
              pr.labels.some(l => l.name === 'needs-device-qa') ||
              uiPaths.test(body) ||
              uiPaths.test(title);
 
            if (!needsEvidence) {
              core.info('Skipping device evidence - JS/docs-only change');
              return;
            }
 
            const fail = (msg) => core.setFailed(msg);
 
            if (!/\| iOS \|.*\|.*\|.*PASS/i.test(body.replace(/\n/g, ' '))) {
              fail('iOS row with PASS missing in device table');
            }
            if (!/\| Android \|.*\|.*\|.*PASS/i.test(body.replace(/\n/g, ' '))) {
              fail('Android row with PASS missing in device table');
            }
            if (!body.includes('Test paths exercised')) {
              fail('Test paths exercised section missing');
            }
            const buildRef = /build_id|eas\.dev|expo\.dev\/accounts/i;
            if (!buildRef.test(body)) {
              fail('No EAS preview build_id or install link in PR body');
            }

GitHub - Configuración - Ramas - main:
  Requerir verificaciones de estado:
    - quality          (pr-checks.yml)
    - evidence         (pr-evidence.yml)
  Requerir revisiones de pull request: 1

# El autor agrega etiqueta después de abrir PR (o el etiquetador agrega automáticamente)
gh pr create --fill
gh pr edit --add-label needs-device-qa

gh pr edit 42 --add-label needs-preview
# CI publica QR - el autor instala en dispositivos físicos

# Ejecuta Maestro localmente contra el binario de vista previa
maestro test flows/checkout-smoke.yaml
# Adjunta grabación; pega build_id en la tabla de PR

| Plataforma | Dispositivo / SO      | Origen de compilación                    | Resultado |
|------------|----------------------|------------------------------------------|-----------|
| iOS        | iPhone 14 / iOS 17.4 | build_id 8f3a2c (vista previa PR #42)   | PASS   |
| Android    | Pixel 7 / API 34     | build_id 8f3a2c (vista previa PR #42)   | PASS   |

# .github/workflows/preview-maestro.yml (extracto)
- name: Maestro smoke on preview artifact
  if: success()
  run: |
    maestro test flows/smoke.yaml --format junit --output maestro.xml
- uses: actions/upload-artifact@v4
  with:
    name: maestro-${{ github.event.pull_request.number }}
    path: maestro.xml

# Token de robot para flujos de vista previa - nunca cuenta personal
# Secreto de GitHub: EXPO_TOKEN (ver GitHub Actions + EAS)