Import AITURK IDE 1.0.0-beta.1 from Hermes 63279301; preserve MIT license

hermes_cli/subcommands/pause.py

@@ -0,0 +1,70 @@
+"""``hermes pause`` / ``hermes resume`` — the global emergency stop.
+
+``hermes pause`` writes the ESTOP sentinel at ``$HERMES_HOME/ESTOP``, which
+halts cron dispatch, kanban dispatch, and new gateway turns on their next
+check. In-flight work is never killed. ``hermes resume`` removes the
+sentinel and normal operation resumes on the next tick — no restart needed.
+
+Ported from: gastownhall/gastown estop.go (MIT); related prior art:
+#26778 (/panic — kill/exit semantics, different), #44617.
+"""
+
+from __future__ import annotations
+
+import argparse
+
+
+def cmd_pause(args: argparse.Namespace) -> int:
+    """Engage the global emergency stop."""
+    from agent.estop import engage, get_state, is_engaged
+
+    reason = getattr(args, "reason", None)
+    already = is_engaged()
+    path = engage(reason=reason)
+    state = get_state() or {}
+    verb = "Still paused" if already else "Hermes paused"
+    detail = f" — reason: {state['reason']}" if state.get("reason") else ""
+    print(f"⏸️  {verb}{detail}")
+    print(f"    sentinel: {path}")
+    print(
+        "    Cron dispatch, kanban dispatch, and new gateway turns are on hold.\n"
+        "    In-flight work keeps running. Run `hermes resume` to lift the pause."
+    )
+    return 0
+
+
+def cmd_resume(args: argparse.Namespace) -> int:
+    """Disengage the global emergency stop."""
+    from agent.estop import disengage, sentinel_path
+
+    if disengage():
+        print("▶️  Hermes resumed — dispatch picks up on the next tick.")
+    else:
+        print(f"Hermes is not paused (no sentinel at {sentinel_path()}).")
+    return 0
+
+
+def build_pause_parser(subparsers) -> None:
+    """Attach the ``pause`` and ``resume`` subcommands to ``subparsers``."""
+    pause_parser = subparsers.add_parser(
+        "pause",
+        help="Emergency stop: pause cron/kanban dispatch and new gateway turns",
+        description=(
+            "Engage the global emergency stop. Halts NEW work only — cron "
+            "dispatch, kanban dispatch, and new gateway turns — until "
+            "`hermes resume`. In-flight work is never killed."
+        ),
+    )
+    pause_parser.add_argument(
+        "--reason",
+        default=None,
+        help="Optional reason stored in the sentinel and shown to users",
+    )
+    pause_parser.set_defaults(func=cmd_pause)
+
+    resume_parser = subparsers.add_parser(
+        "resume",
+        help="Lift the emergency stop set by `hermes pause`",
+        description="Remove the ESTOP sentinel; dispatch resumes on the next tick.",
+    )
+    resume_parser.set_defaults(func=cmd_resume)