| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103 |
- """Process-owned admission fence for cooperative Desktop backend retirement.
- The gate belongs to the process, not a profile or transport. Diagnostic ledgers alone cannot
- close the check/use race: every source of new work must reserve admission before dispatch.
- """
- from contextlib import contextmanager
- import logging
- import secrets
- import threading
- import time
- class RetirementFence:
- """Exclusive 30-second prepare permit; commit closes admission permanently.
- Tokens are random and recognized only by this process instance. A committed prepare
- returns the same token so a client can recover a lost commit response without reopening.
- """
- def __init__(self):
- self._lock = threading.Lock()
- self._active = 0
- self._preparing = False
- self._token = None
- self._committed = False
- self._expires_at = 0.0
- self._now = time.monotonic
- def _expire(self):
- if self._token is not None and not self._committed and self._now() >= self._expires_at:
- self._token = None
- def acquire(self):
- with self._lock:
- self._expire()
- if self._preparing or self._token is not None:
- return False
- self._active += 1
- return True
- def release(self):
- with self._lock:
- self._active -= 1
- def active_count(self):
- with self._lock:
- return self._active
- @contextmanager
- def work(self):
- admitted = self.acquire()
- try:
- yield admitted
- finally:
- if admitted:
- self.release()
- def prepare(self):
- from hermes_cli.web_server_idle_proof import idle_proof
- with self._lock:
- self._expire()
- if self._committed:
- return {"ok": True, "idle": True, "token": self._token}
- if self._preparing or self._token is not None or self._active:
- return {"ok": False, "idle": False}
- self._preparing = True
- # No admissions can cross the freeze. Do not hold our lock while reading ledgers:
- # some callers already hold a session/cron lock when reserving their work.
- verdict = None
- try:
- verdict = idle_proof()["idle"]
- except Exception:
- logging.getLogger(__name__).warning("Retirement idle probe unavailable", exc_info=True)
- finally:
- with self._lock:
- self._preparing = False
- if verdict is True:
- self._token = token = secrets.token_urlsafe(32)
- self._expires_at = self._now() + 30.0
- if verdict is not True:
- return {"ok": False, "idle": verdict}
- return {"ok": True, "idle": True, "token": token}
- def commit(self, token):
- with self._lock:
- self._expire()
- if not token or token != self._token:
- return {"ok": False}
- self._committed = True
- return {"ok": True}
- def cancel(self, token):
- with self._lock:
- self._expire()
- if not token or token != self._token or self._committed:
- return {"ok": False}
- self._token = None
- return {"ok": True}
- retirement = RetirementFence()
|