Teknium
2776813df3
The Sep 2026 decomposition (PR #102117) makes internal import paths a non-API: names now live in the focused modules that define them. This commit is the ONLY thing keeping the old paths alive, so external plugins have time to update. It is deliberately a single, unsquashed commit: git revert <this sha> removes every shim, stub and manifest at once on the announced date. Nothing in-tree may depend on these pointers: scripts/check_compat_pointers.py (wired into lint.yml) fails CI if it does. What it adds (see COMPAT_MANIFEST.md, compat_manifest.json): - 332 facade modules get one delimited `PLUGIN-COMPAT` block appended at the end of the file - 1,172 moved names resolved lazily via a module `__getattr__` (PEP 562) — never a top-level import, so no import cycles; facades that already had `__getattr__` get a chained one - 592 third-party/stdlib names the old modules used to expose, with their original import statements - 266 public definitions that had been deleted as unused, restored byte-for-byte from the pre-decomposition tree (+40 private helpers and 16 imports pulled in only because a restored definition needs them) - 3 deleted modules recreated as re-export stubs (gateway/startup_watchdog, hermes_cli/observability/ relay_runtime, tools/environments/modal_utils) - private names (`_x`) get no pointer: they were never API (3,792 skipped) Verified: all 335 touched modules import under a fresh HERMES_HOME and every manifest name resolves; the lint reports zero in-tree uses; ruff clean; targeted suites unchanged.
82 lines
3.4 KiB
Python
82 lines
3.4 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
|
|
|
|
|
|
# ---- BEGIN PLUGIN-COMPAT (revert-scheduled; see COMPAT_MANIFEST.md) ----
|
|
# Names external plugins imported from this module before the Sep 2026 decomposition.
|
|
# Internal code MUST NOT use these (scripts/check_compat_pointers.py fails CI if it does).
|
|
# The whole block is removed by reverting the commit that added it.
|
|
import logging # noqa: F401,E402
|
|
|
|
|
|
_PLUGIN_COMPAT_LAZY = {
|
|
'logger': ('gateway.run', 'logger'),
|
|
}
|
|
|
|
|
|
def __getattr__(name): # PEP 562 — lazy so no import cycles
|
|
target = _PLUGIN_COMPAT_LAZY.get(name)
|
|
if target is None:
|
|
raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
|
|
import importlib
|
|
return getattr(importlib.import_module(target[0]), target[1])
|
|
# ---- END PLUGIN-COMPAT ----
|