feat(solutions): 参考答案自己成为一个 mcpp 工程，mcpp test -p solutions 直接跑

在此之前 solutions/ 只是一堆躺在磁盘上的 .cpp：不是工作区成员，mcpp 从头到
尾不认识它。想验证答案对不对，唯一的办法是把 52 个文件覆盖到 src/*/tests/
上、跑一遍、再 git 还原 —— 一套带副作用、要求工作树干净、只有 CI 脚本会用
的流程。学习者或贡献者想确认「答案是好的」，没有一条命令可以跑。

现在 solutions/ 是一个正经工程：

    solutions/mcpp.toml            name=solutions, c++23, 依赖 d2x
    solutions/tests/<std>/...      52 份答案，就是它的测试

于是：

    mcpp test -p solutions          # 52 passed; 0 failed
    mcpp test -p solutions cpp11    # 按子串筛

零副作用、不碰练习目录、任何人随手可跑。布局与练习一一对应，测试名
(intro/hello-mcpp、cpp11/00-auto-and-decltype/0) 直接对回练习文件。
配置刻意与练习工程一致(c++23 + d2x)，否则「答案能过」推不出「答案放进
练习里也能过」。

覆盖-还原那套 e2e 保留 —— 它验的是另一件事：答案放到练习的位置上也成立，
且练习在未完成时确实不通过。两条互补：新的这条挂了说明答案本身是错的，
旧的那条挂了说明答案与练习对不上。

- e2e.sh 新增 solutions_selftest()，并核对测试条数 == 答案文件数：测试发现
  是按 tests/**/*.cpp 自动扫的，布局一改就可能一个都没扫到，而「0 个测试」
  在 mcpp 眼里同样是 "test result ok"
- CI 每档平台新增独立一段 `mcpp test -p solutions`，排在覆盖-还原之前，
  失败定位最短
- e2e.sh / checker-e2e.sh / 文件名核对 job 的路径映射跟随改为 solutions/tests/

Author: Sunrisepeak

.github/workflows/dslings-ref-ci.yml

@@ -181,7 +181,15 @@ jobs:
           fi
           echo "OK: 无 MSVC STL 时回落到 winlibs MinGW (x86_64-windows-gnu)"
 
+      # 参考答案自检 —— 单独一段,因为它是最便宜也最直白的一条:solutions/ 自己
+      # 就是一个 mcpp 工程,一条命令、零副作用,红了就说明答案本身编不过或跑不过,
+      # 跟练习目录、跟 d2x 都没关系。放在覆盖-还原那套之前,失败定位最短。
+      - name: mcpp test -p solutions (reference answers must be all green)
+        run: mcpp test -p solutions
+
       # 第一层:`mcpp test` —— pristine 全部不通过 + 覆盖答案后全部通过
+      # (e2e.sh 内部还会再跑一遍上面那条自检并核对测试条数,防止布局改动后
+      #  tests/**/*.cpp 一个都没扫到却依然 "test result ok")
       - name: mcpp test (pristine fails, solutions all pass)
         run: bash d2x/buildtools/tests/e2e.sh ${{ matrix.langs }}
 
@@ -209,8 +217,8 @@ jobs:
             rel="${f#src/}"
             std="${rel%%/*}"
             rest="${rel#*/tests/}"
-            if [ ! -f "solutions/$std/$rest" ]; then
-              echo "::warning::missing solutions/$std/$rest (paired with $f)"
+            if [ ! -f "solutions/tests/$std/$rest" ]; then
+              echo "::warning::missing solutions/tests/$std/$rest (paired with $f)"
               missing=$((missing+1))
             fi
           done

d2x/buildtools/tests/checker-e2e.sh

@@ -55,7 +55,7 @@ trap restore EXIT
 # —— 覆盖参考答案(zh/en 共用同一份 solutions)——
 n_expected=0
 while IFS= read -r sol; do
-    rel="${sol#solutions/}"          # intro/hello-mcpp.cpp | cpp11/00-x/0.cpp
+    rel="${sol#solutions/tests/}"    # intro/hello-mcpp.cpp | cpp11/00-x/0.cpp
     std="${rel%%/*}"; rest="${rel#*/}"
     dst="${PREFIX}${std}/tests/${rest}"
     if [[ ! -f "$dst" ]]; then
@@ -64,7 +64,7 @@ while IFS= read -r sol; do
     fi
     cp "$sol" "$dst"
     n_expected=$((n_expected + 1))
-done < <(find solutions -name '*.cpp' | sort)
+done < <(find solutions/tests -name '*.cpp' | sort)
 
 if [[ "$n_expected" -eq 0 ]]; then
     echo "CHECKER-E2E($LANG_SEL) FAIL: 一份参考答案都没找到"

d2x/buildtools/tests/e2e.sh

@@ -4,6 +4,9 @@
 #   1) 每个练习未完成时不通过 (pristine 全量 mcpp test 必须 0 passed)
 #   2) 每份参考答案放进去后通过 (overlay 后全量 mcpp test 必须全绿)
 #
+# 外加一条独立的答案自检:solutions/ 自己是一个 mcpp 工程,
+# `mcpp test -p solutions` 直接编译运行全部答案,零副作用(见 solutions_selftest)。
+#
 # 这是 rustlings `cargo dev check --require-solutions` 的等价物。
 #
 # 两道防线(均源自历史缺陷,背景见 .agents/docs 参考文档):
