Files
hermes-agent/hermes_cli/plugins_cmd_remove.py
ethernet 1e76db800c refactor(cli): split plugins_cmd.py into topical siblings
plugins_cmd.py had grown to 2,858 lines, past the ~2,000-line gate. Move
each verb family into a plugins_cmd_<topic>.py sibling: git (install
metadata + git plumbing), install, update (plus adopt / trust-update-url /
check-updates), remove, capabilities, toggle (composite UI) and listing.
The facade keeps the shared primitives, enable/disable selection,
discovery and the dispatch table, and re-exports the names other modules,
tests and the old-updater surface import (978 lines now).

Siblings never import the facade at module level; they read facade names
through _pc() at call time, so monkeypatching plugins_cmd.<name> still
intercepts calls made from a sibling. No behaviour change. Tests that
imported three sibling-only helpers now import them from the defining
module, and two subprocess.run patches target subprocess directly.
2026-09-24 11:50:29 -04:00

95 lines
4.1 KiB
Python

"""``hermes plugins remove``: tree + install-metadata removal kept consistent, config bookkeeping, and the
dashboard/TUI remove path.
Sibling of :mod:`hermes_cli.plugins_cmd` (the facade re-exports the names other modules use and is
imported late here, never at module level).
"""
from __future__ import annotations
import os
import tempfile
from pathlib import Path
from typing import Any
def _pc():
"""The facade, read at call time: tests patch ``plugins_cmd.<name>`` and sibling calls must see it."""
from hermes_cli import plugins_cmd
return plugins_cmd
def _remove_plugin_core(target: Path) -> None:
"""Remove one plugin and its metadata without splitting their state."""
if target.name not in _pc()._read_install_metadata():
_pc().rmtree_readonly(target)
return
staging = Path(tempfile.mkdtemp(prefix=f".{target.name}.remove-", dir=target.parent))
backup = staging / "plugin"
os.replace(target, backup)
try:
_pc()._update_install_record(target.name, lambda _current: None)
except Exception:
try:
os.replace(backup, target)
except OSError as restore_exc:
raise _pc().PluginOperationError(
f"Plugin metadata update failed and '{target.name}' could not be "
f"restored automatically; recovery copy remains at {backup}."
) from restore_exc
_pc().rmtree_readonly(staging, ignore_errors=True)
raise
_pc().rmtree_readonly(staging)
def cmd_remove(name: str) -> None:
"""Remove an installed plugin by name."""
console = _pc()._console()
plugins_dir = _pc()._plugins_dir()
target = _pc()._require_installed_plugin(name, plugins_dir, console)
try:
result = _remove_user_plugin(plugins_dir, name, target)
except (OSError, _pc().PluginOperationError) as exc:
_pc()._fail(console, f"[red]Error:[/red] Could not remove plugin '{name}': {exc}")
console.print()
console.print(f"[red]✗[/red] Plugin [bold]{name}[/bold] removed from {plugins_dir}")
if result.get("cleared_memory_provider"):
console.print("[yellow]memory.provider pointed at this plugin and was reset; "
"run `hermes memory setup` to pick another.[/yellow]")
console.print()
def _remove_user_plugin(plugins_dir: Path, name: str, target: Path) -> dict[str, Any]:
"""Shared ``remove`` tail for the CLI, the dashboard and the ``plugins.manage`` RPC.
*target* is the resolved directory; when ``plugins_dir/name`` itself is a symlink only the link
goes — the tree it points at may be another installed plugin (a dev alias to a sibling checkout),
and following it deleted that plugin plus its install metadata while the alias stayed dangling.
Config bookkeeping (aliases, toolset) is gathered before the tree disappears.
"""
link = plugins_dir / name.strip("/")
if link.is_symlink():
link.unlink()
return {"ok": True, "name": name, **_pc()._forget_plugin_config({link.name})}
entry = next((e for e in _pc()._discover_all_plugins() if Path(str(e[4])) == target), None)
key = entry[5] if entry else target.name
aliases = _pc()._plugin_aliases(key) | {target.name}
if _pc()._read_manifest(target).get("provides_tools"):
_pc()._toggle_plugin_toolset(key, enable=False)
_remove_plugin_core(target)
return {"ok": True, "name": name, **_pc()._forget_plugin_config(aliases)}
def dashboard_remove_user_plugin(name: str) -> dict[str, Any]:
"""Delete a plugin tree under ``~/.hermes/plugins/`` only."""
plugins_dir = _pc()._plugins_dir()
if any(n == name and src == "bundled" for n, _ver, _d, src, _path, _key in _pc()._discover_all_plugins()):
return {"ok": False, "error": "Bundled plugins cannot be removed from the dashboard."}
target = _pc()._user_installed_plugin_dir(name)
if target is None:
return {"ok": False, "error": f"Plugin '{name}' was not found under {plugins_dir}."}
try:
return _remove_user_plugin(plugins_dir, name, target)
except (OSError, _pc().PluginOperationError) as exc:
return {"ok": False, "error": f"Could not remove plugin '{name}': {exc}"}