fix(test): 测试替身 /bin/echo 改为可移植 echo-args.sh——GNU coreutils echo（Linux）把 --version 当旗标解析导致 CI 断言失败

Author: loong10k

src/test/java/io/github/easy4j/codex/CodexClientTest.java

@@ -25,6 +25,7 @@
 import io.github.easy4j.codex.model.CodexSession;
 import org.junit.jupiter.api.Test;
 
+import java.nio.file.Path;
 import java.util.List;
 
 import static org.junit.jupiter.api.Assertions.assertEquals;
@@ -36,19 +37,25 @@
 /**
  * Unit tests for {@link CodexClient}.
  *
- * <p>Uses {@code /bin/echo} as the CLI executable so that argument
- * assembly and JSON parsing can be verified without depending on the
- * real {@code codex} binary.</p>
+ * <p>Uses the {@code echo-args.sh} test fixture as the CLI executable so that
+ * argument assembly and JSON parsing can be verified without depending on the
+ * real {@code codex} binary. {@code /bin/echo} cannot be used because GNU
+ * coreutils echo (Linux) interprets {@code --version} as a flag while BSD echo
+ * (macOS) prints it literally.</p>
  *
  * @since 3.0.0
  */
 class CodexClientTest {
 
     private static final ObjectMapper MAPPER = new JsonMapper();
 
+    /** Absolute path of the argument-echoing fixture script (surefire runs from the module base dir). */
+    private static final String ECHO_ARGS_SCRIPT =
+            Path.of("src", "test", "resources", "echo-args.sh").toAbsolutePath().toString();
+
     private static CodexClientConfig echoConfig() {
         CodexClientConfig config = new CodexClientConfig();
-        config.setLocalExecutable("/bin/echo");
+        config.setLocalExecutable(ECHO_ARGS_SCRIPT);
         config.setLocalTimeoutSeconds(2);
         return config;
     }

src/test/java/io/github/easy4j/codex/cli/CodexCliTest.java

@@ -18,6 +18,8 @@
 import io.github.easy4j.codex.CodexClientConfig;
 import org.junit.jupiter.api.Test;
 
+import java.nio.file.Path;
+
 import static org.junit.jupiter.api.Assertions.assertArrayEquals;
 import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertNotNull;
@@ -27,17 +29,23 @@
  * Unit tests for {@link CodexCli} and its inner option builders
  * ({@link CodexCli.ExecOptions} and {@link CodexCli.GlobalOptions}).
  *
- * <p>Uses {@code /bin/echo} as the CLI executable so that argument
- * assembly can be verified without depending on the real {@code codex}
- * binary.</p>
+ * <p>Uses the {@code echo-args.sh} test fixture as the CLI executable so that
+ * argument assembly can be verified without depending on the real {@code codex}
+ * binary. {@code /bin/echo} cannot be used because GNU coreutils echo (Linux)
+ * interprets {@code --version} as a flag while BSD echo (macOS) prints it
+ * literally.</p>
  *
  * @since 3.0.0
  */
 class CodexCliTest {
 
+    /** Absolute path of the argument-echoing fixture script (surefire runs from the module base dir). */
+    private static final String ECHO_ARGS_SCRIPT =
+            Path.of("src", "test", "resources", "echo-args.sh").toAbsolutePath().toString();
+
     private static CodexCli echoCli() {
         CodexClientConfig config = new CodexClientConfig();
-        config.setLocalExecutable("/bin/echo");
+        config.setLocalExecutable(ECHO_ARGS_SCRIPT);
         config.setLocalTimeoutSeconds(2);
         return new CodexCli(new CodexCliExecutor(config));
     }

src/test/resources/echo-args.sh

@@ -0,0 +1,9 @@
+#!/bin/sh
+#
+# Test double for the `codex` CLI: prints every argument verbatim, joined by
+# single spaces on one line, and exits with 0 — the same output contract as
+# `/bin/echo` but portable. /bin/echo cannot be used directly because GNU
+# coreutils echo (Linux) interprets --version/--help as flags while BSD echo
+# (macOS) prints them literally.
+#
+printf '%s\n' "$*"