feat(freeze): add scheduled freeze CLI commands

Add `mergify freeze` command group with list, create, update, and delete
subcommands for managing scheduled merge freezes. Supports both Mergify
application keys and GitHub tokens for authentication, auto-detects
repository from git remote, and provides both table and JSON output.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Change-Id: I414d168066f7b5070e75520bdcbb8189d694ad72
Claude-Session-Id: 77d8be2d-854a-4d80-ac2d-4489fa50e31d

Author: jd

mergify_cli/cli.py

@@ -23,6 +23,7 @@
 
 from mergify_cli import VERSION
 from mergify_cli.ci import cli as ci_cli_mod
+from mergify_cli.freeze import cli as freeze_cli_mod
 from mergify_cli.stack import cli as stack_cli_mod
 
 
@@ -44,6 +45,7 @@ def cli(
 
 cli.add_command(stack_cli_mod.stack)
 cli.add_command(ci_cli_mod.ci)
+cli.add_command(freeze_cli_mod.freeze)
 
 
 def main() -> None:

mergify_cli/freeze/__init__.py

@@ -0,0 +1,115 @@
+from __future__ import annotations
+
+import typing
+
+
+if typing.TYPE_CHECKING:
+    import datetime
+    import uuid
+
+    import httpx
+
+
+class ScheduledFreezeResponse(typing.TypedDict, total=False):
+    id: typing.Required[str]
+    reason: typing.Required[str]
+    start: typing.Required[str]
+    end: typing.Required[str | None]
+    timezone: typing.Required[str]
+    matching_conditions: typing.Required[list[str]]
+    exclude_conditions: list[str]
+
+
+class ScheduledFreezePayload(typing.TypedDict, total=False):
+    reason: typing.Required[str]
+    start: typing.Required[str | None]
+    end: typing.Required[str | None]
+    timezone: typing.Required[str]
+    matching_conditions: typing.Required[list[str]]
+    exclude_conditions: list[str]
+
+
+async def list_freezes(
+    client: httpx.AsyncClient,
+    repository: str,
+) -> list[ScheduledFreezeResponse]:
+    response = await client.get(
+        f"/v1/repos/{repository}/scheduled_freeze",
+    )
+    data: dict[str, list[ScheduledFreezeResponse]] = response.json()
+    return data["scheduled_freezes"]
+
+
+async def create_freeze(
+    client: httpx.AsyncClient,
+    repository: str,
+    *,
+    reason: str,
+    timezone: str,
+    matching_conditions: list[str],
+    start: datetime.datetime | None = None,
+    end: datetime.datetime | None = None,
+    exclude_conditions: list[str] | None = None,
+) -> ScheduledFreezeResponse:
+    payload: ScheduledFreezePayload = {
+        "reason": reason,
+        "start": start.isoformat() if start is not None else None,
+        "end": end.isoformat() if end is not None else None,
+        "timezone": timezone,
+        "matching_conditions": matching_conditions,
+    }
+    if exclude_conditions:
+        payload["exclude_conditions"] = exclude_conditions
+
+    response = await client.post(
+        f"/v1/repos/{repository}/scheduled_freeze",
+        json=payload,
+    )
+    return response.json()  # type: ignore[no-any-return]
+
+
+async def update_freeze(
+    client: httpx.AsyncClient,
+    repository: str,
+    freeze_id: uuid.UUID,
+    *,
+    reason: str,
+    timezone: str,
+    matching_conditions: list[str],
+    start: datetime.datetime | None = None,
+    end: datetime.datetime | None = None,
+    exclude_conditions: list[str] | None = None,
+) -> ScheduledFreezeResponse:
+    payload: ScheduledFreezePayload = {
+        "reason": reason,
+        "start": start.isoformat() if start is not None else None,
+        "end": end.isoformat() if end is not None else None,
+        "timezone": timezone,
+        "matching_conditions": matching_conditions,
+    }
+    if exclude_conditions is not None:
+        payload["exclude_conditions"] = exclude_conditions
+
+    response = await client.patch(
+        f"/v1/repos/{repository}/scheduled_freeze/{freeze_id}",
+        json=payload,
+    )
+    return response.json()  # type: ignore[no-any-return]
+
+
+async def delete_freeze(
+    client: httpx.AsyncClient,
+    repository: str,
+    freeze_id: uuid.UUID,
+    *,
+    delete_reason: str | None = None,
+) -> None:
+    url = f"/v1/repos/{repository}/scheduled_freeze/{freeze_id}"
+    if delete_reason is not None:
+        await client.request(
+            "DELETE",
+            url,
+            json={"delete_reason": delete_reason},
+        )
+    else:
+        await client.delete(url)