107 lines
4.4 KiB
Python
107 lines
4.4 KiB
Python
"""Integration test — plugin against a real hermes-webui fork checkout.
|
|
|
|
Skipped when hermes-webui isn't adjacent to the plugin repo (CI without the
|
|
fork mounted). Validates the loader hook actually loads + registers our 7
|
|
public-API methods + reports the audio processor on startup.
|
|
|
|
Run via: `pytest tests/integration -v` — make smoke uses the same harness.
|
|
"""
|
|
import sys
|
|
from pathlib import Path
|
|
|
|
import pytest
|
|
|
|
PLUGIN_REPO = Path(__file__).resolve().parents[2]
|
|
FORK_REPO = PLUGIN_REPO.parent / "hermes-webui"
|
|
MANIFEST = PLUGIN_REPO / "manifest.yaml"
|
|
|
|
|
|
@pytest.fixture(scope="module")
|
|
def loader():
|
|
"""Import the fork's loader. Skip cleanly when fork not adjacent."""
|
|
if not (FORK_REPO / "api" / "svrnty_plugin_loader.py").is_file():
|
|
pytest.skip(f"hermes-webui fork not at {FORK_REPO}; integration env required")
|
|
sys.path.insert(0, str(FORK_REPO))
|
|
try:
|
|
from api import svrnty_plugin_loader as loader_mod
|
|
except ImportError as e:
|
|
pytest.skip(f"loader import failed: {e}")
|
|
return loader_mod
|
|
|
|
|
|
def test_loader_exposes_seven_method_contract(loader):
|
|
"""Public API surface must be exactly 7 methods (per protocol §5.1)."""
|
|
api = loader._PluginAPI()
|
|
methods = {m for m in dir(api) if not m.startswith("_")}
|
|
expected = {
|
|
"register_route", "register_static", "inject_script",
|
|
"inject_stylesheet", "config_get", "logger",
|
|
"register_audio_attachment_processor",
|
|
}
|
|
assert methods == expected, (
|
|
f"loader API drift: missing={expected - methods} extra={methods - expected}. "
|
|
"Adding/removing methods requires a protocol PRD amendment."
|
|
)
|
|
|
|
|
|
def test_loader_register_wires_our_plugin(loader, monkeypatch):
|
|
"""End-to-end: env var → import this plugin → register() fires plugin routes + processor."""
|
|
monkeypatch.setenv("HERMES_WEBUI_PYTHON_PLUGIN", "svrnty_hermes_webui_plugin")
|
|
# Reset loader idempotency guard so we can re-run in-process
|
|
loader._LOADED = False
|
|
loader._ROUTES.clear()
|
|
loader._STATIC.clear()
|
|
loader._SCRIPTS.clear()
|
|
loader._STYLESHEETS.clear()
|
|
loader._AUDIO_PROCESSORS.clear()
|
|
|
|
sys.path.insert(0, str(PLUGIN_REPO))
|
|
loader.load_plugin()
|
|
|
|
# Core routes registered, including the /umbrella graph API pair.
|
|
assert ("POST", "/api/transcribe") in loader._ROUTES
|
|
assert ("GET", "/api/vault/status") in loader._ROUTES
|
|
assert ("GET", "/api/canvas/status") in loader._ROUTES
|
|
assert ("GET", "/api/canvas/tools") in loader._ROUTES
|
|
assert ("GET", "/api/canvas/proxy") in loader._ROUTES
|
|
assert ("POST", "/api/canvas/proxy") in loader._ROUTES
|
|
assert ("PUT", "/api/canvas/proxy") in loader._ROUTES
|
|
assert ("POST", "/api/canvas/command") in loader._ROUTES
|
|
assert ("GET", "/api/canvas/design-context") in loader._ROUTES
|
|
assert ("GET", "/api/canvas/events") in loader._ROUTES
|
|
assert ("GET", "/api/umbrella") in loader._ROUTES
|
|
assert ("GET", "/api/umbrella/doc") in loader._ROUTES
|
|
assert ("GET", "/api/cortex-os/runtime-health") in loader._ROUTES
|
|
# Static + injected URLs
|
|
assert "svrnty" in loader._STATIC
|
|
assert "/plugins/svrnty/app.css" in loader._STYLESHEETS
|
|
assert "/plugins/svrnty/app.js" in loader._SCRIPTS
|
|
assert "/plugins/svrnty/canvas.css" in loader._STYLESHEETS
|
|
assert "/plugins/svrnty/canvas.js" in loader._SCRIPTS
|
|
assert "/plugins/svrnty/umbrella_inline.css" in loader._STYLESHEETS
|
|
assert "/plugins/svrnty/umbrella_inline.js" in loader._SCRIPTS
|
|
assert "/plugins/svrnty/cortex-os/runtime-health/runtime_health.css" in loader._STYLESHEETS
|
|
assert "/plugins/svrnty/cortex-os/runtime-health/runtime_health.js" in loader._SCRIPTS
|
|
# Audio processor for voice-message transcription
|
|
assert len(loader._AUDIO_PROCESSORS) == 1
|
|
|
|
|
|
def test_manifest_declares_cortex_os_runtime_health_surface():
|
|
manifest = MANIFEST.read_text(encoding="utf-8")
|
|
|
|
assert "/api/cortex-os/runtime-health" in manifest
|
|
assert "routes/cortex_os_extension.py" in manifest
|
|
assert "/plugins/svrnty/cortex-os/runtime-health/runtime_health.css" in manifest
|
|
assert "/plugins/svrnty/cortex-os/runtime-health/runtime_health.js" in manifest
|
|
|
|
|
|
def test_loader_noop_when_env_unset(loader, monkeypatch):
|
|
"""No env var = no plugin loaded. Upstream behavior fully preserved."""
|
|
monkeypatch.delenv("HERMES_WEBUI_PYTHON_PLUGIN", raising=False)
|
|
loader._LOADED = False
|
|
loader._ROUTES.clear()
|
|
|
|
loader.load_plugin()
|
|
|
|
assert loader._ROUTES == {}, "plugin must NOT load when env var unset"
|