add multi-command chaining with __ separator

- support running multiple commands in sequence (e.g., cli lint __ build __ test)
- stop execution on first failure and propagate exit code
- add tests for multi-command execution, argument passing, and failure handling

Author: igl

cli.sh

@@ -1,7 +1,42 @@
 # SPDX-License-Identifier: MIT
 # Licensed under the MIT License. See LICENSE file in the project root.
 
+# Separator for chaining multiple commands (e.g., cli lint __ build __ test)
+CLI_COMMAND_SEPARATOR="__"
+
 function cli {
+	# Check for multi-command separator
+	local has_separator=false
+	for arg in "$@"; do
+		if [ "$arg" = "$CLI_COMMAND_SEPARATOR" ]; then
+			has_separator=true
+			break
+		fi
+	done
+
+	if [ "$has_separator" = true ]; then
+		local cmd_args=()
+		for arg in "$@"; do
+			if [ "$arg" = "$CLI_COMMAND_SEPARATOR" ]; then
+				if [ ${#cmd_args[@]} -gt 0 ]; then
+					_cli_single "${cmd_args[@]}" || return $?
+					cmd_args=()
+				fi
+			else
+				cmd_args+=("$arg")
+			fi
+		done
+		# Execute final command group
+		if [ ${#cmd_args[@]} -gt 0 ]; then
+			_cli_single "${cmd_args[@]}" || return $?
+		fi
+		return 0
+	fi
+
+	_cli_single "$@"
+}
+
+function _cli_single {
 	local cmd="$1"
 
 	# Collect scripts, Deno tasks, NPM tasks and Makefile tasks

tests/cli.bats

@@ -185,3 +185,58 @@ EOF
     [ "$status" -eq 0 ]
     [[ "$output" == *"scripts wins"* ]]
 }
+
+# =============================================================================
+# Multi-command execution tests
+# =============================================================================
+
+@test "executes multiple commands separated by __" {
+    mkdir -p "$BATS_TEST_DIRNAME/tmp/multi-cmd/scripts"
+    echo '#!/bin/bash
+echo "lint: $*"' > "$BATS_TEST_DIRNAME/tmp/multi-cmd/scripts/lint.sh"
+    echo '#!/bin/bash
+echo "build: $*"' > "$BATS_TEST_DIRNAME/tmp/multi-cmd/scripts/build.sh"
+    chmod +x "$BATS_TEST_DIRNAME/tmp/multi-cmd/scripts"/*.sh
+
+    cd "$BATS_TEST_DIRNAME/tmp/multi-cmd"
+    run cli lint __ build
+    [ "$status" -eq 0 ]
+    [[ "$output" == *"lint:"* ]]
+    [[ "$output" == *"build:"* ]]
+}
+
+@test "multi-command passes arguments to each command" {
+    mkdir -p "$BATS_TEST_DIRNAME/tmp/multi-args/scripts"
+    echo '#!/bin/bash
+echo "lint: $*"' > "$BATS_TEST_DIRNAME/tmp/multi-args/scripts/lint.sh"
+    echo '#!/bin/bash
+echo "build: $*"' > "$BATS_TEST_DIRNAME/tmp/multi-args/scripts/build.sh"
+    echo '#!/bin/bash
+echo "test: $*"' > "$BATS_TEST_DIRNAME/tmp/multi-args/scripts/test.sh"
+    chmod +x "$BATS_TEST_DIRNAME/tmp/multi-args/scripts"/*.sh
+
+    cd "$BATS_TEST_DIRNAME/tmp/multi-args"
+    run cli lint --fix __ build -o dist __ test --watch
+    [ "$status" -eq 0 ]
+    [[ "$output" == *"lint: --fix"* ]]
+    [[ "$output" == *"build: -o dist"* ]]
+    [[ "$output" == *"test: --watch"* ]]
+}
+
+@test "multi-command stops on first failure" {
+    mkdir -p "$BATS_TEST_DIRNAME/tmp/multi-fail/scripts"
+    echo '#!/bin/bash
+echo "first ok"' > "$BATS_TEST_DIRNAME/tmp/multi-fail/scripts/first.sh"
+    echo '#!/bin/bash
+echo "second fails" && exit 1' > "$BATS_TEST_DIRNAME/tmp/multi-fail/scripts/second.sh"
+    echo '#!/bin/bash
+echo "third should not run"' > "$BATS_TEST_DIRNAME/tmp/multi-fail/scripts/third.sh"
+    chmod +x "$BATS_TEST_DIRNAME/tmp/multi-fail/scripts"/*.sh
+
+    cd "$BATS_TEST_DIRNAME/tmp/multi-fail"
+    run cli first __ second __ third
+    [ "$status" -eq 1 ]
+    [[ "$output" == *"first ok"* ]]
+    [[ "$output" == *"second fails"* ]]
+    [[ "$output" != *"third should not run"* ]]
+}