El sistema zen

Cómo está montado el trabajo detrás de esta web: los ejercicios viven en packs, unas pocas herramientas de terminal los eligen, los prueban y los entregan, y la web copia la misma estructura. Empezó en la piscine y ahora abarca el cursus entero; la idea es que el outer core entre igual.

01La idea

En 42 te pasas el día haciendo las mismas cuatro cosas: editar, mirar la norma, compilar y probar. El sistema zen hace que las tres últimas pasen solas. Eliges un ejercicio una vez y una ventana de terminal partida en paneles se pone a vigilarlo: uno enseña el árbol de ficheros, otro pasa la norma y otro relanza los tests cada pocos segundos. Tú solo escribes; si algo se pone en rojo, lo ves al momento.

+---------------+-------------+---------------+
|               | watch tree  |               |
| zenpack       +-------------+ asistente     |
|   + shell     | norminette  |               |
|               +-------------+---------------+
|               | watch tests | shell del pack|
+---------------+-------------+---------------+

Todo se apoya en un truco muy simple: un único fichero de estado, ~/.local/state/zenidx/current-pack, que guarda la ruta del pack activo. Solo zenpack lo escribe; todos los demás lo leen en cada vuelta. Por eso, al cambiar de ejercicio, los seis paneles se reapuntan sin reiniciar nada.

Por qué scripts sueltos — Cada herramienta es un script de shell pequeño que hace una cosa y lleva su ayuda en la cabecera. Se comunican por ese fichero y no por un programa central, así que se pueden usar a mano, en un panel o desde otro script, y zenhelp monta el mapa leyendo esas cabeceras en vez de duplicarlas.

02Qué es un pack

Un pack es una carpeta por proyecto con todo lo que hace falta para trabajarlo:

~/zenidx/packs/ETAPA/[MN/]NNN_nombre/
├── repo/          lo que se entrega (ex00, ex01, ... o el proyecto entero)
├── test/          Makefile + test.c  →  compila un binario `runner`
├── subject.pdf    el enunciado (y subject.txt, su texto)
└── extra/         lo que no se entrega: pruebas, scripts, notas

La separación importa: repo/ es exactamente lo que verá la Moulinette, y nada de test/ ni de extra/ puede colarse en la entrega. El repositorio ZenidX/Projects42 versiona los packs enteros; vogsphere solo recibe cada repo/.

03Etapas, milestones y números

La etapa es el tramo de 42: piscine y cursus. Dentro, los packs van numerados del 000 al 999 en el orden en que se hacen, que casi nunca es el alfabético:

packs/piscine/000_shell00 … 015_c13, 016_rush00 … 019_bsq
packs/cursus/M0/000_C-piscine-reloaded, M0/001_Libft
packs/cursus/M1/100_ft_printf, 101_get_next_line, 102_push_swap, 103_Exam_atonement
packs/cursus/M2/200_Born2beroot … 213_Exam_Rank_02
…
packs/cursus/M6/600_ft_transcendence … 602_Exam_Rank_06

La piscine son 20 packs y cabe en una lista. El cursus son más de treinta, así que se parte en milestones: un directorio MN/ por cada rank de la intra, y la centena del número sigue al milestone (M1/100, M2/200…). Los títulos salen de packs/cursus/.milestones, y con ese fichero el menú de zenpack pregunta primero por el rank y luego por el proyecto. El reparto de proyectos por rank se leyó del holy graph de la intra, siguiendo el camino 42next. La galaxia de esta web lo dibuja igual.

Para elegir no hace falta escribirlo entero: zenpack 005_c03, zenpack c03 y zenpack 005 llevan al mismo sitio.

04Las herramientas

ComandoQué hace
zenpackElige o crea (-n) el pack activo y te deja en su repo/. Es el único que escribe el estado.
zeninEjecuta un comando dentro del pack activo: la pieza básica de los paneles.
zenwatchEnvuelve zenin en watch -n; con Ctrl+C deja una shell viva en vez de cerrar el panel.
zentestcd <pack>/test && make && ./runner ../repo; con --compact, resumen para el panel.
zennormnorminette, o flake8 si el repo es de Python; los flags especiales de un pack van en su .zennorm.
zenshell / zcdUna shell dentro del pack, o saltar a él desde la shell en la que estás.
zenlibftCopia la libft maestra a un proyecto y trae de vuelta lo nuevo.
zengitgit para los repos de vogsphere, con el .git fuera del pack.
zen / zenlayoutMenú de ajustes (layout, ritmo de cada panel) y abrir el layout en Terminator.
zenhelpEl mapa de todo; zenhelp zengit enseña la ayuda de uno.

