The agent that grows with you
Python aiai-agentai-agentsanthropicchatgptclaudeclaude-codecodexhermeshermes-agentllmnous-researchopenai
"""Directory initialization and storage diagnostics for the active Hermes home."""
import os
from pathlib import Path
from hermes_dir_acl import make_user_dir
class HomeInitializationError(RuntimeError):
"""The home skeleton is unavailable, not an invalid YAML document."""
def _directory_links(path: Path) -> list[Path]:
return [part for part in (*reversed(path.parents), path) if part.is_symlink()]
def _operator_owned_links(links: list[Path], home: Path) -> list[Path]:
"""Keep only the links that make the operator the owner of the home's permissions.
That boundary is the home itself and anything under it. A link *above* the home
(macOS ``/tmp`` -> ``/private/tmp``, ``/var`` -> ``/private/var``, or any aliased parent
the user happens to live in) says nothing about who owns :data:`home`, and treating it as
an operator-owned link left a fresh home and its ``cron``/``sessions``/``logs``/``memories``
subdirectories at the default ``0o755`` instead of ``0o700``.
"""
return [link for link in links if link == home or home in link.parents]
def _ensure_directory(path: Path, *, create: bool, secure: bool, home: Path) -> None:
from hermes_cli.config import _secure_dir
detail = ""
try:
links = _directory_links(path)
detail = "; ".join(f"{link} -> {link.readlink()}" for link in links)
# Never materialize a missing mount's target on the underlying disk.
for link in links:
if not link.is_dir():
raise FileNotFoundError(f"Directory link is unavailable: {link}")
if create:
make_user_dir(path, parents=True, exist_ok=True)
elif not path.is_dir():
raise FileNotFoundError(f"Required directory does not exist: {path}")
# The operator owns permissions beyond a link, including logs/curator.
if secure and not _operator_owned_links(links, home):
_secure_dir(path)
except OSError as exc:
raise HomeInitializationError(
f"Cannot initialize Hermes directory {path}: {exc}. "
+ (f"Directory links: {detail}. " if detail else "")
+ "Check the directory/link target, mount availability and access permissions; "
"restore the mount or repair the link before retrying. "
"Hermes has not replaced the link or created its missing target."
) from exc
def initialize_home(home: Path, subdirs: tuple[str, ...], ensured: set[str]) -> None:
from hermes_cli.config import _ensure_default_soul_md, is_managed
managed = is_managed()
old_umask = os.umask(0o007) if managed else None
try:
_ensure_directory(home, create=not managed, secure=not managed, home=home)
required = ("cron", "sessions", "logs", "memories") if managed else subdirs
for subdir in required:
_ensure_directory(home / subdir, create=not managed, secure=not managed, home=home)
if managed:
_ensure_directory(home / "logs" / "curator", create=True, secure=False, home=home)
try:
_ensure_default_soul_md(home)
except OSError as exc:
raise HomeInitializationError(
f"Cannot initialize Hermes home {home}: {exc}. "
"Check storage availability and access permissions."
) from exc
finally:
if old_umask is not None:
os.umask(old_umask)
# Plugin discovery rebinds the resolved home. Do not repeat chmod through
# that spelling after the operator-owned symlink boundary has been lost.
ensured.update((str(home), str(home.resolve())))
def config_load_issue(exc: Exception):
from hermes_cli.config_issues import ConfigIssue
if isinstance(exc, (HomeInitializationError, OSError)):
return ConfigIssue(
"error", f"Hermes storage is unavailable: {exc}",
"Check the reported path, link target, mount and permissions; keep config.yaml unchanged.",
)
return ConfigIssue("error", "Could not load config.yaml", "Run 'hermes setup' to create a valid config")