Bring the quarantine guide and MCP reference up to date (#21)

Updates the quarantine guide and MCP reference to match the product:
quarantined tests run without retries, and active rules can be edited
(dashboard, `quarantine update`, `update_quarantine_rule`).

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

Author: jakst

src/content/docs/guides/quarantine-tests.mdx

@@ -33,8 +33,8 @@ Run your suite in Endform first so you can select it in the dashboard.
    - **Playwright project:** Match a project such as `chromium`.
    - **Branch:** Match a branch such as `main`.
 4. Select **Preview matches** to check the scope.
-5. Under **Reason & expiry**, optionally add context for your team and an expiry
-   date. The expiry input uses your local time.
+5. Optionally add **Context** for your team and an **Expiry** date. The expiry
+   input uses your local time.
 6. Select **Create rule**. The rule applies to matching tests in new suite runs.
 
 All filled-in fields must match exactly. Empty fields match any value within the
@@ -62,15 +62,20 @@ npx endform@latest quarantine create \
 ```
 
 Creation requires `--suite-id` and at least one of `--test-id`, `--project`, or
-`--branch`. List active rules, include inactive rules, or deactivate a rule by
-its exact ID:
+`--branch`. List active rules, include inactive rules, update an active rule, or
+deactivate a rule by its exact ID:
 
 ```bash
 npx endform@latest quarantine list
 npx endform@latest quarantine list --all
+npx endform@latest quarantine update rule_789 --test-id test_456 --ends-at 2026-12-01T12:00:00Z
 npx endform@latest quarantine deactivate rule_789
 ```
 
+`quarantine update` replaces all of a rule's settings. Omitted `--test-id`,
+`--project`, or `--branch` options match any value, and an omitted `--reason`
+or `--ends-at` is cleared. The suite cannot change.
+
 An AI coding agent can follow the same sample-driven workflow through the
 [Modify quarantine rules with AI](/docs/guides/modify-quarantine-rules-with-ai)
 guide.
@@ -110,9 +115,8 @@ branches in the selected suite.
 The selected test is matched by its ID. Renaming or moving it, or changing its
 describe blocks, creates a different test ID that this rule will not match.
 
-On a new run, the test still executes with its configured retries. If it fails
-after exhausting retries, the suite can still pass when the other tests pass
-and there are no blocking errors.
+On a new run, the test runs once, without retries. If it fails, the suite can
+still pass when the other tests pass and there are no blocking errors.
 
 <figure>
   <Image
@@ -174,8 +178,8 @@ Endform's stored outcomes. If you use HTML, JUnit, or custom reporters, read
 ## Rule timing and overlapping rules
 
 Endform determines which rule applies when a suite run starts. Creating,
-expiring, or deactivating a rule does not change an ongoing run or rewrite
-historical results.
+editing, expiring, or deactivating a rule does not change an ongoing run or
+rewrite historical results.
 
 When several active rules match a test, the oldest matching rule applies. After
 it expires or is deactivated, the next matching active rule can apply to future
@@ -194,6 +198,8 @@ Check for other matching active rules: deactivating one rule does not remove
 quarantine if another still matches. Start a new suite run to verify the test is
 no longer quarantined.
 
-To change a rule's conditions, reason, or expiry, deactivate it and create a
-replacement. Historical runs keep their association with the rule that
-originally applied.
+To change an active rule's conditions, context, or expiry, choose **Edit rule**
+from its actions menu, or run `quarantine update`. The rule keeps its ID and its
+priority among overlapping rules, and the changes apply to new runs. Expired and
+deactivated rules cannot be edited, so create a new rule instead. Historical
+runs keep their association with the rule that originally applied.

src/content/docs/reference/mcp-server.mdx

@@ -156,7 +156,7 @@ Returns raw OpenTelemetry trace data for a test attempt. The trace can show Play
 
 ## Manage quarantine rules
 
-These tools let an AI agent list, create, and deactivate quarantine rules. See [Modify quarantine rules with AI](/docs/guides/modify-quarantine-rules-with-ai) for example conversations.
+These tools let an AI agent list, create, update, and deactivate quarantine rules. See [Modify quarantine rules with AI](/docs/guides/modify-quarantine-rules-with-ai) for example conversations.
 
 ### `list_quarantine_rules`
 
@@ -191,6 +191,26 @@ Creates a quarantine rule for an exact suite and scope. Use `query_samples` to r
 
 In addition to `suiteId`, provide at least one of `testId`, `projectName`, or `branch`. Omitted scope fields match any value within the suite.
 
+### `update_quarantine_rule`
+
+Replaces all editable settings of an active quarantine rule, keeping its ID and its priority among overlapping rules. Use `list_quarantine_rules` to retrieve the ID. The suite cannot change, and inactive rules cannot be edited.
+
+<ParameterTable>
+
+  | Parameter | Type | Description |
+  | --- | --- | --- |
+  | `ruleId` | string | Exact quarantine rule ID returned by `list_quarantine_rules`. |
+  | `testId` | string \| null | Exact persisted `test.id`, or null to match all tests in the suite. |
+  | `projectName` | string \| null | Exact Playwright project name, or null to match any project. |
+  | `branch` | string \| null | Exact branch name, or null to match any branch. |
+  | `reason` | string \| null | Reason for quarantining the matching tests, or null to clear it. |
+  | `endsAt` | RFC 3339 string \| null | Future expiry timestamp, or null for no expiry. |
+  | `organizationId` | string | Optional organization. Omit it to use the organization from the active login. |
+
+</ParameterTable>
+
+Supply every editable field explicitly. At least one of `testId`, `projectName`, or `branch` must remain set.
+
 ### `deactivate_quarantine_rule`
 
 Deactivates one quarantine rule by its exact ID. Use `list_quarantine_rules` to retrieve the ID.