refactor: move root scripts to scripts directory

- Move new_problem, run_case, and run_tests scripts to scripts/
- Update script paths to reference parent directory
- Update all documentation references to new script paths
- Add script documentation to scripts/README.md

Author: lufftw

README.md

@@ -209,7 +209,7 @@ source leetcode/bin/activate
 pip install -r requirements.txt
 
 # Make scripts executable
-chmod +x run_tests.sh run_case.sh new_problem.sh
+chmod +x scripts/run_tests.sh scripts/run_case.sh scripts/new_problem.sh
 ```
 
 </details>
@@ -218,10 +218,10 @@ chmod +x run_tests.sh run_case.sh new_problem.sh
 
 ```bash
 # Windows
-new_problem.bat 0001_two_sum
+scripts\new_problem.bat 0001_two_sum
 
 # Linux/macOS
-./new_problem.sh 0001_two_sum
+./scripts/new_problem.sh 0001_two_sum
 ```
 
 This creates:
@@ -233,10 +233,10 @@ This creates:
 
 ```bash
 # Windows
-run_tests.bat 0001_two_sum
+scripts\run_tests.bat 0001_two_sum
 
 # Linux/macOS
-./run_tests.sh 0001_two_sum
+./scripts/run_tests.sh 0001_two_sum
 ```
 
 ### 4. Debug in VS Code
@@ -652,7 +652,7 @@ greedy                  44.82ms   O(kN)           3/3
 ============================================================
 ```
 
