gnd(test): Add mock-based subgraph test runner

gnd/Cargo.toml

@@ -15,12 +15,22 @@ path = "tests/cli_commands.rs"
 name = "codegen_verification"
 path = "tests/codegen_verification.rs"
 
+[[test]]
+name = "gnd_test"
+path = "tests/gnd_test.rs"
+
 [dependencies]
 # Core graph dependencies
 graph = { path = "../graph" }
 graph-chain-ethereum = { path = "../chain/ethereum" }
 graph-core = { path = "../core" }
 graph-node = { path = "../node" }
+graph-graphql = { path = "../graphql" }
+graph-store-postgres = { path = "../store/postgres" }
+
+# Test command dependencies
+hex = "0.4"
+async-trait = { workspace = true }
 
 # Direct dependencies from current dev.rs
 anyhow = { workspace = true }
@@ -49,6 +59,7 @@ thiserror = { workspace = true }
 # Console output
 indicatif = "0.18"
 console = "0.16"
+similar = "2"
 
 # Code generation
 graphql-tools = { workspace = true }
@@ -78,4 +89,3 @@ pgtemp = { git = "https://github.com/graphprotocol/pgtemp", branch = "initdb-arg
 [dev-dependencies]
 tempfile = "3"
 walkdir = "2"
-similar = "2"

gnd/README.md

@@ -301,25 +301,47 @@ Keys are stored in `~/.graph-cli.json`.
 
 ### `gnd test`
 
-Run Matchstick tests for the subgraph.
+Run subgraph tests.
 
 ```bash
-gnd test [DATASOURCE]
+gnd test [TEST_FILES...]
 ```
 
 **Arguments:**
-- `DATASOURCE`: Specific data source to test (optional)
+- `PATHS`: Test JSON files or directories to scan. Defaults to `tests/` when nothing is specified.
 
 **Flags:**
 
 | Flag | Short | Description |
 |------|-------|-------------|
-| `--coverage` | `-c` | Run with coverage reporting |
-| `--docker` | `-d` | Run in Docker container |
-| `--force` | `-f` | Force redownload of Matchstick binary |
-| `--logs` | `-l` | Show debug logs |
-| `--recompile` | `-r` | Force recompilation before testing |
-| `--version` | `-v` | Matchstick version to use |
+| `--manifest` | `-m` | Path to subgraph manifest (default: `subgraph.yaml`) |
+| `--skip-build` | `-s` | Skip building the subgraph before testing |
+| `--postgres-url` | | PostgreSQL connection URL (env: `POSTGRES_URL`) |
+| `--matchstick` | | Use legacy Matchstick runner (**deprecated** — migrate to JSON-based tests) |
+| `--docker` | `-d` | Run Matchstick in Docker (requires `--matchstick`) |
+| `--coverage` | `-c` | Run with coverage reporting (requires `--matchstick`) |
+| `--recompile` | `-r` | Force recompilation (requires `--matchstick`) |
+| `--force` | `-f` | Force redownload of Matchstick binary (requires `--matchstick`) |
+
+**Examples:**
+
+```bash
+# Run all tests in tests/ directory (default)
+gnd test
+
+# Run specific test files
+gnd test transfer.json approval.json
+gnd test tests/transfer.json
+
+# Scan a custom directory
+gnd test my-tests/
+
+# Use a different manifest
+gnd test -m subgraph.staging.yaml tests/transfer.json
+
+# Skip automatic build
+gnd test -s
+```
 
 ### `gnd clean`