chore: import upstream snapshot with attribution

website/docs/reference/tools/testing/_category_.json

@@ -0,0 +1,8 @@
+{
+  "label": "testing",
+  "link": {
+    "type": "doc",
+    "id": "reference/tools/testing/index"
+  },
+  "collapsed": true
+}

website/docs/reference/tools/testing/get_test_job.md

@@ -0,0 +1,35 @@
+---
+title: get_test_job
+sidebar_label: get_test_job
+description: "Polls an async Unity test job by job_id."
+---
+
+# `get_test_job`
+
+> **Auto-generated** from the Python tool registry. Do not hand-edit outside `<!-- examples:start --><!-- examples:end -->` blocks — the generator (`tools/generate_docs_reference.py`) will overwrite them.
+
+**Group:** `testing` &nbsp;·&nbsp; **Module:** `services.tools.run_tests`
+
+## Description
+
+Polls an async Unity test job by job_id.
+
+## Parameters
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `job_id` | `str` | yes | Job id returned by run_tests |
+| `include_failed_tests` | `bool` | — | Include details for failed/skipped tests only (default: false) |
+| `include_details` | `bool` | — | Include details for all tests (default: false) |
+| `wait_timeout` | `int \| None` | — | If set, wait up to this many seconds for tests to complete before returning. Reduces polling frequency and avoids client-side loop detection. Recommended: 30-60 seconds. Returns immediately if tests complete sooner. |
+
+## Returns
+
+A `dict` containing the Unity response. The exact shape depends on the action.
+
+## Examples
+
+<!-- examples:start -->
+*No examples yet. Add usage examples here — they will be preserved across regenerations.*
+<!-- examples:end -->
+

website/docs/reference/tools/testing/index.md

@@ -0,0 +1,12 @@
+---
+title: "testing tools"
+sidebar_label: "testing"
+description: "MCP for Unity tools in the testing group."
+---
+
+# `testing` tools
+
+Test runner & async test jobs
+
+- **[`get_test_job`](./get_test_job.md)** — Polls an async Unity test job by job_id.
+- **[`run_tests`](./run_tests.md)** — Starts a Unity test run asynchronously and returns a job_id immediately.

website/docs/reference/tools/testing/run_tests.md

@@ -0,0 +1,39 @@
+---
+title: run_tests
+sidebar_label: run_tests
+description: "Starts a Unity test run asynchronously and returns a job_id immediately."
+---
+
+# `run_tests`
+
+> **Auto-generated** from the Python tool registry. Do not hand-edit outside `<!-- examples:start --><!-- examples:end -->` blocks — the generator (`tools/generate_docs_reference.py`) will overwrite them.
+
+**Group:** `testing` &nbsp;·&nbsp; **Module:** `services.tools.run_tests`
+
+## Description
+
+Starts a Unity test run asynchronously and returns a job_id immediately. Poll with get_test_job for progress.
+
+## Parameters
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `mode` | `Literal['EditMode', 'PlayMode']` | — | Unity test mode to run |
+| `test_names` | `list[str] \| str \| None` | — | Full names of specific tests to run |
+| `group_names` | `list[str] \| str \| None` | — | Same as test_names, except it allows for Regex |
+| `category_names` | `list[str] \| str \| None` | — | NUnit category names to filter by |
+| `assembly_names` | `list[str] \| str \| None` | — | Assembly names to filter tests by |
+| `include_failed_tests` | `bool` | — | Include details for failed/skipped tests only (default: false) |
+| `include_details` | `bool` | — | Include details for all tests (default: false) |
+| `init_timeout` | `int \| None` | — | Initialization timeout in milliseconds. PlayMode tests may need longer due to domain reload (default: 15000). Recommended: 120000 for PlayMode. |
+
+## Returns
+
+A `dict` containing the Unity response. The exact shape depends on the action.
+
+## Examples
+
+<!-- examples:start -->
+*No examples yet. Add usage examples here — they will be preserved across regenerations.*
+<!-- examples:end -->
+