/publicar — publicar un video ya listo en @ia.punto.es
Toma un video terminado (en cualquier proyecto), lo revisa, escribe el caption, te lo muestra y, solo con tu OK explícito, lo programa como una pieza extra del calendario. Nunca reemplaza una pieza del planificador.
Cómo se llama el comando (siempre así)
npm --prefix ~/Documents/Claude/Carrusel-render run -s publicar -- <sub> "<video>" …
Siempre en Carrusel-render, nunca en Carrusel. Por qué: el render horario del Mac busca la
carpeta final con su manifiesto en el output/ de Carrusel-render; si el comando corre desde otro
lugar, el render no la encuentra, intenta re-renderizar la pieza y la marca fallida. Eso también
significa que publicar solo existe ahí después de que la rama se mergee a main.
Subcomandos (todos imprimen JSON en stdout; los errores salen por stderr con ✗ … y código 1):
| Subcomando | Qué hace |
|---|---|
revisar "<video>" [--transcribir] |
Inspecciona el video y saca cuadros. No escribe en la base. |
programar "<video>" --cuando "<ahora|AAAA-MM-DD HH:MM>" --hook "<texto>" --caption-file "<ruta absoluta>" [--id <id>] [--dry-run] |
Con --dry-run valida y no escribe nada; sin él, deja la pieza programada. |
Flujo (en este orden)
Ruta del video. Pídela si Felipe no la dio. Siempre absoluta (si es relativa, resuélvela con el directorio del proyecto donde está trabajando).
Revisar. Corre
revisar "<video>" --transcribir. Devuelve:info(ancho,alto,duracionMs,codec,tieneAudio),errores,avisos,cuadros(cover,story,clave[]: rutas de imágenes),transcripcion(solo con--transcribir),hashtagsBaseysemanasConPlan.- Si
errorestrae algo (no vertical, < 3 s, > 900 s, códec que no sirve): muéstralos y para. - Si
avisostrae algo: muéstralos y pregunta si sigue. Si el aviso dice que el aspecto no es 9:16, dile claro que la portada y la story recortan los bordes. - Si
revisar --transcribirfalla (sale con✗y sin JSON), vuelve a correrrevisarsin--transcribiry avisa que no hay transcripción. Lo mismo si el video no tiene audio.
- Si
Cuándo. Pregunta «¿cuándo lo quieres publicar?» y traduce la respuesta:
- «ahora» →
--cuando ahora(el próximo :00 o :30 con al menos 15 min de margen). - Día y hora →
--cuando "AAAA-MM-DD HH:MM"(hora de Chile). Resuelve «mañana», «el viernes» con la fecha de hoy. - Si la hora no es
:00ni:30, proponle la más cercana y espera su respuesta. - Solo valen semanas que ya tienen plan (
semanasConPlanderevisar). Si el error dice que la semana aún no tiene plan, explícaselo y pídele otra fecha.
- «ahora» →
Caption y hook. Mira con Read los
cuadros.clave(y lee la transcripción si hay). Escribe:- hook: una frase corta que diga lo que el video entrega (va en
--hook). - caption, para quien está aprendiendo: una idea, una acción, un ejemplo simple, sin
jerga sin explicar. Firma como @ia.punto.es con «Te ayudo a partir…»; nunca con el
nombre de Felipe. Termina con los
hashtagsBaseque devolviórevisar. - Límites: máximo 2200 caracteres y 30 hashtags.
- Guarda el caption en un archivo del scratchpad (con Write, no con heredoc) y pásalo a
--caption-file, siempre con ruta absoluta: el comando resuelve las rutas relativas contraCarrusel-render, no contra tu proyecto.
- hook: una frase corta que diga lo que el video entrega (va en
Simulacro. Corre
programar … --dry-run(no escribe nada). Devuelvesemana,id,dia,hora,cercanas(ids de piezas a menos de 2 h),avisos,carpeta,programada: false. Úsalo para validar día, hora, id y cercanías antes del OK. Luego muestra todo:- el caption completo y el hook;
- la portada (
cuadros.cover) y la story (cuadros.story) derevisar, con Read; - día y hora resueltos, y el
id; - las
cercanas(si hay, avisa que quedaría a menos de 2 h de esas piezas) y losavisos.
Esperar el OK. Solo un OK explícito en el chat («publícalo», «ok, programa», «dale adelante») sirve. Si pide cambios (caption, hora, hook), aplícalos, repite el paso 5 y vuelve a mostrar. Cualquier cambio exige un nuevo
--dry-runy un nuevo OK.Programar. Con el OK, corre el mismo comando sin
--dry-runy contimeout: 600000en la herramienta Bash (sube el plan a la base y dispara el render en línea, que puede pasar los 2 min por defecto; si Bash lo corta entre el plan y el push, queda a medias). Devuelve lo mismo másprogramada,render(ok,salida) ysubida. Reporta segúnsubida, nunca muestres URLs (llevan token):subida: true→ quedó programada y la subida está confirmada y verificada por el render (render.jsonenrenderizado).subida: false→ quedó programada, pero el render aún no la subió: el render horario la subirá antes de la hora; conviene revisar más tarde.render.okenfalse→ muestra lasalidatal cual (sin URLs); la pieza sigue programada y el render horario reintenta.- Error que dice «No quedó nada programado» → díselo tal cual y que puede reintentar.
- Error que dice «No pude deshacer» → muéstrale los comandos de limpieza que trae el error, tal cual; no los corras tú.
programada: truecon algo enavisos(por ejemplo «el commit llegó a la base pero la verificación falló») → muéstralo tal cual.- Error «publicar solo corre desde …» → corriste el comando fuera de
Carrusel-render; usa la forma de arriba. - Error «queda a menos de 15 min» → pídele otra hora o usa «ahora».
- Error «el hook necesita letras o números» → pasa
--idcon un id propio (minúsculas, números y guiones) y repite el--dry-run. - Error «id repetido» → antes de reintentar, revisa si esa pieza ya quedó programada (no se
debe programar dos veces): mira
plan.jsonde la semana en el clon de la base o pregúntale a Felipe. Si no existe, usa--idcon otro id. - Cualquier otro error: muéstralo tal cual y no reintentes sin avisarle.
Prohibido
- Correr
programarsin--dry-runantes del OK explícito de Felipe (y solo después de haberle mostrado el caption, la portada, la story, el día y la hora). - Reemplazar o mover piezas del planificador.
- Editar
render.jsonoestado.json, o tocar a manoplan.jsony la carpeta de salida. - Correr el comando desde
Carruselo desde el proyecto del video. - Poner el nombre de Felipe en el caption o el hook.