Releases

Vista generada desde styx.model.yml. No se edita a mano: bun run docs:gen la regenera y bun run docs:check falla si difiere. El estado aquí es el del model: si discrepa con otra página, manda el model.

Un release es un checkpoint del tren de versiones atado al roadmap (dec-0133, LOCKED). Se ordena sólo por dependencias: no hay fechas, plazos ni estimaciones. Lo publica el pass de su definition of done (verificado por alguien distinto del autor, GUARD 6), no un calendario. Los alfas se versionan 0.0.0-alpha.N; el primer v0.y.z lo corta waxin más adelante. Tener versión no publica nada. bun run check:releases valida esta sección del model.

alpha.0Copiar enlace

Esqueleto desplegado: docs y nightly de master en Coolify, privado

estado: in_progress · DoD completo

Locks que exige: dec-0133, dec-0123

Incluye, en orden de trabajo:

1. track/release-engineering/coolify-docs — Aplicación Coolify del sitio de docs desde deploy/coolify/docs.compose.yml: auto-deploy desde master, acceso privado por Tailscale (docs.vpn.) hasta la AppSec seca
2. track/release-engineering/release-entity — Entidad release en el model (dec-0133): releases: ordenado por dependencias, guard check:releases y vista generada
3. track/release-engineering/build-version — Lane A — registro de componentes, versión en cada artefacto (0.0.0 alfa clean/dirty), guards de interfaz, release:build multi-arch, OCI derivada y styx-release.json
4. track/release-engineering/runtimes-cli — Lane B — modelo de despliegue, adapters tier 1 (systemd, Quadlet, Compose), styx-postgres y CLI styx (install, update, rollback, backup, status, doctor)
5. track/release-engineering/coolify-tier1 — Coolify tier 1 operable: plantilla propia de styx, secretos como fichero y styx status/update/rollback/backup sobre Coolify
6. track/release-engineering/channels — Lane C — release-build, nightly y stable; nightly privada de master desplegada en Coolify

Definition of done (su pass dispara la publicación):

Pasa a público cuando: track/release-engineering:RE16 (open)

alpha.1Copiar enlace

MVP: primera vertical VOD web sobre biblioteca real (local + Storage Box)

estado: planned · DoD completo

Locks que exige: dec-0133, dec-0123, dec-0113, dec-0124

Incluye, en orden de trabajo:

1. track/domain-media — Discriminante live/VOD + capabilities reales
2. outcome/federated-storage/remote-measure — Medir el montaje FUSE (sólo comparador, r03), WebDAV, SFTP y SMB desde el VPS y el Mac
3. track/byte-runtime/sec — Seguridad del data plane: SCT, IPC autenticado, raíces fd-relativas, presupuestos, parsers acotados, contenedor mínimo, zkit.safety + audit:safety
4. track/identity/sec — Seguridad del control plane: sesión BFF + CSRF, policy deny-by-default, IDOR, CORS, CSP/TT, mínimo privilegio, NATS por servicio, audit
5. track/byte-runtime/tcp-edge — Origen TCP del daemon: HTTPS h1/h2 en Zig + Alt-Svc h3 (delivery-edge, P3 de waxin)
6. outcome/first-vertical/wave-a — Ola A — una película entera desde el SSD, con seek, en Chrome sin flags, por el origen TCP del daemon con certificado real
7. track/plugin-seams/w1 — Wave 1 — contracts + 4 módulos first-party + gate vertical E2E
8. track/plugin-seams/w2 — Scanner por contenido + raíz local con NFO y artwork (dec-0114): contrato scanner, huella en el daemon, orquestador incremental y plugin first-party
9. outcome/first-vertical/wave-b — Ola B — la biblioteca local aparece en la web identificada (NFO, título, año, póster) por el scanner por contenido
10. spike/swift-av-inventory — Inventario del módulo Swift de vídeo y audio de MKS IPTV: qué se porta a libav-bridge y a los clientes
11. track/media-engine/audio-transcode — Transcodificación de audio AC3/EAC3/DTS/TrueHD → AAC en libav-bridge como capability (cierra ME7)
12. track/domain-media/file-ssot — Fichero como fuente de verdad de la metadata (dec-0127): índice derivado, metadataHash, feed de cambios, artwork por hash
13. track/media-engine/metadata-embed — Metadatos incrustados: escritura in-place con journal en el daemon, SCT annotate/art, proveedores sin clave y asistente de TMDb
14. outcome/federated-storage/remote-backends — Backends remotos WebDAV/SFTP/SMB como fuentes seekables del byte runtime, medidos contra el montaje FUSE como comparador (acotado a m4 + DM2)
15. outcome/first-vertical/wave-d — Ola D — la biblioteca del Storage Box, sin montarla en el hot path, por backends remotos medidos
16. track/identity/invitations — Invitaciones simples estilo Wizarr ligadas al login sellado (un admin + testers, sin perfiles ni hogares)
17. track/identity/cli-auth — Auth del CLI: device grant RFC 8628 en identity-svc (styx login) y PAT mínimo
18. track/identity/api-keys — API keys styx_pat_/styx_sat_ con scopes ⊆ permisos, caducidad obligatoria y canje por JWT en el borde
19. track/identity/quick-connect — Quick connect de TV (8 dígitos + QR) sobre el device grant, con aprobación y elección de perfil
20. track/observability/doctor-mvp — Observabilidad mínima del MVP: OTel y logs de todas las Authority y styx doctor con probes básicos (observability#01)
21. track/observability/playback-metrics — Métricas de reproducción por sesión (TTFF, latencia de seek, stalls) exportadas a OTel; harness E1 de la ola E
22. track/docs/contract-pages — Páginas de contrato de lo implementado en el MVP, en el estado que dicen sus gates
23. track/release-engineering/appsec-dry — AppSec seca: pasada completa sin P0/P1/P2 nuevos, verificada por un panel distinto de quien arregla

Si llega (no forma parte del DoD): track/byte-runtime/ingest-web

Fuera de este release: track/devices/a2, track/devices/b0, track/devices/b1, track/devices/b2, outcome/server-federation, track/public-mode, track/web-player-v1, track/client-platform-foundation/c1, track/media-engine/download-output

Definition of done (su pass dispara la publicación):

Pasa a público cuando: track/release-engineering:RE16 (open)

alpha.2Copiar enlace

Post-MVP inmediato: runtimes medidos, hogares y perfiles, dispositivos base y resto de la ola C

estado: planned · DoD incompleto: faltan items que redactan sus tickets

Locks que exige: dec-0133, dec-0128

Incluye, en orden de trabajo:

1. track/release-engineering/runtime-bench — Lane E — benchmark reproducible de runtimes y backends de BD; orden por defecto por plataforma
2. track/identity/accounts-households-profiles — Cuentas con varias identidades, hogares opcionales con roles, perfiles con PIN, madurez y concesiones de biblioteca
3. track/devices/a0 — Contratos + registro de dispositivos (identity-svc) + presencia y foto «reproduciendo ahora» efímeras (playback-svc/Valkey, realtime-svc pasarela)
4. outcome/first-vertical/wave-c — Ola C — cualquier MKV suena y se subtitula: audio transcodificado (ME7), pistas alternativas y subtítulos

Definition of done (su pass dispara la publicación):