Saltar a contenido

HostProxmox branch sync con main

Este documento define la forma segura de mantener viva la rama activa de HostProxmox sin borrarla y sin promover nada directamente a main.

Objetivo

  • conservar la rama HostProxmox como rama de trabajo estable
  • incorporar periódicamente los commits nuevos de origin/main
  • evitar merges ciegos o cambios sin evidencia
  • mantener trazabilidad de la sincronización

Comando canónico

bash bash scripts/proxmox/hostproxmox_sync_branch_with_main.sh --push

Si quieres revisar antes de tocar nada:

bash bash scripts/proxmox/hostproxmox_sync_branch_with_main.sh --dry-run

Si necesitas forzar una rama concreta:

bash bash scripts/proxmox/hostproxmox_sync_branch_with_main.sh \ --branch local/kabehz/ovh-webhook-dns01-20260324 \ --push

Contrato

  1. main sigue siendo fuente de verdad para los commits base.
  2. La rama HostProxmox no se borra.
  3. La sincronización se hace por merge commit, no por reescritura agresiva.
  4. El árbol debe estar limpio antes de sincronizar.
  5. Si el merge falla, se abre bloqueo explícito y se corrige antes de reintentar.

FSM sugerida

graph TD
    S0[S0_ENTRY<br/>detectar rama activa] --> S1[S1_FETCH_MAIN<br/>fetch origin]
    S1 --> S2[S2_CLEAN_TREE<br/>verificar árbol limpio]
    S2 --> S3[S3_MERGE_MAIN<br/>merge origin/main]
    S3 --> S4[S4_VALIDATE<br/>tests y evidencia]
    S4 --> S5[S5_PUSH_BRANCH<br/>push branch preservando historial]
    S5 --> S6[S6_KEEP_ALIVE<br/>rama lista para siguiente sync]

    S2 --> F1[F1_DIRTY_TREE<br/>hay cambios locales]
    S3 --> F2[F2_MERGE_CONFLICT<br/>conflicto con main]
    S4 --> F3[F3_EVIDENCE_GAP<br/>no hay validación suficiente]

Cuándo usarlo

  • cuando main recibe commits nuevos y la rama HostProxmox debe mantenerse alineada
  • cuando se quiere dejar evidencia de convergencia sin borrar la rama
  • cuando la rama va a seguir viva para iteraciones de Kabehz, L0KY y AJCG131281

Qué no hace

  • no borra ramas
  • no fuerza main
  • no resuelve conflictos automáticamente
  • no sustituye la validación humana ni la evidencia local