Add smart tab-completion for scriptOrFile argument

.gitignore

@@ -25,3 +25,6 @@ allure-results
 .DS_Store
 .env
 assets/
+.cachebro/
+CLAUDE.md
+PLAN-*.md

build.gradle

@@ -156,8 +156,11 @@ dependencies {
 	implementation 'org.jspecify:jspecify:1.0.0'
 	implementation 'org.apache.commons:commons-text:1.15.0'
 	implementation 'org.apache.commons:commons-compress:1.27.1'
-	implementation 'info.picocli:picocli:4.7.7'
-	annotationProcessor 'info.picocli:picocli-codegen:4.7.7'
+	implementation('org.aesh:aesh:3.8-dev') {
+		exclude group: 'org.aesh', module: 'readline'
+	}
+	implementation 'org.aesh:readline-api:3.7'
+	annotationProcessor 'org.aesh:aesh-processor:3.8-dev'
 	implementation 'io.quarkus.qute:qute-core:1.13.7.Final'
 	implementation 'org.codehaus.plexus:plexus-java:1.2.0'
 	implementation 'com.google.code.gson:gson:2.13.2'
@@ -387,7 +390,9 @@ shadowJar {
 }
 
 test {
-	useJUnitPlatform()
+	useJUnitPlatform() {
+		excludeTags 'benchmark'
+	}
 	javaLauncher = testExecutionToolchain
 	def jvmArgsList = ["-javaagent:${configurations.agent.singleFile}"] // for allure reporting
 	if (testJavaVersion.asInt() >= 9) {
@@ -413,6 +418,25 @@ test {
 	systemProperty('jbang.test.wiremock.enable', project.findProperty('disableWiremock') == 'true' ? 'false' : 'true')
 }
 
+task benchmark(type: Test) {
+	description = 'Run startup benchmark tests'
+	group = 'verification'
+	useJUnitPlatform() {
+		includeTags 'benchmark'
+	}
+	javaLauncher = testExecutionToolchain
+	def jvmArgsList = []
+	if (testJavaVersion.asInt() >= 9) {
+		jvmArgsList.addAll([
+			"--add-opens", "java.base/java.lang=ALL-UNNAMED",
+			"--add-opens", "java.base/java.util=ALL-UNNAMED"
+		])
+	}
+	jvmArgs = jvmArgsList
+	testLogging.showStandardStreams = true
+	systemProperty('jbang.test.wiremock.enable', project.findProperty('disableWiremock') == 'true' ? 'false' : 'true')
+}
+
 jacoco {
 	toolVersion = '0.8.14' // 0.8.14 supports java 25
 }
@@ -606,7 +630,7 @@ asciidoctor {
 task clidoc(type: Exec) {
 	doFirst {
 		println 'Generating cli man pages'
-		commandLine 'build/install/jbang/bin/jbang', '--cp', 'build/install/jbang/bin/jbang.jar', '--deps','org.eclipse.sisu:org.eclipse.sisu.inject:0.3.5', 'docs/genadoc.java', '-d', 'docs/modules/cli', '--force', 'dev.jbang.cli.JBang'
+		commandLine 'build/install/jbang/bin/jbang', '--cp', 'build/install/jbang/bin/jbang.jar', 'docs/genadoc.java', '-d', 'docs/modules/cli', '--force', 'dev.jbang.cli.JBang'
 	}
 }
 

docs/modules/cli/nav.adoc

@@ -1,5 +1,63 @@
-* CLI Reference
-+
---
-include::partial$nav-jbang.adoc[]
---
+* xref:jbang:cli:jbang.adoc[jbang]
+** xref:jbang:cli:jbang-run.adoc[run]
+** xref:jbang:cli:jbang-build.adoc[build]
+** xref:jbang:cli:jbang-edit.adoc[edit]
+** xref:jbang:cli:jbang-init.adoc[init]
+** xref:jbang:cli:jbang-alias.adoc[alias]
+*** xref:jbang:cli:jbang-alias-add.adoc[add]
+*** xref:jbang:cli:jbang-alias-list.adoc[list]
+*** xref:jbang:cli:jbang-alias-remove.adoc[remove]
+** xref:jbang:cli:jbang-template.adoc[template]
+*** xref:jbang:cli:jbang-template-add.adoc[add]
+*** xref:jbang:cli:jbang-template-list.adoc[list]
+*** xref:jbang:cli:jbang-template-remove.adoc[remove]
+** xref:jbang:cli:jbang-catalog.adoc[catalog]
+*** xref:jbang:cli:jbang-catalog-add.adoc[add]
+*** xref:jbang:cli:jbang-catalog-update.adoc[update]
+*** xref:jbang:cli:jbang-catalog-list.adoc[list]
+*** xref:jbang:cli:jbang-catalog-remove.adoc[remove]
+** xref:jbang:cli:jbang-trust.adoc[trust]
+*** xref:jbang:cli:jbang-trust-add.adoc[add]
+*** xref:jbang:cli:jbang-trust-list.adoc[list]
+*** xref:jbang:cli:jbang-trust-remove.adoc[remove]
+** xref:jbang:cli:jbang-cache.adoc[cache]
+*** xref:jbang:cli:jbang-cache-clear.adoc[clear]
+** xref:jbang:cli:jbang-completion.adoc[completion]
+** xref:jbang:cli:jbang-jdk.adoc[jdk]
+*** xref:jbang:cli:jbang-jdk-install.adoc[install]
+*** xref:jbang:cli:jbang-jdk-list.adoc[list]
+*** xref:jbang:cli:jbang-jdk-uninstall.adoc[uninstall]
+*** xref:jbang:cli:jbang-jdk-home.adoc[home]
+*** xref:jbang:cli:jbang-jdk-java-env.adoc[java-env]
+*** xref:jbang:cli:jbang-jdk-exec.adoc[exec]
+*** xref:jbang:cli:jbang-jdk-default.adoc[default]
+** xref:jbang:cli:jbang-version.adoc[version]
+** xref:jbang:cli:jbang-wrapper.adoc[wrapper]
+*** xref:jbang:cli:jbang-wrapper-install.adoc[install]
+** xref:jbang:cli:jbang-info.adoc[info]
+*** xref:jbang:cli:jbang-info-tools.adoc[tools]
+*** xref:jbang:cli:jbang-info-classpath.adoc[classpath]
+*** xref:jbang:cli:jbang-info-jar.adoc[jar]
+*** xref:jbang:cli:jbang-info-docs.adoc[docs]
+** xref:jbang:cli:jbang-app.adoc[app]
+*** xref:jbang:cli:jbang-app-install.adoc[install]
+*** xref:jbang:cli:jbang-app-list.adoc[list]
+*** xref:jbang:cli:jbang-app-uninstall.adoc[uninstall]
+*** xref:jbang:cli:jbang-app-setup.adoc[setup]
+** xref:jbang:cli:jbang-export.adoc[export]
+*** xref:jbang:cli:jbang-export-portable.adoc[portable]
+*** xref:jbang:cli:jbang-export-local.adoc[local]
+*** xref:jbang:cli:jbang-export-mavenrepo.adoc[mavenrepo]
+*** xref:jbang:cli:jbang-export-native.adoc[native]
+*** xref:jbang:cli:jbang-export-fatjar.adoc[fatjar]
+*** xref:jbang:cli:jbang-export-jlink.adoc[jlink]
+*** xref:jbang:cli:jbang-export-gradle.adoc[gradle]
+*** xref:jbang:cli:jbang-export-maven.adoc[maven]
+** xref:jbang:cli:jbang-config.adoc[config]
+*** xref:jbang:cli:jbang-config-get.adoc[get]
+*** xref:jbang:cli:jbang-config-set.adoc[set]
+*** xref:jbang:cli:jbang-config-unset.adoc[unset]
+*** xref:jbang:cli:jbang-config-list.adoc[list]
+** xref:jbang:cli:jbang-deps.adoc[deps]
+*** xref:jbang:cli:jbang-deps-search.adoc[search]
+*** xref:jbang:cli:jbang-deps-add.adoc[add]