diff --git a/.claude/skills/publicar-version/SKILL.md b/.claude/skills/publicar-version/SKILL.md index a529866..8e44ec8 100644 --- a/.claude/skills/publicar-version/SKILL.md +++ b/.claude/skills/publicar-version/SKILL.md @@ -12,6 +12,6 @@ Las etiquetas (`vX.Y.Z`), las releases y mover la etiqueta móvil `v1` las hace 3. **CHANGELOG.md**: mueve lo de «Sin publicar» a `## [X.Y.Z] - AAAA-MM-DD` con Añadido / Cambiado / Corregido en español y actualiza los enlaces de comparación del final (`[Sin publicar]` → `vX.Y.Z...HEAD` y una línea `[X.Y.Z]`). 4. **Docs**: README (solo lo de usuario), `docs/USO.md`, `docs/DESARROLLO.md`, `AGENTS.md` si cambian reglas, `MEMORY.md` (estado, decisiones con fecha, registro de sesiones) y `PLAN.md`. 5. **Cabecera del README** (solo si cambian los sprites): genera la galería (`go run ./cmd/commitling gallery --out out/site`) y rehaz `docs/img/banner.svg` copiando el grupo `` de `svg/{seed,sprout,sapling,shrub}-happy.svg` y `svg/ancient-radiant.svg`, cada uno dentro de `` (la animación va en el grupo interior, nunca en el que lleva `transform`, o la animación CSS lo anula). -6. **Binario precompilado (opcional)**: si quieres que la Action descargue el binario en vez de compilar, el último commit antes de la etiqueta debe incluir `release/checksums.txt` (`scripts/build-release.sh out/rel --write`, con la versión de Go de `go.mod`). El workflow `release.yml` sube los binarios al publicar la release. Si no lo haces, no pasa nada: la Action compila como siempre. Si vuelves a tocar código después, regenéralo o el CI fallará. +6. **Binario precompilado** (activo desde la v1.0.0): el último commit antes de la etiqueta debe incluir `release/checksums.txt` (`GOFLAGS=-p=2 nice -n 19 scripts/build-release.sh out/rel --write`, con la versión de Go de `go.mod`), generado **después** del último cambio de código o de la web (la plantilla va embebida en el binario). El workflow `release.yml` sube los binarios al publicar la release. Si no lo haces, no pasa nada: la Action compila como siempre. Si vuelves a tocar código después, regenéralo o el CI fallará; y tras publicar, el primer PR que cambie código lo borra (`git rm release/checksums.txt`). 7. **Comprueba**: `gofmt -l .`, `go vet ./...`, `GOFLAGS=-p=2 go test ./...`, el subagente `guardian-compatibilidad` y, si tocaste la web, la skill `probar-web`. -8. **Notas para Alberto** en el PR: «tras fusionar: release `vX.Y.Z` con las notas del CHANGELOG y, si es compatible, mover `v1` a ella». +8. **Notas para Alberto** en el PR: «tras fusionar: release `vX.Y.Z` con las notas del CHANGELOG y, si es compatible, mover `v1` a ella». Lo que solo sea cierto tras publicar (avisos de «aún no publicado», ejemplos `@vX.Y.Z`) va en otra rama que se fusiona después. diff --git a/.github/workflows/action-test.yml b/.github/workflows/action-test.yml index d3a4581..2494d85 100644 --- a/.github/workflows/action-test.yml +++ b/.github/workflows/action-test.yml @@ -16,6 +16,12 @@ concurrency: jobs: action: runs-on: ubuntu-latest + # This job tests the go run path (and the patched Go of every call), so it + # must not depend on whether the release of release/checksums.txt is + # published: no download can succeed here. The binary path, with the real + # release and with a local one, is the job «binario». + env: + COMMITLING_RELEASE_URL: http://127.0.0.1:9/sin-release steps: - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 with: @@ -191,10 +197,39 @@ jobs: go-version-file: go.mod cache: false + # What a profile gets right after the merge: the release/checksums.txt + # committed in this tree and the real release URL. Before the release + # is published the download fails and the Action compiles with go run; + # after it, the verified binary is used. Same SVG either way. + - name: Action con el checksums.txt del repositorio y la release real + uses: ./ + with: + user: "" + fixture: testdata/events.json + species: cactus + out: out/real-release.svg + + - name: Comprobar la Action con la release real + run: | + set -euo pipefail + go run ./cmd/commitling render --fixture testdata/events.json --species cactus --out out/expected-real.svg + cmp out/real-release.svg out/expected-real.svg + version="$(sed -n 's/^var version = "\(.*\)"$/\1/p' cmd/commitling/main.go)" + if [ ! -f release/checksums.txt ]; then + echo "Sin release/checksums.txt: la Action compila con go run." + elif [ -x "$RUNNER_TEMP/commitling-bin/commitling_${version}_linux_amd64" ]; then + echo "La release v$version está publicada: la Action usó su binario verificado." + else + echo "La release v$version aún no tiene binarios: la Action compiló con go run (lo esperado antes de publicarla)." + fi + rm -rf "$RUNNER_TEMP/commitling-bin" + - name: Binarios reproducibles y release falsa en 127.0.0.1 run: | set -euo pipefail scripts/build-release.sh "$RUNNER_TEMP/rel" + # A committed release/checksums.txt must be exactly these binaries. + if [ -f release/checksums.txt ]; then diff -u release/checksums.txt "$RUNNER_TEMP/rel/checksums.txt"; fi version="$(sed -n 's/^var version = "\(.*\)"$/\1/p' cmd/commitling/main.go)" mkdir -p release "$RUNNER_TEMP/www/v$version" cp "$RUNNER_TEMP/rel/checksums.txt" release/checksums.txt diff --git a/AGENTS.md b/AGENTS.md index 30943ec..68bc33f 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -57,7 +57,7 @@ Una mascota pixel-art **original** que vive en el README de tu perfil de GitHub. - Tests de comportamiento del generador en Node: `node internal/gallery/testdata/generator.test.js ` (DOM, `fetch`, `sessionStorage` y wasm simulados, sin dependencias); lo lanza `TestGeneratorBehaviourInNode`, que en el CI falla si no hay `node` y en otros sitios se salta. - El lector de CSS de los tests (`css_test.go`) ignora comentarios y cadenas y entiende `@media` y `@supports`; sigue siendo un lector mínimo, no un analizador completo. -## Blindada (v0.8.0, 24/10/2026) +## Blindada (24/10/2026, camino a la 1.0.0) - **La interfaz de `action.yml` es sagrada**: entradas (`user`, `out`, `theme`, `token`, `species`, `size`, `fixture`, `keep-on-error`), salida `path`, nombres de archivo y formato del SVG. El perfil de BertMarti (y otros) la usan a diario con `@v1`; un cambio incompatible rompe perfiles al día siguiente de mover `v1`. - **Nada de `${{ }}` dentro de un script `run:`** (ni en `action.yml` ni en los workflows): las entradas y contextos llegan por `env:`. Lo vigila `TestNoExpressionsInRunScripts`. - Workflows con `permissions` explícitos (Pages: `{}` arriba y lo justo por job) y `persist-credentials: false` en cada `checkout` (`TestWorkflowsAreLeastPrivilege`). @@ -73,7 +73,12 @@ Una mascota pixel-art **original** que vive en el README de tu perfil de GitHub. - **Selector de tema** (`internal/gallery/theme.js`, en `` sin `defer` para no parpadear): `data-theme` en ``, cambia el `media` de los `` y de `theme-color` (original en `data-media`). `localStorage` `commitling:theme` con lista cerrada (`light`, `dark`); «Sistema» borra la clave. CSS: oscuro en `@media (prefers-color-scheme:dark){:root:not([data-theme=light])…}` y `:root[data-theme=dark]`. Test en Node: `node internal/gallery/testdata/theme.test.js internal/gallery/theme.js`. - **Trusted Types**: la CSP lleva `require-trusted-types-for 'script'; trusted-types commitling`. La única política es la de `generator.js` (`scriptURL`), que solo acepta `wasm_exec.js`. Nada de `innerHTML`/`eval`/`script.src` con cadenas: si hace falta un sumidero nuevo, pasa por esa política y por `TestPageHasStrictCSP`. - **Acciones por SHA** con `# vX.Y.Z` (`TestThirdPartyActionsArePinnedBySHA`); dependabot actualiza ambos. Los workflows que genera la web para las personas usuarias siguen con `actions/checkout@v7` (legibles; son suyos). -- **Binario precompilado** (inactivo): paso `bin` de `action.yml`, `scripts/build-release.sh`, `.github/workflows/release.yml`, job `binario` de `action-test.yml`. Solo se activa con `release/checksums.txt` en el árbol de la etiqueta (ver `docs/DESARROLLO.md`). Si ese archivo existe, todo cambio de código exige regenerarlo (`--write`) o el CI falla. +- **Binario precompilado**: paso `bin` de `action.yml`, `scripts/build-release.sh`, `.github/workflows/release.yml`, job `binario` de `action-test.yml`. Solo se activa con `release/checksums.txt` en el árbol de la etiqueta (ver `docs/DESARROLLO.md`). Si ese archivo existe, todo cambio de código (también la plantilla de la web, que va embebida) exige regenerarlo (`--write`) o borrarlo, o el CI falla. + +## Versión 1.0.0 (26/10/2026) +- Se publica directamente la **1.0.0** (la 0.8.0 nunca salió): CLI y Action alineadas en 1.0.0 y `v1` pasa de v0.7.0 a v1.0.0. El commit de la versión lleva `release/checksums.txt` (binario precompilado activo al publicar). +- Lo que solo es cierto tras publicar (quitar «el cactus aún no está en `@v1`», «desde la versión 1.0.0» de `go run …@latest`, ejemplos `@v1.0.0`) va en la rama `v1-tras-publicar`, que además borra `release/checksums.txt` (cambia la plantilla embebida). +- Semver a partir de aquí: la interfaz de `action.yml` y el formato del SVG solo cambian de forma incompatible en una `v2`; mejoras compatibles → 1.x (menor), arreglos → parche. ## Reglas de contenido - El personaje es **diseño propio**. Prohibido imitar criaturas de videojuegos, anime o marcas. diff --git a/CHANGELOG.md b/CHANGELOG.md index 3e9d4f4..18af17e 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,15 +6,15 @@ El formato sigue [Keep a Changelog](https://keepachangelog.com/es-ES/1.1.0/) y e ## [Sin publicar] -## [0.8.0] - 2026-10-26 +## [1.0.0] - 2026-10-26 -Versión «Blindada»: seguridad, documentación, accesibilidad, una instalación guiada y una tercera especie. **La interfaz de `action.yml` no cambia** (mismas entradas, misma salida `path`, mismos archivos) y las tarjetas SVG del brote de musgo y del hongo son byte a byte las de v0.7.0 (las 96 huellas de v0.5.0 pasan). +Primera versión estable (la 0.8.0 preparada nunca se publicó: todo sale aquí). Reúne todo lo hecho desde la v0.7.0: las fases de seguridad y documentación, la instalación guiada paso a paso, la tercera especie cactus, el selector de tema de la web y el binario precompilado. **La interfaz de `action.yml` no cambia** (mismas entradas, misma salida `path`, mismos archivos) y las tarjetas SVG del brote de musgo y del hongo son byte a byte las de v0.7.0 (las 96 huellas de v0.5.0 pasan). Quien usa `BertMarti/commitling@v1` la recibe sin tocar nada. ### Añadido - **Tercera especie: el cactus** (`species: cactus`), de diseño propio: un cactus con ojos en su maceta de barro que pasa por **Yema**, **Bolita**, **Cactus**, **Cactus con brazos** y **Cactus centenario**, con las mismas reglas, ánimos y accesorios. Sale en la galería (claro, oscuro y compacta), en los dos generadores de la web, en `--species` y en la imagen de vista previa. - **Selector de tema de la web** (Sistema · Claro · Oscuro) en la cabecera: cambia la página y todas las tarjetas sin recargar, se aplica antes de pintar (sin parpadeo) y se recuerda en el navegador con la clave `commitling:theme` (solo `light` o `dark`; «Sistema» la borra y cualquier otro valor se ignora). Sin JavaScript, la web sigue al sistema como antes. -- **Binario precompilado preparado** (inactivo hasta que una release lo active): `scripts/build-release.sh` compila los binarios de forma reproducible, `release.yml` los sube al publicar una release y la Action los usa en vez de compilar **solo** si el SHA-256 coincide con el `release/checksums.txt` de su propio árbol; si no, compila con Go como siempre. +- **Binario precompilado, activo desde esta versión**: `scripts/build-release.sh` compila los binarios (Linux, macOS y Windows; amd64 y arm64) de forma reproducible, `release.yml` los sube al publicar la release y la Action los usa en vez de instalar Go y compilar **solo** si el SHA-256 coincide con el `release/checksums.txt` de su propio árbol (el de la 1.0.0 va en este commit); si no hay binario o algo falla, compila con Go como siempre. Los perfiles se ahorran el `setup-go` y la compilación en cada ejecución. - **Generador del workflow en la web** («Instálalo en tu perfil»): escribes tu usuario (o pegas el enlace de tu perfil), eliges especie, tema (claro, oscuro o **automático**, con las dos tarjetas y un ``) y tamaño, y copias el `.github/workflows/commitling.yml` y el fragmento del README ya rellenos. Seis pasos explicados para quien nunca ha usado Actions (repositorio de perfil, crear el archivo, permisos, primera ejecución con «Run workflow», README y resultado), enlaces directos a cada paso en GitHub (incluido «Abrir GitHub con el archivo ya relleno») y una lista «Si algo falla» con cada mensaje y qué hacer. Funciona sin red y sin wasm (`install.js`), no guarda nada y produce byte a byte lo mismo que `generate.Install` (test en Node y Go). - **`commitling workflow`** (alias `init`): imprime ese mismo workflow (`--user`, `--species`, `--theme light|dark|both`, `--size`) y dice qué pegar en el README. - **Mensajes de error que dicen qué hacer**, en español: usuario inexistente (404), token rechazado (401), acceso denegado (403), límite de peticiones (con la hora UTC a la que se restablece y si había token) y caídas de GitHub (5xx); el login no válido explica por qué («quita la @ del principio»…). Dentro de GitHub Actions el error sale también como anotación `::error` en el resumen de la ejecución. @@ -43,11 +43,13 @@ Versión «Blindada»: seguridad, documentación, accesibilidad, una instalació - La prueba de la Action pasa `github.repository_owner` al script por `env:` en vez de interpolarlo. - La CLI (y por tanto la Action) **escribe el SVG de forma atómica** (archivo temporal y renombrado): una ejecución cancelada a medias ya no puede dejar un SVG cortado, que `keep-on-error` necesita entero. Mismo contenido, mismos permisos (0644). - `.gitignore` ignora `.env*` (salvo `.env.example`). -- Versión de la CLI: `0.8.0`. +- Versión de la CLI: `1.0.0` (la Action y la CLI van alineadas). +- CI: el job `action` prueba siempre la ruta de `go run` (y el Go parcheado de cada llamada), sea cual sea el estado de la release, y el job `binario` prueba además la Action con el `release/checksums.txt` del repositorio contra la release real y exige que coincida con los binarios recompilados. ### Corregido -- `docs/USO.md` recomendaba fijar `@v1.0.0`, una etiqueta que no existe (el workflow fallaría): ahora remite a las releases (`@v0.7.0`). +- `docs/USO.md` recomendaba fijar `@v1.0.0` cuando esa etiqueta aún no existía (el workflow fallaba): ahora remite a las releases. +- `docs/USO.md` decía que la Action aparece en el GitHub Marketplace (aún no está publicada allí) y que la etiqueta `v1` podía no existir (existe y apunta a la última versión publicada): ahora explica que basta la línea `uses:` y qué revisar si sale «unable to find version». ## [0.7.0] - 2026-10-01 @@ -175,8 +177,8 @@ Primera versión: el MVP. - Las acciones de los workflows suben de versión para evitar Node 20 (`checkout@v7`, `setup-go@v7`, `configure-pages@v6`, `upload-pages-artifact@v5` y `deploy-pages@v5`) (PR #2). -[Sin publicar]: https://github.com/BertMarti/commitling/compare/v0.8.0...HEAD -[0.8.0]: https://github.com/BertMarti/commitling/compare/v0.7.0...v0.8.0 +[Sin publicar]: https://github.com/BertMarti/commitling/compare/v1.0.0...HEAD +[1.0.0]: https://github.com/BertMarti/commitling/compare/v0.7.0...v1.0.0 [0.7.0]: https://github.com/BertMarti/commitling/compare/v0.6.0...v0.7.0 [0.6.0]: https://github.com/BertMarti/commitling/compare/v0.5.0...v0.6.0 [0.5.0]: https://github.com/BertMarti/commitling/compare/v0.4.0...v0.5.0 diff --git a/MEMORY.md b/MEMORY.md index ff6645d..1a1ee1b 100644 --- a/MEMORY.md +++ b/MEMORY.md @@ -1,7 +1,9 @@ # MEMORY.md · commitling -Última actualización: 2026-10-26 por Claude Code (Opus 5.5, jefe de la fase 3, rama `fase3-2026-10-25`) +Última actualización: 2026-10-26 por Claude Code (Opus 5.5, jefe de la fase 5, rama `v1-2026-10-26`) ## Estado actual +**Versión 1.0.0 (fase 5, 26/10/2026, rama `v1-2026-10-26`, PR contra `main`)**: la 0.8.0 nunca se publicó y se salta: todo lo de las fases 1 a 4 sale como **v1.0.0** (CLI, Action, web y docs en 1.0.0; CHANGELOG `[1.0.0] - 2026-10-26`). El commit lleva `release/checksums.txt` de la 1.0.0 (generado tras el último cambio de código; la plantilla de la web va embebida en el binario), así que al publicar la release el workflow «Release» sube los binarios y la Action deja de compilar. Antes de publicarla, el paso `bin` recibe un 404 y compila con Go (probado en el job `binario`, que ahora prueba también la release real). El job `action` fuerza la ruta de `go run` (`COMMITLING_RELEASE_URL` a un puerto cerrado) para que el chequeo del Go parcheado no dependa de si la release existe. Lo que solo es cierto tras publicar está en la rama `v1-tras-publicar` (sin PR): quita los avisos del cactus y del `go run …@latest`, pone los ejemplos `@v1.0.0` y borra `release/checksums.txt`. `v1` sigue en v0.7.0 hasta que el orquestador la mueva. + **Fase 3 (25-26/10/2026, rama `fase3-2026-10-25`, PR contra `main`)**: v0.8.0 sigue sin publicar (fases 1 y 2 fusionadas); la fase 3 se suma a sus notas. Tercera especie `cactus` (musgo y hongo byte a byte iguales: galería comparada con `main`, 120 SVG + favicon idénticos; 8 combinaciones de la CLI idénticas), selector de tema de la web (`theme.js`, `commitling:theme`), Trusted Types en la CSP (0 violaciones en Chromium con demo, generador real y criatura en vivo), acciones por SHA y binario precompilado preparado e inactivo (paso `bin` de `action.yml`, `scripts/build-release.sh`, `release.yml`). `action.yml`: mismas entradas, salida y archivos; sin `release/checksums.txt` se comporta igual que antes (salvo `setup-go` fijado por SHA, el mismo código). **v0.8.0 «Blindada» (24/10/2026, rama `mejoras-2026-10-24`, un PR contra `main`)**: v0.7.0 está publicada y `v1` apunta a ella (mismo commit que `main`). Revisión nocturna de seguridad, documentación y accesibilidad: CSP estricta en la web (`page.js` sustituye al `