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
18 changes: 18 additions & 0 deletions .github/workflows/action-test.yml
Original file line number Diff line number Diff line change
Expand Up @@ -74,6 +74,21 @@ jobs:
out: out/real-dark.svg
theme: dark

# Un usuario que no existe es un error permanente: falla aunque
# keep-on-error esté activada y haya un SVG previo, que queda intacto.
- name: Preparar un SVG previo para el usuario inexistente
env:
FIXTURE_PATH: ${{ steps.fixture.outputs.path }}
run: cp "$FIXTURE_PATH" out/nouser.svg

- name: Un usuario inexistente falla con un error claro
id: nouser
continue-on-error: true
uses: ./
with:
user: commitling-usuario-que-no-existe-0
out: out/nouser.svg

# keep-on-error (activada por defecto) solo conserva el SVG ante fallos
# transitorios (red, 5xx, límite de peticiones), que cubren los tests de
# la CLI. Un 401 (token inválido) es permanente: debe fallar aunque haya
Expand Down Expand Up @@ -120,6 +135,7 @@ jobs:
INVALID_OUTCOME: ${{ steps.invalid.outcome }}
UNAUTHORIZED_OUTCOME: ${{ steps.unauthorized.outcome }}
BADKEEP_OUTCOME: ${{ steps.badkeep.outcome }}
NOUSER_OUTCOME: ${{ steps.nouser.outcome }}
OWNER: ${{ github.repository_owner }}
run: |
set -euo pipefail
Expand All @@ -130,6 +146,8 @@ jobs:
test "$UNAUTHORIZED_OUTCOME" = failure || { echo 'un 401 debería fallar aunque haya SVG previo'; exit 1; }
test "$BADKEEP_OUTCOME" = failure || { echo 'keep-on-error: quizas debería fallar'; exit 1; }
test ! -e out/badkeep.svg
test "$NOUSER_OUTCOME" = failure || { echo 'un usuario inexistente debería fallar'; exit 1; }
cmp out/nouser.svg "$FIXTURE_PATH" || { echo 'el SVG previo del usuario inexistente cambió'; exit 1; }
cmp out/keep.svg "$FIXTURE_PATH" || { echo 'el SVG previo cambió'; exit 1; }
for f in "$FIXTURE_PATH" "$MUSHROOM_PATH" "$COMPACT_PATH" "$REAL_PATH"; do
test -s "$f"
Expand Down
29 changes: 28 additions & 1 deletion .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -73,11 +73,38 @@ jobs:
run: |
go run ./cmd/commitling gallery --out out/site
test -s out/site/index.html
ls out/site/svg | wc -l
find out/site/svg -type f | wc -l

- name: versión
run: go run ./cmd/commitling version

