Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .claude/skills/publicar-version/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 `<g class="bob">` de `svg/{seed,sprout,sapling,shrub}-happy.svg` y `svg/ancient-radiant.svg`, cada uno dentro de `<g transform="translate(x y) scale(0.6)">` (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.
35 changes: 35 additions & 0 deletions .github/workflows/action-test.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down Expand Up @@ -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
Expand Down
9 changes: 7 additions & 2 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 <generator.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`).
Expand All @@ -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 `<head>` sin `defer` para no parpadear): `data-theme` en `<html>`, cambia el `media` de los `<source>` 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.
Expand Down
16 changes: 9 additions & 7 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 `<picture>`) 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.
Expand Down Expand Up @@ -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

Expand Down Expand Up @@ -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
Expand Down
Loading
Loading