a5bd246865
* refactor(plugins): remove the Sep 2026 decomposition compat layer on schedule The PLUGIN-COMPAT layer (2776813df3+d63e380324+0a5164cebe) kept pre-#102117 import paths alive for external plugins until 2026-09-14. That window closed two weeks ago; since then the loader has already been skipping plugins that use the old paths. This removes the layer itself: - 328 appended `PLUGIN-COMPAT` blocks (lazy `__getattr__` pointer tables, re-exported third-party names, restored dead definitions) and the three re-export stub modules (gateway/startup_watchdog, hermes_cli/observability/relay_runtime, tools/environments/modal_utils) - COMPAT_MANIFEST.md, compat_manifest.json, scripts/check_compat_pointers.py and its lint step - the reporting surfaces: CLI banner notice, `hermes plugins compat`, the `hermes doctor` section, the post-update notice, the Desktop one-time dialog, the loader's pre-import skip and the `plugins.allow_deprecated_imports` escape hatch An external plugin that still imports an old path now fails to load with its ImportError as the reason in `hermes plugins list`, the same path as any broken plugin. hermes_cli/plugin_compat.py stays as three inert stubs (compat_report, removal_in_effect, summary_lines): an already-running pre-removal `hermes update` lazy-imports them after the checkout swap (tests/compat/old_updater_surface.json). In-tree fallout, both already dead: hermes_cli/setup.py::_check_espeak_ng (no callers; its `shutil` came from a compat block) and gateway/config.py::SessionResetPolicy ("retained solely for the scheduled plugin-compat window"). Two test_run_agent patches targeted the removed `run_agent.handle_function_call` pointer; they now patch `model_tools.handle_function_call`, the seam production reads, like every sibling test in that file. * chore: retrigger CI (zero-job startup_failure phantom) * test: drop resolution allowlist rows for the two deleted which() sites hermes_cli/setup.py::_check_espeak_ng (dead) and tools/skillevaluator_scan.py::scanner_available (a restored definition inside a PLUGIN-COMPAT block) no longer exist; the stale-row gate requires their allowlist entries go with them.
61 lines
2.7 KiB
Python
61 lines
2.7 KiB
Python
"""Disk-usage rollup for ``/api/status``.
|
|
|
|
Companion to :mod:`gateway.memory_status`: a hosted agent can fill its data
|
|
volume (SQLite writes failing, config saves lost) while its dashboard looks
|
|
healthy. Sampled live via one ``statvfs`` call, so there is no ``sampled_at``.
|
|
``/api/status`` is unauthenticated: only coarse numbers (MB, one-decimal
|
|
percent) and an enum. Best-effort: an unreadable filesystem degrades to
|
|
``pressure="unknown"`` rather than raising into the status endpoint.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import shutil
|
|
from pathlib import Path
|
|
from typing import Any, Dict, Optional
|
|
|
|
from gateway.memory_status import _nonneg_int
|
|
|
|
# Percent alone misleads both ways: 90% used on 100 GB leaves 10 GB, while 50% on a tiny
|
|
# volume is one download from write failures. So percent triggers are gated on absolute
|
|
# headroom also being low, and a hard floor applies regardless of size (below it SQLite
|
|
# journaling / config writes are at risk). Rows: (level, free floor, used-%, headroom); worst first.
|
|
_PRESSURE_TIERS = (
|
|
("critical", 256, 95.0, 1024), # < 256 MB free, or >= 95% used AND < 1 GB free
|
|
("elevated", 512, 85.0, 4096), # < 512 MB free, or >= 85% used AND < 4 GB free
|
|
)
|
|
_BYTES_PER_MB = 1024 * 1024
|
|
|
|
|
|
def classify_disk_pressure(free_mb: Any, total_mb: Any) -> str:
|
|
"""``ok``/``elevated``/``critical`` from free/total MB; ``unknown`` when the sample
|
|
is missing/malformed — "could not read it" must never read as "fine"."""
|
|
free, total = _nonneg_int(free_mb), _nonneg_int(total_mb)
|
|
if free is None or not total:
|
|
return "unknown"
|
|
used_percent = (1 - free / total) * 100.0
|
|
for level, free_floor, percent_floor, headroom in _PRESSURE_TIERS:
|
|
if free < free_floor or (used_percent >= percent_floor and free < headroom):
|
|
return level
|
|
return "ok"
|
|
|
|
|
|
def collect_disk_status(home: Optional[Path] = None) -> Dict[str, Any]:
|
|
"""``disk`` block for ``/api/status`` (same ``home`` contract as ``memory``).
|
|
Never raises — an unreadable/unmounted filesystem yields ``pressure="unknown"``."""
|
|
status: Dict[str, Any] = {"pressure": "unknown", "total_mb": None, "free_mb": None, "used_percent": None}
|
|
try:
|
|
if home is None:
|
|
from hermes_constants import get_hermes_home
|
|
|
|
home = get_hermes_home()
|
|
usage = shutil.disk_usage(home)
|
|
except Exception:
|
|
return status
|
|
if usage.total <= 0:
|
|
return status
|
|
total_mb, free_mb = usage.total // _BYTES_PER_MB, usage.free // _BYTES_PER_MB
|
|
status.update(total_mb=total_mb, free_mb=free_mb, used_percent=round((usage.used / usage.total) * 100, 1),
|
|
pressure=classify_disk_pressure(free_mb, total_mb))
|
|
return status
|