# Every workflow that the web generator and `commitling workflow` can
# produce (the web builds the same bytes; a test compares them) must be
# a valid GitHub Actions workflow that uses @v1: actionlint (official
# binary, pinned SHA-256) also runs shellcheck on its `run:` script.
- name: workflows generados (actionlint)
if: runner.os == 'Linux'
env:
ACTIONLINT_VERSION: "1.7.12"
ACTIONLINT_SHA256: "8aca8db96f1b94770f1b0d72b6dddcb1ebb8123cb3712530b08cc387b349a3d8"
run: |
set -euo pipefail
go build -o "$RUNNER_TEMP/commitling" ./cmd/commitling
mkdir -p out/wf
"$RUNNER_TEMP/commitling" workflow > out/wf/base.yml 2>/dev/null
for sp in moss mushroom; do for th in light dark both; do for sz in full compact; do
"$RUNNER_TEMP/commitling" workflow --user octocat --species "$sp" --theme "$th" --size "$sz" > "out/wf/$sp-$th-$sz.yml" 2>/dev/null
done; done; done
if grep -L 'uses: BertMarti/commitling@v1$' out/wf/*.yml | grep .; then echo "sin @v1"; exit 1; fi
if grep -l 'commitling@main' out/wf/*.yml; then echo "con @main"; exit 1; fi
tgz="actionlint_${ACTIONLINT_VERSION}_linux_amd64.tar.gz"
curl -fsSLo "$RUNNER_TEMP/$tgz" "https://github.com/rhysd/actionlint/releases/download/v${ACTIONLINT_VERSION}/$tgz"
echo "${ACTIONLINT_SHA256} $RUNNER_TEMP/$tgz" | sha256sum -c -
tar -xzf "$RUNNER_TEMP/$tgz" -C "$RUNNER_TEMP" actionlint
command -v shellcheck
"$RUNNER_TEMP/actionlint" -color out/wf/*.yml .github/workflows/*.yml
echo "$(find out/wf -name "*.yml" | wc -l) workflows generados válidos"

# Security checks: known vulnerabilities in Go and its standard library
# (govulncheck), static analysis (staticcheck, also for the wasm build) and
# secrets in the whole history and the working tree (gitleaks, official
Expand Down
2 changes: 2 additions & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,6 +62,8 @@ Una mascota pixel-art **original** que vive en el README de tu perfil de GitHub.
- **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`).
- **CSP de la web** (`<meta http-equiv="Content-Security-Policy">` en `index.html.tmpl`): no se admiten `<script>` en línea ni atributos `on…=`. Lo pequeño va a `internal/gallery/page.js` (embebido y escrito por `gallery.Build`), el generador a `generator.js`. Si la web necesita otro origen, hay que añadirlo a la CSP y a `TestPageHasStrictCSP`.
- **Generador del workflow** (`internal/gallery/install.js`, sección `#instalar`): JavaScript sin red, sin wasm y sin almacenamiento que debe dar byte a byte lo mismo que `generate.Install` (`TestInstallJSMatchesGo`, `node internal/gallery/testdata/install.test.js internal/gallery/install.js`). `commitling workflow` imprime lo mismo; el CI valida las 13 variantes con actionlint.
- Estilos solo en `internal/gallery/style.css` (CSP `style-src 'self'`): nada de `<style>` ni `style=` en la plantilla.
- Seguridad local (lo mismo que el job «seguridad» del CI): `go run golang.org/x/vuln/cmd/govulncheck@v1.9.0 ./...`, `go run honnef.co/go/tools/cmd/staticcheck@2026.2.2 ./...` (y con `GOOS=js GOARCH=wasm` sobre `./cmd/wasm`), `gitleaks git . --redact`.
- Cabecera del README: `docs/img/banner.svg` se generó con los `<g class="bob">` de los SVG reales de la galería (fases contento y árbol radiante) a escala 0,6; si cambian los sprites, regénerala igual (receta en `.claude/skills/publicar-version/SKILL.md`).
- En la Raspberry Pi de Alberto (4 núcleos, compartida): `GOFLAGS=-p=2` y nunca dos builds a la vez.
Expand Down
11 changes: 10 additions & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,10 +8,16 @@ El formato sigue [Keep a Changelog](https://keepachangelog.com/es-ES/1.1.0/) y e

## [0.8.0] - 2026-10-24

Versión «Blindada»: seguridad, documentación y accesibilidad. **`action.yml` no cambia** (mismas entradas, misma salida `path`, mismos archivos) y las tarjetas SVG son byte a byte las de v0.7.0 (las 96 huellas de v0.5.0 pasan).
Versión «Blindada»: seguridad, documentación, accesibilidad y una instalación guiada. **La interfaz de `action.yml` no cambia** (mismas entradas, misma salida `path`, mismos archivos) y las tarjetas SVG son byte a byte las de v0.7.0 (las 96 huellas de v0.5.0 pasan).

### Añadido

- **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.
- El workflow de ejemplo explica en el propio log por qué falla el `git push` («No se pudo guardar la criatura en el repositorio»: `permissions: contents: write` o rama protegida). El paso se llama ahora «Guardar la criatura si ha cambiado».
- CI: los 13 workflows que pueden generarse se validan con **actionlint** (con shellcheck) y deben usar `@v1`; la prueba de la Action comprueba que un usuario inexistente falla.

- **Content-Security-Policy estricta en la web**: solo scripts propios (más `'wasm-unsafe-eval'` para el generador), conexiones solo a la propia web y a `api.github.com`, sin `object`, `base` ni formularios externos; `referrer` `strict-origin-when-cross-origin` y `theme-color` para claro y oscuro. El script de los botones «Copiar» y el aviso de criatura en vivo no disponible pasan a `page.js` (antes eran un `<script>` y un `onerror` en línea, que la CSP bloquearía). Test `TestPageHasStrictCSP`.
- **Job «seguridad» en el CI**: `govulncheck` (sin vulnerabilidades con Go 1.27.3), `staticcheck` (también del wasm, sin avisos) y `gitleaks` sobre todo el historial (binario oficial con SHA-256 fijado).
- `.github/dependabot.yml` (Actions y Go, semanal y agrupado) y `SECURITY.md`.
Expand All @@ -21,6 +27,9 @@ Versión «Blindada»: seguridad, documentación y accesibilidad. **`action.yml`

### Seguridad

- La Action **enmascara el token** (`::add-mask::`) antes de ejecutar nada, también si alguien lo pega en claro en `token:`; los mensajes de error nunca lo incluyen (test).
- **CSP sin `'unsafe-inline'` en estilos**: el CSS pasa a `style.css` y desaparecen los atributos `style=` (todas las webs de `bertmarti.github.io` comparten origen). La web no guarda nada en `localStorage` ni cookies.

- **La Action, el CI y Pages compilaban con Go 1.27.0**, que tiene 11 vulnerabilidades conocidas en la biblioteca estándar que commitling usa (`net/http`, `net/http/internal/http2`, `net/textproto`, `crypto/tls`, `crypto/x509` y `html/template`; GO-2026-6599 a GO-2026-6809), porque `setup-go` instalaba exactamente la versión de `go.mod`. `go.mod` declara ahora `go 1.27.3` (la última), así que todo se compila con ella, también cuando la Action se usa varias veces en el mismo job (claro y oscuro): una línea `toolchain` no bastaba, porque el primer `setup-go` exporta `GOTOOLCHAIN=local` y el segundo volvía a instalar 1.27.0. Lo destapó el nuevo job de govulncheck; la prueba de la Action comprueba ahora la versión de Go tras varias llamadas.

### Cambiado
Expand Down
9 changes: 9 additions & 0 deletions MEMORY.md
Original file line number Diff line number Diff line change
Expand Up @@ -151,6 +151,14 @@ Pulido de v0.4.0 (rama `agent/builder/v0.4-pulido`, un PR contra `main`, tras la
- 2026-10-24 (Claude Opus, tras la revisión final de Fable): **`go 1.27.3` en go.mod** (sin línea `toolchain`). Con `go 1.27.0`, `setup-go` (CI, Pages y la propia Action en los perfiles) instalaba Go 1.27.0, con 11 vulnerabilidades de la biblioteca estándar alcanzables (net/http, http2, textproto, crypto/tls, crypto/x509, html/template). El job de govulncheck lo detectó en el primer CI. Primero se probó `toolchain go1.27.3`, pero no basta: `setup-go` exporta `GOTOOLCHAIN=local` y la **segunda** llamada a la Action en el mismo job (el perfil de BertMarti la usa dos veces: claro y oscuro) ignoraba `toolchain` e instalaba 1.27.0. La línea `go` es lo que lee `setup-go` siempre. Mantenerla en el último parche (dependabot no la sube): mirar https://go.dev/dl/?mode=json y subir también el mínimo de `TestGoModPinsAPatchedGo` (`action-test.yml` lee la versión de `go.mod`).
- 2026-10-24 (Claude Opus): versión 0.8.0 (menor: nada incompatible). No se mueven etiquetas.

### Fase 2 (24/10/2026, tarde)
- **Generador del workflow en JavaScript, no en wasm**: tiene que ser instantáneo, funcionar sin la descarga de 2,6 MB y sin red. Para no tener dos verdades, `generate.Install` (Go) es la referencia y `TestInstallJSMatchesGo` compara las 48 combinaciones (4 usuarios × especie × tema × tamaño) byte a byte con `install.js`. Si cambias `BaseWorkflow`, cambia también la copia literal de `install.js` (el test lo detecta).
- **Tema «both»** solo existe en `Install`/`commitling workflow`/la web (dos pasos de la Action y `<picture>`); la Action sigue aceptando solo `light`/`dark`.
- **El aviso de permisos va en el workflow de ejemplo** (`if ! git push; then echo "::error…"`): el `git push` es del workflow de la persona, no de la Action, así que la Action no puede detectarlo. Quien ya pegó el workflow antiguo no lo verá hasta copiar el nuevo.
- **Errores de la Action**: `APIError` guarda `User`, `Reset` y si había token para explicar qué hacer; nunca el token (test). En Actions, el error fatal se repite como `::error title=commitling::` (escapado, una línea).
- **CSS en `style.css`**: todas las webs de `bertmarti.github.io` comparten origen, así que la CSP no admite `'unsafe-inline'` ni en estilos; prohibido `style=` y `<style>` en la plantilla (`TestPageHasStrictCSP`). La web no persiste nada salvo la caché de eventos públicos en `sessionStorage` (`commitling:events:*`).
- Los enlaces directos usan `github.com/<u>/<u>/new/main?filename=…&value=…`: si la rama principal no se llama `main`, la página lo avisa y se crea a mano.

## Siguiente paso
-4. v0.8.0: fusionar el PR de `mejoras-2026-10-24`; tras el despliegue, abrir la web con la consola y comprobar que la CSP no bloquea nada (demo, generador, descarga); crear la release `v0.8.0` y mover `v1`; activar «Private vulnerability reporting». Ver `PLAN.md`.
-3. v0.7.0: fusionar #51, #52, #53 y el PR de documentación (#50) en ese orden; con el despliegue hecho, abrir el generador con un usuario real (el wasm debe bajar ~2,6 MB: se ve en el resumen del job de despliegue y en la pestaña Red), probar el límite agotado con un `fetch` falso o desde una IP gastada (aviso con hora y botón «Ver demo») y crear la release `v0.7.0` (la CLI ya dice `0.7.0`; notas desde `CHANGELOG.md`); mover `v1` a ella si quiere (las entradas de `action.yml` no cambian).
Expand Down Expand Up @@ -207,3 +215,4 @@ Pulido de v0.4.0 (rama `agent/builder/v0.4-pulido`, un PR contra `main`, tras la
- 2026-10-01 builder · Claude Code Sonnet (agent/builder/50-docs-version): v0.7.0 #50: CLI 0.7.0 (y su test), CHANGELOG `[0.7.0]`, README, `docs/USO.md`, AGENTS.md y MEMORY.md al día.
- 2026-10-01 builder · Claude Code Sonnet (agent/builder/47..50): v0.7.0 revisión (R-1, O-1, O-3, O-7, O-8) añadida con commits y merges entre las ramas.
- 2026-10-24 Claude Code · Opus 5.5 (jefe) con OpenCode (GPT-5.6 Luna, MiMo Zen) (mejoras-2026-10-24): v0.8.0 «Blindada»: CSP y `page.js`, CI de seguridad, permisos mínimos, dependabot, SECURITY.md, tests de inyección y escape, README de usuario con cabecera, DESARROLLO.md, PLAN.md, `.claude/`.
- 2026-10-24 (tarde) Claude Code · Opus 5.5 (jefe) con OpenCode (GPT-5.6 Luna) (fase2-2026-10-24): generador del workflow en la web (`install.js`, paridad con `generate.Install`), `commitling workflow`, errores de la API accionables y anotación `::error`, push con aviso de permisos, `::add-mask::` del token, actionlint en el CI, CSS en `style.css` (CSP `style-src 'self'`).
5 changes: 5 additions & 0 deletions PLAN.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,11 @@ Hoja de ruta priorizada. Fechada el 24/10/2026. Las etiquetas, releases y mover
- Tests de regresión: sin `${{ }}` en `run:`, workflows con permisos y escape de logins hostiles en todas las tarjetas.
- README para personas usuarias con cabecera pixel-art (sprites reales) y `docs/DESARROLLO.md`; `.claude/agents` y `.claude/skills`; corregido `@v1.0.0` inexistente en `docs/USO.md`.

## Hecho en la fase 2 (24/10/2026, tarde, rama `fase2-2026-10-24`)
- Generador del workflow en la web (usuario → especie/tema/tamaño → YAML y README; 6 pasos y «Si algo falla»), `commitling workflow`.
- Errores de la API en español y accionables, anotación `::error` en Actions, aviso de permisos en el `git push` del workflow de ejemplo.
- Token enmascarado en la Action, actionlint sobre los 13 workflows generables, CSP sin `'unsafe-inline'` en estilos.

## Siguiente (por orden)
1. **Alberto**: fusionar el PR, crear la release `v0.8.0` con las notas del CHANGELOG y mover `v1` a ella (la Action es compatible: mismas entradas, salida y SVG byte a byte).
2. **Alberto**: activar «Private vulnerability reporting» en Settings → Security (lo enlaza `SECURITY.md`).
Expand Down
Loading
Loading