@@ -54,7 +57,7 @@ run_lang() {
     # —— 覆盖参考答案 (zh/en 共用同一份 solutions) ——
     local n_overlaid=0 sol rel std rest dst
     while IFS= read -r sol; do
-        rel="${sol#solutions/}"                      # intro/hello-mcpp.cpp | cpp11/00-x/0.cpp
+        rel="${sol#solutions/tests/}"                # intro/hello-mcpp.cpp | cpp11/00-x/0.cpp
         std="${rel%%/*}"; rest="${rel#*/}"
         dst="${prefix}${std}/tests/${rest}"
         if [[ ! -f "$dst" ]]; then
@@ -64,7 +67,7 @@ run_lang() {
         fi
         cp "$sol" "$dst"
         n_overlaid=$((n_overlaid + 1))
-    done < <(find solutions -name '*.cpp' | sort)
+    done < <(find solutions/tests -name '*.cpp' | sort)
 
     # —— 断言 2 + 防线 2: overlay 后全绿,且 passed 总数与答案数一致 ——
     local total_passed=0 ok=1
@@ -92,6 +95,39 @@ run_lang() {
     echo "E2E($label) solutions: $total_passed/$n_overlaid 参考答案全部通过 ✓"
 }
 
+# 参考答案自检:solutions/ 自己就是一个 mcpp 工程,直接编译运行,不碰练习目录。
+#
+# 这是最便宜也最直白的一条 —— 一条命令、零副作用、谁都能在本地复现:
+#   mcpp test -p solutions
+# 底下 run_lang 的覆盖-还原流程验的是另一件事(答案「放进练习的位置」也成立,
+# 且练习在未完成时确实不通过),两者互补:这条挂了说明答案本身就是错的,那条
+# 挂了说明答案与练习对不上。
+solutions_selftest() {
+    local n_files out passed
+    n_files=$(find solutions/tests -name '*.cpp' | wc -l | tr -d ' ')
+    if [[ "$n_files" -eq 0 ]]; then
+        echo "E2E(solutions) FAIL: solutions/tests 下一份答案都没有"
+        return 1
+    fi
+
+    out=$(mcpp test -p solutions 2>&1)
+    if ! echo "$out" | grep -q "test result ok"; then
+        echo "E2E(solutions) FAIL: mcpp test -p solutions 未全绿:"
+        echo "$out" | grep -E "FAIL|failures" -A10 | head -20
+        return 1
+    fi
+
+    passed=$(echo "$out" | grep -oE '[0-9]+ passed' | grep -oE '^[0-9]+' | tail -1)
+    passed="${passed:-0}"
+    # 防空转:测试发现是按 tests/**/*.cpp 自动扫的,布局一改就可能一个都没扫到,
+    # 而「0 个测试」在 mcpp 眼里同样是 "test result ok"。
+    if [[ "$passed" -ne "$n_files" ]]; then
+        echo "E2E(solutions) FAIL: solutions/tests 下有 $n_files 份答案,但只跑了 $passed 个测试"
+        return 1
+    fi
+    echo "E2E(solutions) 自检: mcpp test -p solutions —— $passed/$n_files 全部通过 ✓"
+}
+
 provider_smoke() {
     # Provider 协议冒烟:枚举数量、check 的关键事件
     local n
@@ -110,6 +146,7 @@ provider_smoke() {
 }
 
 rc=0
+solutions_selftest || rc=1
 provider_smoke || rc=1
 if [[ "$MODE" == "zh" || "$MODE" == "all" ]]; then run_lang "src/"    zh || rc=1; fi
 if [[ "$MODE" == "en" || "$MODE" == "all" ]]; then run_lang "src/en/" en || rc=1; fi

mcpp.toml

@@ -1,10 +1,15 @@
 # d2mcpp 根 workspace。练习即测试:每个 C++ 标准对应 src/ 下的一个 mcpp 工程,
 # 练习即该工程的 tests/,mcpp test 的测试报告即学习进度;d2x checker 复用同一条链路。
 # d2x/ 目录包含练习库(import d2x)与 Provider(buildtools/)。
+#
+# solutions/ 同理,是参考答案自己的工程:`mcpp test -p solutions` 直接编译运行
+# 全部答案,应当全绿。它和练习工程的关系是「同一份代码的两种状态」——
+# src/ 下是挖空的,solutions/ 下是填好的,两边配置一致才可比。
 [workspace]
 members = [
     "d2x",
     "src/intro", "src/cpp11", "src/cpp14",
     "src/en/intro", "src/en/cpp11", "src/en/cpp14",
+    "solutions",
     "d2x/buildtools",
 ]

solutions/mcpp.toml

@@ -0,0 +1,22 @@
+# 参考答案工程。每份答案就是这里的一个测试:
+#   mcpp test -p solutions                   全部参考答案(应当全绿)
+#   mcpp test -p solutions <子串>            只跑匹配的答案
+#
+# 为什么答案自己也是一个 mcpp 工程,而不只是一堆躺着的 .cpp:
+# 答案要能被验证,而验证的唯一可信方式就是真的编译并运行它。做成工程之后
+# `mcpp test -p solutions` 就是一条谁都能跑的命令 —— CI 跑它,贡献者提 PR 前
+# 也跑它,不需要先把文件覆盖到练习目录里再 git 还原那一套。
+#
+# 布局与练习一一对应,tests/ 下的相对路径就是两边的对应关系:
+#   solutions/tests/<std>/<章节>/<序号>.cpp   ←→  src[/en]/<std>/tests/<章节>/<序号>.cpp
+# 所以测试名(intro/hello-mcpp、cpp11/00-auto-and-decltype/0)一眼就能对回练习。
+#
+# 与练习工程共用同一套配置(c++23 + d2x),否则「答案能过」证明不了「答案放进
+# 练习里也能过」—— 两边的编译条件必须是同一个。
+[package]
+name     = "solutions"
+version  = "0.1.0"
+standard = "c++23"
+
+[dependencies]
+d2x = { path = "../d2x" }