HyperFrames-Gradle: Converti l'AsciiDoc in video MP4

Failed to generate image: PlantUML preprocessing failed: [From <input> (line 9) ]

@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultFontSize 11

title condotta hyperframes-gradle
rectangle "AsciiDoc\nsorgente" as adoc #LightYellow
rectangle "AsciidoctorJ" as asciidoctorj #LightBlue
rectangle "HTML HyperFrames
(data-* attributi)" as html #LightGreen
^^^^^
 Syntax Error? (Assumed diagram type: activity)

@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultFontSize 11

title condotta hyperframes-gradle
rectangle "AsciiDoc\nsorgente" as adoc #LightYellow
rectangle "AsciidoctorJ" as asciidoctorj #LightBlue
rectangle "HTML HyperFrames
(data-* attributi)" as html #LightGreen
rectangle "HyperFrames CLI
(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:

```kotlin
----
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
|===

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*". Il mio pipeline si basa su agenti IA

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

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

slider-gradle, codex-gradle, training-gradle — tutti consumano del`.adoc`. Aggiungere blocchi personalizzati`[hyperframes-composition]`è un'estensione logico, non una rottura.

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

Questo è quello che faccio già per PlantUML, Graphviz, Piper. Aggiungi HyperFrames non cambia nulla all'architettura — è uno strumento esterno in più, pilotato da Gradle

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

== Conclusion: L'anello mancante

Con hyperframes-gradle, il mio pipeline video è completo. Ho:

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

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

L'obiettivo successivo è HF-1 : fare compilare il plugin e generare un primo 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

* ### Integrazione Gradle
JBake può essere integrato nelle build Gradle utilizzando il plugin Gradle JBake o chiamando direttamente la CLI JBake:

----

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

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