HyperFrames-Gradle : Trasforma l'AsciiDoc in Video MP4

@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultFontSize 11

title Pipeline hyperframes-gradle

rectangle "AsciiDoc\nsorgente" as adoc #LightYellow
rectangle "AsciidoctorJ" as asciidoctorj #LightBlue
rectangle "HTML HyperFrames\n(attr. data-*)" as html #LightGreen
rectangle "HyperFrames CLI\n(Node.js 22+)" as cli #Lavender
rectangle "video.mp4" as mp4 #Gold

adoc -right-> asciidoctorj : parse blocs customs
asciidoctorj -right-> html : génère HTML
html -right-> cli : ProcessBuilder\nnpx hyperframes render
cli -right-> mp4 : Puppeteer + FFmpeg
@enduml

= Formation Docker & Kubernetes
:hyperframes-width: 1920
:hyperframes-height: 1080
:hyperframes-fps: 30

[hyperframes-composition, id="intro"]
== Introduction

Le titre apparaît avec un fondu GSAP sur fond vidéo.

[hyperframes-track, index=0, start=0, duration=6]
video::assets/background.mp4[muted, playsinline]

[hyperframes-track, index=1, start=1, duration=4]
Formation Docker & Kubernetes

[hyperframes-animation, type=gsap]

class RenderHyperframesTask : DefaultTask() {

    @TaskAction
    fun render() {
        val process = ProcessBuilder(
            "npx", "hyperframes", "render",
            "--input", inputHtml.absolutePath,
            "--output", outputMp4.absolutePath
        )
            .inheritIO()
            .start()

        val exitCode = process.waitFor()
        require(exitCode == 0) {
            "HyperFrames render failed with exit code $exitCode"
        }
    }
}

----
----
tasks.register<JavaExec>("bake") {
    mainClass.set("org.jbake.launcher.Main")
    classpath = configurations["jbake"]
    args = listOf(projectDir.absolutePath, "$buildDir/jbake")
}`slider-gradle`(chi chiama AsciidoctorJ). Niente di nuovo sotto il sole — semplicemente applicato a uno strumento più recente.

== Due Plugins Video, Due Usi

|===
| |capsula-gradle |hyperframes-gradle |Source |Deck reveal.js (HTML esistante) |AsciiDoc → HyperFrames HTML |Caso d'uso |Capsula di revisione |Video standalone esplicativa |Natura |Diapositive → video |Documento → video |reso |Playwright Java → WebM |HyperFrames CLI → MP4 |Animazione |Transizioni reveal.js nativi |GSAP/CSS attributi data |pila |100% JVM (Kotlin) |### Integrazione Gradle
JBake può essere integrato nelle build Gradle utilizzando il plugin JBake per Gradle oppure richiamando direttamente la CLI di JBake:

----

tasks.register<JavaExec>("bake") { mainClass.set("org.jbake.launcher.Main") classpath = configurations["jbake"] args = listOf(projectDir.absolutePath, "$buildDir/jbake") }

|===
|===

|EPIC |Description |Priorità |HF-0 |Bootstrap governance + inquadramento architettura |TERMINATO |HF-1 |Plugin Gradle stub + integrazione AsciidoctorJ |P0 |HF-2 |### Integrazione Gradle JBake può essere integrato nelle build Gradle utilizzando il plugin JBake Gradle oppure chiamando direttamente la CLI di JBake:

----

tasks.register<JavaExec>("bake") { mainClass.set("org.jbake.launcher.Main") classpath = configurations["jbake"] args = listOf(projectDir.absolutePath, "$buildDir/jbake") } |P1 |HF-3 |DSL AsciiDoc abitudini (blocchi, docinfo, template) |P1 |HF-4 |Integrazione runner-gradle (metadata.json) |P2 |HF-5 |Template pronti all'uso (title-card, code-diff, captions) |P3 |HF-6 |CI + pubblicazione Maven Central / Gradle Portal |P3

