Esta página es una traducción de la documentación en inglés. Los comandos, identificadores y ejemplos no cambian. Runtime 7.24.4 · SDK 2.6.7. Original en inglés

Manual de reversión de la versión

Estado: Activo Alcance: público, estado actual Última revisión: 2026-09-03 Responsable: ingeniería de versiones de AX Code

Este manual describe cómo retirar una versión estable (canal latest) publicada de la CLI de AX Code y restaurar la anterior. Las versiones preliminares (canal beta) no tocan el tap de Homebrew ni winget, así que revertirlas solo exige el paso de la versión de GitHub de abajo.

Prefiere una corrección hacia adelante (publicar vX.Y.Z+1) para los fallos funcionales. Revierte solo ante fallos de integridad de la versión: artefactos rotos o mal firmados, un instalador corrupto, un error de canal o de etiqueta (por ejemplo una etiqueta preliminar publicada en latest) o una regresión grave sin corrección rápida.

1. Congelar el canal

Pausa más versiones y las reanudaciones de postpublish_only hasta que termine la reversión. El flujo de versión se niega a sustituir activos de una versión ya publicada, así que ninguna repetición concurrente puede sobrescribir el estado que se está revirtiendo.

2. Reapuntar la versión de GitHub

Marca la versión defectuosa como preliminar para que latest se resuelva a la etiqueta anterior, y restaura las notas de la versión anterior si se sobrescribieron:

gh release edit "vX.Y.Z" --repo defai-digital/ax-code --prerelease
gh release edit "vX.Y.(Z-1)" --repo defai-digital/ax-code --latest

Si los activos de la versión defectuosa están corruptos o mal firmados, elimínalos también para que ningún instalador pueda obtenerlos:

gh release delete-asset "vX.Y.Z" "<asset-name>" --repo defai-digital/ax-code

No elimines el objeto de la versión en sí hasta que se hayan investigado sus artefactos; los activos firmados y los registros del flujo son la evidencia del análisis posterior.

3. Revertir el tap de Homebrew

bash .github/scripts/update-homebrew.sh envió un commit de fórmula al repositorio compartido defai-digital/homebrew-tap. Revierte ese commit para que brew upgrade ax-code vuelva a servir la versión anterior. El antiguo repositorio defai-digital/homebrew-ax-code contiene solo metadatos de migración; no restaures su fórmula:

git -C homebrew-tap revert --no-edit <formula-commit>

Verifica después la convergencia con el trabajo de humo de Homebrew (.github/workflows/install-matrix-smoke.yml) contra la versión restaurada.

4. Revertir los manifiestos de winget

Los manifiestos de winget los envían quienes mantienen el proyecto a microsoft/winget-pkgs desde el ZIP de manifiestos adjunto a la versión de GitHub. Si la versión defectuosa ya se aceptó, abre una PR que revierta esos archivos de manifiesto. Si aún está en revisión, cierra la PR. La subida --clobber de la versión solo sustituye el ZIP adjunto, nunca el paquete publicado.

5. Comunicar

Publica una nota breve en la discusión de la versión y en cualquier canal de soporte: versiones afectadas, la versión restaurada e instrucciones de reinstalación:

Homebrew: brew update && brew upgrade ax-code (o brew uninstall ax-code && brew install ax-code).
Windows y otros: vuelve a ejecutar el instalador fijado desde la página de la versión anterior; el instalador falla cerrado ante una firma que no coincide y arranca un minisign fijado y comprobado con SHA-256.

6. Verificar el estado restaurado

Confirma que la versión de GitHub latest apunta a la etiqueta anterior y que cada activo se verifica:

gh release download "vX.Y.(Z-1)" --repo defai-digital/ax-code -p '*.zip' -p '*.minisig'
minisign -V -p docs/release/ax-minisign.pub -m ax-code-darwin-arm64.zip -x ax-code-darwin-arm64.zip.minisig

Confirma que la fórmula de Homebrew sirve la versión restaurada y se instala limpiamente en un ejecutor limpio (el flujo de humo de la matriz de instalación hace esto).
Confirma que ax-code --version en una instalación nueva informa la versión restaurada y aprueba ax-code doctor.

7. Análisis posterior

Registra qué pasó las puertas de la versión y aun así se publicó roto, y presenta correcciones contra .github/workflows/release.yml (validación, cobertura de humo) antes de la siguiente versión. Actualiza este manual si algún paso no funcionó como está escrito.