feat: export structured metadata based on CommandSpec

Author: JaimeSeqLabs

build.gradle

@@ -110,6 +110,15 @@ task runReflectionConfigGenerator(type: JavaExec) {
     jvmArgs = ["-agentlib:native-image-agent=access-filter-file=conf/access-filter-file.json,config-merge-dir=conf/"]
 }
 
+task extractCliMetadata(type: JavaExec) {
+    group = 'documentation'
+    description = 'Extract CLI metadata using Java reflection (deterministic, includes resolved mixins)'
+    classpath = sourceSets.main.runtimeClasspath
+    mainClass = 'io.seqera.tower.cli.utils.metadata.CliMetadataExtractor'
+    args = [file('docs/cli-metadata.json').absolutePath]
+    dependsOn classes
+}
+
 shadowJar {
     archiveBaseName.set('tw')
     archiveClassifier.set('')