|===
|===

AsciiDoc ──→ slider-gradle ──→ deck reveal.js ──→ capsule-gradle ──→ WebM (capsula ripasso)

AsciiDoc ──→ hyperframes-gradle ──→ MP4 (video standalone)

L'utente scrive un singolo file AsciiDoc. slider-gradle produce le slide. capsule-gradle produce la capsula di revisione. hyperframes-gradle produce il video di teasing e le demo tecniche.

== I 6 EPIC della Roadmap

Il plugin è strutturato in 6 EPICs:

|===
|EPIC |Descrizione |Priorità |HF-0 |Bootstrap governance + inquadramento architettura |✅ COMPLETATO |HF-1 |Plugin Gradle stub + integrazione AsciidoctorJ |P0 |HF-2 |Bridge CLI HyperFrames (ProcessBuilder → npx → MP4) |P1 |HF-3 |Personalizzazioni DSL AsciiDoc (blocchi, docinfo, template) |P1 |HF-4 |Integrazione runner-gradle (metadata.json) |P2 |HF-5 |Template pronti all'uso (title-card, code-diff, captions) |P3 |HF-6 |CI + pubblicazione Maven Central / Gradle Portal |P3
|===

La session 000 (bootstrap) è già terminata. La session 001 attaccherà HF-1 : lo stub del plugin Gradle e l'integrazione AsciidoctorJ.

== Perché Funziona

Tre ragioni:

1. *HyperFrames è "built for agents"*. La mia pipeline si basa su agenti IA

(planner-gradle + deepseek) che generano contenuti. HyperFrames accetta del HTML puro — il formato che i LLM padroneggiano meglio. Niente React, niente di JSX, nessuna curva di apprendimento per l'agente.

1. *Il DSL di AsciiDoc è naturale*. Tutto il mio ecosistema parla AsciiDoc.

slider-gradle, codex-gradle, training-gradle — consumano tutti del`.adoc`Please provide the text you would like me to translate. Aggiungere blocchi custom`[hyperframes-composition]`è un'estensione logica, non una rottura.

1. *Il bridge Node.js è un pattern collaudato*. ProcessBuilder fuori dalla JVM,

è quello che faccio già per PlantUML, Graphviz, Piper. Aggiungere HyperFrames non cambiare nulla nell'architettura — è un ulteriore strumento esterno, gestito da Gradle.

[NOTE]
====
La vera forza del pattern è che non c'è *alcuna* dipendenza npm in il build Gradle. Il plugin non importa codice Node.js. Esegue una comando shell. Se HyperFrames evolve o si rompe, il plugin non è accoppiato — basta aggiornare il comando.
====

== Conclusione: L'Anello Mancante

Con `hyperframes-gradle`, la mia pipeline video è completa. Ho:

* Le *slide interattive* (slider-gradle)
* Le *capsule di revisione* (capsule-gradle)
* I *video standalone* (hyperframes-gradle)

Tre formati. Un unico file sorgente: l'AsciiDoc.

Il prossimo obiettivo è HF-1: far compilare il plugin e generare un primi HTML HyperFrames a partire da un documento AsciiDoc annotato. La sessione 001 è già inquadrata.

hyperframes-gradle esiste. La governance è in atto. Il backlog è scritto. L'architettura è documentata. Il plugin è nato.

== Riferimenti

* xref:0124_architecture_plugin_gradle_racine_consommateur_independant_post.adoc[Articolo 0124 — L'Architettura Plugin Indipendente + Radice Consumatore]
* https://github.com/heygen-com/hyperframes[HyperFrames — GitHub]
* https://hyperframes.heygen.com/introduction[HyperFrames — Documentazione]
* `foundry/public/hyperframes-gradle/hyperframes-plugin/doc/HYPERFRAMES_ARCHITECTURE.adoc`— Architettura dettagliata