[0011] Auto-route tests directories to test command

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

Author: da-liii

devel/0011.md

@@ -0,0 +1,46 @@
+# [0011] gf CLI 自动路由 tests 目录到 test 命令
+
+## 任务相关的代码文件
+- `src/goldfish.hpp`
+- `tests/goldfish/liii/goldtest-test.scm`
+
+## 如何测试
+```bash
+# 1. 构建
+xmake b goldfish
+
+# 2. 运行测试
+bin/gf tests/goldfish/liii/goldtest-test.scm
+
+# 3. Adhoc 测试
+bin/gf tests/scheme
+# 预期行为：等价于 bin/gf test tests/scheme
+```
+
+## 2026-05-07 gf CLI 自动路由 tests 目录到 test 命令
+### What
+当 `bin/gf` 检测到输入是一个目录，且该目录路径的第一级文件夹是 `tests` 时，会运行如下命令：
+
+```
+bin/gf test <输入目录>
+```
+
+例如 `bin/gf tests/scheme` 会自动路由为 `bin/gf test tests/scheme`。
+
+具体修改：
+1. 在 `src/goldfish.hpp` 的 `repl_for_community_edition` 函数中，在命令路由逻辑前添加自动检测逻辑
+2. 检测条件：
+   - `command` 不是内置命令（help, version, eval, load, repl, run, test 等）
+   - `command` 对应的路径是一个存在的目录
+   - 目录路径的第一级文件夹是 `tests`（例如 `tests/scheme`, `tests/goldfish/liii/string`）
+3. 满足条件时，将 `command` 设为 `"test"`，并在 `command_args` 的对应位置插入 `"test"`，使 Scheme 侧看到的参数列表等价于 `gf test tests/...`
+
+### Why
+提升 CLI 的易用性。用户习惯性地直接输入 `bin/gf tests/scheme` 来运行测试，而不需要显式输入 `test` 子命令。这符合直觉，因为 `tests` 目录下的内容天然与测试相关。
+
+### How
+在 C++ 侧实现路由逻辑：
+- 使用 `std::filesystem::is_directory` 判断路径是否为目录
+- 使用字符串分割判断路径第一级是否为 `tests`
+- 通过修改 `command_args` vector，在原有路径参数前插入 `"test"`，确保 Scheme 侧的 `(command-line)` 返回正确的参数列表
+- 保持与现有 `command == "-e"` 时修改 `command_args` 的模式一致

src/goldfish.hpp

@@ -5271,6 +5271,30 @@ repl_for_community_edition (s7_scheme* sc, int argc, char** argv) {
     }
   }
 
+  // 自动路由：如果参数是目录且第一级文件夹是 tests，自动视为 test 命令
+  if (!command.empty () && command != "help" && command != "version" &&
+      command != "eval" && command != "load" && command != "repl" &&
+      command != "run" && command != "test" && command != "-e") {
+    std::error_code ec;
+    if (fs::is_directory (command, ec)) {
+      fs::path p (command);
+      auto     it= p.begin ();
+      if (it != p.end () && *it == "tests") {
+        if (command_index >= 0 && command_index <= static_cast<int> (command_args.size ())) {
+          command_args.insert (command_args.begin () + command_index, "test");
+        }
+        command= "test";
+        std::cerr << "[gf] Auto-routing: detected tests directory, routing to test command" << "\n";
+        std::cerr << "[gf] Executing: ";
+        for (size_t i= 0; i < command_args.size (); ++i) {
+          if (i > 0) std::cerr << " ";
+          std::cerr << command_args[i];
+        }
+        std::cerr << std::endl;
+      }
+    }
+  }
+
   // 根据命令类型确定默认模式：
   // - repl/load 命令默认使用 liii 模式
   // - 其他命令（eval, run, 直接执行脚本）默认使用 r7rs 模式