Todo vive en tools/zen/ y se instala copiando los scripts a ~/.local/bin con ./install.sh, que se puede relanzar las veces que haga falta y guarda una copia .bak de lo que pisa. El PATH va en ~/.zshenv y no en ~/.zshrc porque los paneles arrancan la shell en modo no interactivo, que no lee .zshrc.

05Cómo funcionaba en la piscine

En la piscine cada módulo era un pack con su test/. El día a día era:

  1. zenpack c03: el layout se pone a vigilar C 03.
  2. Escribir ex00/ft_strcmp.c. En segundos, el panel de norminette dice si cumple la norma y el de tests compila y lo prueba.
  3. Cuando todo está en verde, entregar repo/ a vogsphere.

Los runners de C 00 a C 08 salen de una plantilla común: una cabecera, los casos de cada módulo y un final. El runner se recompila una vez por ejercicio, hace #include del fuente del alumno y anula su main con -Dmain= para poder llamar a sus funciones. Cada caso corre en un proceso hijo con tiempo límite, así que un segfault o un bucle infinito marcan ese caso como CRASH o TIMEOUT y el resto sigue.

La excepción de C 08 — En C 08 casi todo lo que se entrega son cabeceras, así que el runner no solo ejecuta código. También genera ficheros mínimos y los compila con -fsyntax-only para distinguir «no está declarado» de «está declarado con otro tipo». Ese módulo obliga además a escribir macros con parámetros, que la norminette prohíbe: por eso zennorm admite flags propios de cada pack, y el panel no se queda en rojo por errores que no puedes arreglar.

Las páginas de la piscine documentan esas soluciones ejercicio a ejercicio.

06Lo que añadió el cursus

El salto al cursus cambió la escala: pasó de 20 módulos de un día a decenas de proyectos de semanas, repartidos por ranks. El sistema creció en cuatro direcciones:

07Entregar: zengit y vogsphere

Cada entrega es su propio repo de git en vogsphere, pero los ficheros también están versionados en ZenidX/Projects42. Si cada repo/ llevara su .git dentro, el repo grande solo vería un puntero vacío (un gitlink) en lugar de los ficheros. La solución de zengit es guardar el .git de cada entrega fuera, en ~/.local/share/zenidx-vogsphere/<slug>.git, con core.worktree apuntando de vuelta al pack:

cd ~/zenidx/packs/cursus/M1/100_ft_printf
zengit init
zengit remote add origin vogsphere@…:vogsphere/<id>
zengit add . && zengit commit -m "entrega" && zengit push

El árbol de trabajo es siempre el que se registró en el alta, así que zengit add . desde la raíz del pack solo añade lo que hay en repo/, nunca el enunciado ni los tests.

08La web sigue a los packs

Esta web es web/ dentro del mismo repositorio y copia su estructura:

packs/piscine/004_c02/          →  web/piscine/004_c02.html
packs/cursus/M1/102_push_swap/  →  web/cursus/M1/102_push_swap.html

Cada proyecto hecho tiene una página con su código explicado, un glosario de teoría y las preguntas probables de la evaluación. Los que faltan tienen una ficha «pendiente» que explica el enunciado sin dar la solución. Con cada push a main que toque web/, un GitHub Action la publica en GitHub Pages.

09Lo que viene: el outer core

Después del common core (los ranks 00 a 06) llega el outer core, la parte de especialización del cursus. El sistema está pensado para que entre sin cambiar ninguna herramienta: será una etapa más, packs/outercore/, con sus milestones en un .milestones si hacen falta, sus packs numerados y su reflejo en web/. zenpack, zentest y zengit ya entienden cualquier etapa, porque no tienen ninguna lista de proyectos escrita dentro. En la galaxia, el outer core es el anillo exterior, de momento vacío.