-Create with template: `new_problem.bat 0023_merge_k_lists --multi`
+Create with template: `scripts\new_problem.bat 0023_merge_k_lists --multi`
 
 > 📖 See [`docs/SOLUTION_CONTRACT.md` §B](docs/SOLUTION_CONTRACT.md#b-solutions-metadata-schema) for complete SOLUTIONS schema and validation rules.
 
@@ -868,7 +868,7 @@ neetcode/
 ├── .dev/                      # 🧪 Maintainer zone (unit tests)
 │   ├── tests/                 # Unit test suite (150+ cases)
 │   ├── tests_solutions/       # Solution validation tests
-│   ├── run_tests.bat/.sh      # Run runner unit tests
+│   ├── scripts/run_tests.bat/.sh  # Run runner unit tests
 │   ├── run_all_tests.bat/.sh  # Run all unit tests
 │   ├── run_tests_solutions.bat/.sh  # Run solution tests
 │   ├── TESTING.md             # Testing documentation
@@ -881,9 +881,11 @@ neetcode/
 │
 ├── leetcode/                  # 🐍 Python virtual environment (3.11)
 │
-├── run_tests.bat / .sh        # Run all tests for a problem
-├── run_case.bat / .sh         # Run single test case
-├── new_problem.bat / .sh      # Create new problem from template
+├── scripts/                   # 🔧 Utility scripts
+│   ├── new_problem.bat / .sh  # Create new problem from template
+│   ├── run_tests.bat / .sh    # Run all tests for a problem
+│   ├── run_case.bat / .sh     # Run single test case
+│   └── build_docs.bat / .sh   # Build documentation site
 │
 ├── requirements.txt           # Python dependencies
 ├── mkdocs.yml                 # MkDocs configuration

README_zh-TW.md

@@ -209,7 +209,7 @@ source leetcode/bin/activate
 pip install -r requirements.txt
 
 # 設定腳本執行權限
-chmod +x run_tests.sh run_case.sh new_problem.sh
+chmod +x scripts/run_tests.sh scripts/run_case.sh scripts/new_problem.sh
 ```
 
 </details>
@@ -218,10 +218,10 @@ chmod +x run_tests.sh run_case.sh new_problem.sh
 
 ```bash
 # Windows
-new_problem.bat 0001_two_sum
+scripts\new_problem.bat 0001_two_sum
 
 # Linux/macOS
-./new_problem.sh 0001_two_sum
+./scripts/new_problem.sh 0001_two_sum
 ```
 
 這會自動建立：
@@ -233,10 +233,10 @@ new_problem.bat 0001_two_sum
 
 ```bash
 # Windows
-run_tests.bat 0001_two_sum
+scripts\run_tests.bat 0001_two_sum
 
 # Linux/macOS
-./run_tests.sh 0001_two_sum
+./scripts/run_tests.sh 0001_two_sum
 ```
 
 ### 4. 在 VS Code 中除錯
@@ -604,7 +604,7 @@ greedy                  44.82ms   O(kN)           3/3
 ============================================================
 ```
 
-使用模板建立：`new_problem.bat 0023_merge_k_lists --multi`
+使用模板建立：`scripts\new_problem.bat 0023_merge_k_lists --multi`
 
 > 📖 完整 SOLUTIONS schema 和驗證規則請參見 [`docs/SOLUTION_CONTRACT.md` §B](docs/SOLUTION_CONTRACT.md#b-solutions-metadata-schema)。
 
@@ -820,7 +820,7 @@ neetcode/
 ├── .dev/                      # 🧪 維護者專區（單元測試）
 │   ├── tests/                 # 單元測試套件（150+ 案例）
 │   ├── tests_solutions/       # 解答驗證測試
-│   ├── run_tests.bat/.sh      # 執行 runner 單元測試
+│   ├── scripts/run_tests.bat/.sh  # 執行 runner 單元測試
 │   ├── run_all_tests.bat/.sh  # 執行所有單元測試
 │   ├── run_tests_solutions.bat/.sh  # 執行解答測試
 │   ├── TESTING.md             # 測試文件
@@ -833,9 +833,11 @@ neetcode/
 │
 ├── leetcode/                  # 🐍 Python 虛擬環境（3.11）
 │
-├── run_tests.bat / .sh        # 執行某題目的所有測試
-├── run_case.bat / .sh         # 執行單一測資
-├── new_problem.bat / .sh      # 從模板建立新題目
+├── scripts/                   # 🔧 工具腳本
+│   ├── new_problem.bat / .sh  # 從模板建立新題目
+│   ├── run_tests.bat / .sh    # 執行某題目的所有測試
+│   ├── run_case.bat / .sh     # 執行單一測資
+│   └── build_docs.bat / .sh   # 建置文件網站
 │
 ├── requirements.txt           # Python 相依套件
 ├── mkdocs.yml                 # MkDocs 配置

docs/ACT_LOCAL_GITHUB_ACTIONS.md

@@ -12,7 +12,7 @@ This guide shows you how to use `act` to run GitHub Actions workflows locally wi
 > 
 > **Core LeetCode practice functionality does NOT require this:**
 > - ✅ Solving problems (`solutions/`, `generators/`)
-> - ✅ Running tests (`run_tests.bat/sh`, `run_case.bat/sh`)
+> - ✅ Running tests (`scripts/run_tests.bat/sh`, `scripts/run_case.bat/sh`)
 > - ✅ Using the runner framework (`runner/`)
 > - ✅ All core practice features work without any CI/CD setup
 > 

docs/ARCHITECTURE_MIGRATION.md

@@ -424,7 +424,7 @@ SOLUTIONS = {
   - Updated `template_solution.py` to use `SOLUTIONS` + `get_solver()`
   - Updated `template_solution_multi.py` to use polymorphic pattern
   - Deleted deprecated `template_solution_wrapper.py`
-  - Updated `new_problem.bat` and `new_problem.sh` (removed `--wrapper` option)
-  - Updated `run_tests.bat` to pass all arguments
+  - Updated `scripts/new_problem.bat` and `scripts/new_problem.sh` (removed `--wrapper` option)
+  - Updated `scripts/run_tests.bat` to pass all arguments
   - Created `docs/SOLUTION_CONTRACT.md` as canonical specification
 

docs/BUILD_DOCS_MANUAL.md

@@ -12,7 +12,7 @@ This guide shows you how to build documentation locally using simple batch/shell
 > 
 > **Core LeetCode practice functionality does NOT require this:**
 > - ✅ Solving problems (`solutions/`, `generators/`)
-> - ✅ Running tests (`run_tests.bat/sh`, `run_case.bat/sh`)
+> - ✅ Running tests (`scripts/run_tests.bat/sh`, `scripts/run_case.bat/sh`)
 > - ✅ Using the runner framework (`runner/`)
 > - ✅ All core practice features work without any documentation build setup
 > 

scripts/README.md

@@ -8,6 +8,20 @@ This directory contains utility scripts for project maintenance and development.
 
 ## 📋 Available Scripts
 
+### Problem Management Scripts
+
+| Script | Purpose | Usage |
+|:-------|:--------|:------|
+| `new_problem.bat` / `new_problem.sh` | Create new problem from template | `scripts\new_problem.bat 0001_two_sum` (Windows)<br>`./scripts/new_problem.sh 0001_two_sum` (Linux/macOS) |
+| `run_tests.bat` / `run_tests.sh` | Run all tests for a problem | `scripts\run_tests.bat 0001_two_sum` (Windows)<br>`./scripts/run_tests.sh 0001_two_sum` (Linux/macOS) |
+| `run_case.bat` / `run_case.sh` | Run single test case | `scripts\run_case.bat 0001_two_sum 1` (Windows)<br>`./scripts/run_case.sh 0001_two_sum 1` (Linux/macOS) |
+
+**Features:**
+- ✅ Create problems from templates (single or multi-solution)
+- ✅ Run all test cases or individual cases
+- ✅ Support for benchmarking and multiple solutions
+- ✅ Cross-platform (Windows/Linux/macOS)
+
 ### Documentation Build Scripts
 
 | Script | Purpose | Usage |
@@ -26,6 +40,36 @@ This directory contains utility scripts for project maintenance and development.
 
 ## 🎯 Usage
 
+### Create New Problem
+
+```bash
+# Windows
+scripts\new_problem.bat 0001_two_sum
+scripts\new_problem.bat 0023_merge_k_lists --multi
+
+# Linux/macOS
+./scripts/new_problem.sh 0001_two_sum
+./scripts/new_problem.sh 0023_merge_k_lists --multi
+```
+
+### Run Tests
+
+```bash
+# Windows - Run all tests
+scripts\run_tests.bat 0001_two_sum
+scripts\run_tests.bat 0001_two_sum --all --benchmark
+
+# Windows - Run single test case
+scripts\run_case.bat 0001_two_sum 1
+
+# Linux/macOS - Run all tests
+./scripts/run_tests.sh 0001_two_sum
+./scripts/run_tests.sh 0001_two_sum --all --benchmark
+
+# Linux/macOS - Run single test case
+./scripts/run_case.sh 0001_two_sum 1
+```
+
 ### Build Documentation
 
 ```bash

new_problem.bat scripts/new_problem.batnew_problem.bat renamed to scripts/new_problem.bat

@@ -21,7 +21,7 @@ if "%~1"=="" (
 )
 
 set PROBLEM=%~1
-set BASE_DIR=%~dp0
+set BASE_DIR=%~dp0..\
 set TEMPLATE=template_solution.py
 set TEMPLATE_TYPE=single
 

new_problem.sh scripts/new_problem.shnew_problem.sh renamed to scripts/new_problem.sh

@@ -20,7 +20,7 @@ if [ -z "$1" ]; then
 fi
 
 PROBLEM="$1"
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
 TEMPLATE="template_solution.py"
 TEMPLATE_TYPE="single"
 

run_case.bat scripts/run_case.batrun_case.bat renamed to scripts/run_case.bat

@@ -18,4 +18,4 @@ if "%~2"=="" (
 )
 
 REM Use virtual environment Python
-"%~dp0leetcode\Scripts\python.exe" runner/case_runner.py %1 %2
+"%~dp0..\leetcode\Scripts\python.exe" "%~dp0..\runner\case_runner.py" %1 %2

run_case.sh scripts/run_case.shrun_case.sh renamed to scripts/run_case.sh

@@ -16,8 +16,8 @@ if [ -z "$2" ]; then
     exit 1
 fi
 
-# Get the directory where the script is located
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# Get the directory where the script is located (parent directory)
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
 
 # Use virtual environment Python
 "${SCRIPT_DIR}/leetcode/bin/python" "${SCRIPT_DIR}/runner/case_runner.py" "$1" "$2"