fix: resolve P2 issues in unified test runner

- P2-1: Fix expand_test_cases to use BS sizes for full+bs combination
- P2-2: Add --warmup and --iters CLI arguments
- P2-3: Validate flagfft_median_ms > 0 and ref_median_ms > 0 in parse_perf_result
- P2-4: Add compute_speedup_stats with geometric mean speedup
- P2-5: Add help text for --combination argument
- P2-6: Fix progress bar over 100% by tracking completed cases
- P2-7: Add worker join after main loop
- P2-8: Add failure message to JsonTestListener JSON output
- P2-9: Add write_json_escaped helper for safe JSON string output
- P2-10: Remove unused sizes_2d_smooth and sizes_2d_bluestein keys
- P2-11: Fix stale tests/cli/ reference in docs/architecture.md
- P2-12: Delete unused tools/consts.py
- P2-13: Add unified test runner design doc to worktree

Author: Artlesbol

conf/test_matrix.yaml

@@ -25,23 +25,6 @@ sizes_bs:
   - 997
   - 1009
 
-# ── 2D 尺寸定义 ────────────────────────────────────────────────
-
-# 平滑 2D 尺寸 (CT 路径)
-sizes_2d_smooth:
-  - [16, 16]
-  - [64, 64]
-  - [128, 256]
-  - [256, 128]
-  - [256, 256]
-  - [512, 512]
-
-# Bluestein 2D 尺寸
-sizes_2d_bluestein:
-  - [23, 23]
-  - [997, 16]
-  - [16, 997]
-
 # ── 批大小 ─────────────────────────────────────────────────────
 
 batches:

ctest/flagfft_test.h

@@ -716,6 +716,30 @@ inline bool should_skip_direction(int direction_flag) {
   return g_test_params.direction != direction_flag;
 }
 
+inline void write_json_escaped(std::ostream& out, const std::string& s) {
+  for (char c : s) {
+    switch (c) {
+      case '"':
+        out << "\\\"";
+        break;
+      case '\\':
+        out << "\\\\";
+        break;
+      case '\n':
+        out << "\\n";
+        break;
+      case '\r':
+        out << "\\r";
+        break;
+      case '\t':
+        out << "\\t";
+        break;
+      default:
+        out << c;
+    }
+  }
+}
+
 class JsonTestListener : public ::testing::EmptyTestEventListener {
  public:
   explicit JsonTestListener(const char* filename) : filename_(filename ? filename : "gtest_result.json") {
@@ -745,9 +769,25 @@ class JsonTestListener : public ::testing::EmptyTestEventListener {
           if (!first_failure) out << ",\n";
           first_failure = false;
           out << "    {\n";
-          out << "      \"suite\": \"" << test->test_suite_name() << "\",\n";
-          out << "      \"name\": \"" << test->name() << "\",\n";
-          out << "      \"params\": \"" << test->value_param() << "\"\n";
+          out << "      \"suite\": \"";
+          write_json_escaped(out, test->test_suite_name());
+          out << "\",\n";
+          out << "      \"name\": \"";
+          write_json_escaped(out, test->name());
+          out << "\",\n";
+          out << "      \"params\": \"";
+          write_json_escaped(out, test->value_param());
+          out << "\",\n";
+          out << "      \"message\": \"";
+          bool first_msg = true;
+          for (int k = 0; k < test->result()->total_part_count(); ++k) {
+            if (test->result()->GetTestPartResult(k).failed()) {
+              if (!first_msg) out << "; ";
+              first_msg = false;
+              write_json_escaped(out, test->result()->GetTestPartResult(k).message());
+            }
+          }
+          out << "\"\n";
           out << "    }";
         }
       }

docs/architecture.md

@@ -102,6 +102,7 @@ database when `FLAGFFT_TUNE_DB=PATH` is set.
 
 ## Tests
 
-`tests/cli/` shells out to `flagfft-cli --json` for plan/error contracts,
-cuFFT comparisons, benchmark schema, unsupported boundaries, and tuning
-database reuse. `tests/python/` continues to cover code generation.
+`ctest/` contains Google Test based accuracy tests for all operators.
+`tools/run_tests.py` is the unified test runner that orchestrates both
+accuracy and performance testing across multiple GPUs. `tests/python/`
+continues to cover code generation.