pase-cocina

Imported from Noninapizzicas/3enki (modules/cosecha/cantera/enki/pase-cocina/SKILL.md). Install upstream with npx skills add Noninapizzicas/3enki --skill pase-cocina. Copyright stays with the author.

Pase-cocina

Qué es. El módulo que materializa las fichas de pase durante el servicio. Una ficha de pase es un snapshot de la receta en el momento de servirla — congela la versión de la receta para que el chef sepa EXACTAMENTE qué se estaba sirviendo durante ese servicio, incluso si la receta cambia después.

NO toma decisiones. Solo registra. El chef/jefe revisan post-servicio.

Código: modules/pase-cocina/index.js · v1.0.0

1 · LÓGICA

Ficha de pase

Una ficha de pase es un snapshot operativo:

{
  "id": "ficha_abc123",
  "receta_id": "pizza_margarita",
  "version_receta": 3,           // versión congelada al crear la ficha
  "nombre": "Pizza Margarita",
  "servicio": "2026-07-28-cena",
  "estado": "activa",            // activa | cerrada
  "incidencias": [],              // registradas durante el servicio
  "sustituciones": [],           // cambios de emergencia
  "created_at": "2026-07-28T...",
  "created_by": "chef_01"
}

Incidencias (8 tipos canónicos)

Sustituciones

Registran cambios de emergencia de ingredientes:

{
  "ingrediente_original": "mozzarella",
  "ingrediente_sustituto": "cheddar",
  "motivo": "se acabó la mozzarella",
  "cantidad": 0.2,
  "unidad": "kg"
}

NO modifican la receta canónica. El chef decide post-servicio si incorpora el cambio al recetario.

2 · TOOLS (invocables por LLM)

pase.ficha.crear

{
  "project_id": "uuid",
  "receta_id": "pizza_margarita",
  "version_receta": 3,
  "nombre": "Pizza Margarita",
  "servicio": "2026-07-28-cena",
  "user_id": "chef_01"
}
// → 201 { "ficha": { "id": "ficha_abc123", "estado": "activa", ... } }

pase.incidencia.registrar

{
  "project_id": "uuid",
  "ficha_pase_id": "ficha_abc123",
  "tipo": "falta_ingrediente",
  "descripcion": "No hay rúcula para la pizza",
  "severidad": "media"       // baja | media | alta | critica
}
// → 201 { "incidencia": { "id": "inc_001", "tipo": "falta_ingrediente", ... } }

pase.sustitucion.registrar

{
  "project_id": "uuid",
  "ficha_pase_id": "ficha_abc123",
  "ingrediente_original": "mozzarella",
  "ingrediente_sustituto": "cheddar",
  "motivo": "se acabó la mozzarella",
  "cantidad": 0.2,
  "unidad": "kg"
}
// → 201 { "sustitucion": { "ingrediente_original": "mozzarella", ... } }

pase.ficha.obtener

{ "project_id": "uuid", "ficha_pase_id": "ficha_abc123" }
// → 200 { "ficha": { /* completa con incidencias + sustituciones */ } }

pase.fichas.listar

{ "project_id": "uuid", "servicio": "2026-07-28-cena", "estado": "activa" }
// → 200 { "fichas": [ /*...*/ ] }

3 · EVENTOS

Publica

Escucha

4 · FLUJO TÍPICO

Durante el servicio

1. CHEF materializa     → pase.ficha.crear { receta, version, servicio }
                          → ficha activa (snapshot congelado)
2. COCINA reporta       → "no hay mozzarella, usamos cheddar"
                          → pase.sustitucion.registrar { original, sustituto, motivo }
3. COCINA reporta       → "tiempo excedido en mesa 4"
                          → pase.incidencia.registrar { tipo, descripcion, severidad }
4. POST-SERVICIO        → chef revisa fichas del servicio
                          → decide si incorpora sustituciones al recetario

5 · INTEGRACIÓN

Tools: pase.ficha.crear (materializar), pase.incidencia.registrar, pase.sustitucion.registrar, pase.ficha.obtener (consulta), pase.fichas.listar (consulta).

Snapshot operativo: la ficha congela version_receta. Aunque la receta cambie, la ficha refleja lo que se sirvió en ese servicio.

No reactivo: pase-cocina solo registra. No toma decisiones automáticas (no sugiere sustituciones, no cierra fichas). El chef decide post-servicio.

Persistencia: data/projects/<slug>/pase-cocina.json.