feedBack/tests/test_plugin_runtime_idempotence.py
2026-06-16 18:47:13 +02:00

185 lines
9.5 KiB
Python

from pathlib import Path
import pytest
ROOT = Path(__file__).resolve().parents[1]
WORKSPACE_ROOT = ROOT.parent
def _sibling_file(plugin_dir: str, filename: str) -> Path:
path = WORKSPACE_ROOT / plugin_dir / filename
if not path.exists():
pytest.skip(f"requires sibling plugin checkout: {plugin_dir}/{filename}")
return path
def _sibling_text(plugin_dir: str, filename: str, required_token: str | None = None) -> str:
text = _sibling_file(plugin_dir, filename).read_text(encoding="utf-8")
if required_token and required_token not in text:
pytest.skip(f"requires {plugin_dir} checkout with {required_token}")
return text
def test_plugin_loader_guards_duplicate_hydration_and_scripts():
source = (ROOT / "static" / "app.js").read_text(encoding="utf-8")
assert "let _loadPluginsInFlight = false" in source
assert "window.slopsmith._loadedPluginScripts" in source
assert "document.querySelectorAll('.screen[id^=\"plugin-\"]')" in source
def test_plugin_loader_unmounts_previous_ui_contributions_before_reregistering():
source = (ROOT / "static" / "app.js").read_text(encoding="utf-8")
assert "const _pluginUiContributions = new Map()" in source
assert "await _commandUiDomain(contribution.domain, 'unmount', plugin, contribution)" in source
assert "await _commandUiDomain(contribution.domain, 'register-contribution', plugin, contribution)" in source
assert "await _commandUiDomain(contribution.domain, 'mount', plugin, contribution)" in source
def test_plugin_loader_unmounts_contributions_for_removed_plugins():
source = (ROOT / "static" / "app.js").read_text(encoding="utf-8")
assert "const livePluginIds = new Set(plugins.map((plugin) => plugin.id))" in source
assert "for (const [pluginId, contributions] of _pluginUiContributions)" in source
assert "const stalePlugin = { id: pluginId }" in source
assert "await _commandUiDomain(contribution.domain, 'unmount', stalePlugin, contribution)" in source
assert "window.slopsmith?.capabilities?.unregisterParticipant?.(pluginId)" in source
assert "_pluginUiContributions.delete(pluginId)" in source
def test_capability_visualizer_waits_for_registry_instead_of_hard_error():
source = _sibling_file("slopsmith-plugin-capability-visualizer", "screen.js").read_text(encoding="utf-8")
assert "scheduleRegistryRetry" in source
assert "Capability runtime is loading..." in source
assert "Capability registry unavailable" not in source
def test_app_shell_loads_capability_registry_before_app_runtime():
source = (ROOT / "static" / "index.html").read_text(encoding="utf-8")
assert '<script src="/static/capabilities.js"></script>' in source
assert '<script src="/static/capabilities/library.js"></script>' in source
assert source.index('/static/diagnostics.js') < source.index('/static/capabilities.js')
assert source.index('/static/capabilities.js') < source.index('/static/capabilities/library.js')
assert source.index('/static/capabilities/library.js') < source.index('/static/app.js')
def test_capability_registry_exposes_claim_dispatch_and_ready_contracts():
source = (ROOT / "static" / "capabilities.js").read_text(encoding="utf-8")
for token in ["function claim(", "function release(", "async function dispatch(", "function subscribe(", "getDiagnostics: snapshotDiagnostics"]:
assert token in source
assert "activeClaims" in source
assert "slopsmith:capabilities:ready" in source
assert "outcome: 'overridden'" in source
def test_capability_runtime_overrides_do_not_mask_claims():
source = (ROOT / "static" / "capabilities.js").read_text(encoding="utf-8")
set_enabled = source[source.index("function setParticipantEnabled("):source.index("function registerParticipants(")]
reserved = source[source.index("const RESERVED_FUTURE_DOMAINS"):source.index("const RUNTIME_DOMAIN_DEFAULTS")]
assert "['denied', 'failed', 'short-circuited', 'handled', 'degraded', 'overridden', 'no-owner', 'no-handler', 'no-target', 'unsupported-command', 'incompatible', 'incompatible-version', 'unavailable', 'provider-selection-required', 'user-action-required', 'stale', 'cancelled', 'stopped'].includes(decision.outcome)" in source
assert "if (entry.type !== 'manual') return false;" in source
assert "type: 'manual'" in source
assert "_remember(userOverrides" not in set_enabled
assert "'audio-monitoring'" not in reserved
assert "'audio-mix'" not in reserved
assert "'audio-input'" not in reserved
assert "'playback'" not in reserved
assert "playback:" in source
assert "'backend.routes'" in reserved
assert "'backend.routes':" not in source
def test_deferred_runtime_domains_remain_reserved_not_bridged():
capability_source = (ROOT / "static" / "capabilities.js").read_text(encoding="utf-8")
reserved = capability_source[capability_source.index("const RESERVED_FUTURE_DOMAINS"):capability_source.index("const RUNTIME_DOMAIN_DEFAULTS")]
review = capability_source[capability_source.index("const CORE_DOMAIN_REVIEW"):capability_source.index("const EXPECTED_COMPATIBILITY_SHIMS")]
# Domains still reserved (not yet promoted).
for token in ["'ui.navigation'"]:
assert token in reserved, f"{token} should still be in RESERVED_FUTURE_DOMAINS"
assert token not in review, f"{token} should not yet appear in CORE_DOMAIN_REVIEW"
# 'visualization' was promoted to an active domain (cap:6).
assert "'visualization'" not in reserved, "'visualization' should have been removed from RESERVED_FUTURE_DOMAINS after promotion"
assert "visualization:" in review, "'visualization' should appear in CORE_DOMAIN_REVIEW after promotion"
# 'note-detection' was promoted to an active domain (cap:9 / spec 009).
assert "'note-detection'" not in reserved, "'note-detection' should have been removed from RESERVED_FUTURE_DOMAINS after promotion"
assert "note-detection':" in review, "'note-detection' should appear in CORE_DOMAIN_REVIEW after promotion"
assert "playback:" in review
assert "chartT: _chartTime(audioT)" not in capability_source
assert "loop: _loopSnapshot()" not in capability_source
def test_capability_events_do_not_bridge_deferred_surfaces():
app_source = (ROOT / "static" / "app.js").read_text(encoding="utf-8")
capability_source = (ROOT / "static" / "capabilities.js").read_text(encoding="utf-8")
for token in ["return 'ui.navigation'", "return 'note-detection'", "eventName.startsWith('viz:') || eventName.startsWith('highway:')"]:
assert token not in app_source
for token in ["'navigate'", "'screen:changed'", "function _navigate(", "window.slopsmith.navigate(id, params)"]:
assert token not in capability_source
def test_plugin_loader_registers_manifest_capability_declarations():
source = (ROOT / "static" / "app.js").read_text(encoding="utf-8")
assert "const capabilityPlugins = fetchedPlugins.slice().sort((a, b) => String(a.id || '').localeCompare(String(b.id || '')))" in source
assert "capabilityApi.registerParticipants(capabilityPlugins)" in source
assert "window.slopsmith.capabilities.registerParticipants(plugins)" not in source
assert "plugin-manifest-load" in source
def test_app_event_bus_dispatches_locally_and_preserves_juce_stop_state():
source = (ROOT / "static" / "app.js").read_text(encoding="utf-8")
assert "this.dispatchEvent(new CustomEvent(event, { detail }))" in source
assert "const hadPlayableSong = !!audio.src || !!window._juceAudioUrl || isPlaying" in source
assert "sm.emit('song:resume', payload)" in source
assert "window.slopsmith.emit('song:resume', payload)" in source
def test_nam_and_stems_use_owner_claim_dispatch_semantics():
nam_source = _sibling_text("slopsmith-plugin-nam-tone", "screen.js", "NAM_STEM_CLAIM_ID = 'nam.amp-active'")
stems_source = _sibling_text("slopsmith-plugin-stems", "screen.js", "claimSnapshots")
assert "NAM_STEM_CLAIM_ID = 'nam.amp-active'" in nam_source
assert "api.dispatch({" in nam_source
assert "command: 'mute'" in nam_source
assert "command: 'restore'" in nam_source
assert "claim: { claimId, requester: NAM_PLUGIN_ID }" in nam_source
assert "window._stemsState" not in nam_source
assert "claimSnapshots" in stems_source
assert "api.registerParticipant('stems'" in stems_source
assert "mute: capMute" in stems_source
assert "restore: capRestore" in stems_source
assert "recordUserOverride" in stems_source
assert "clearClaimSnapshots" in stems_source
assert "'claim:released'" in stems_source
def test_nam_screen_uses_stable_singleton_hooks_for_rehydration():
source = _sibling_text("slopsmith-plugin-nam-tone", "screen.js", "window.__slopsmithNamHooks")
manifest = _sibling_text("slopsmith-plugin-nam-tone", "plugin.json", "capability-pipelines.v1")
assert "plugin-runtime-idempotent.v1" in manifest
assert "capability-pipelines.v1" in manifest
assert "window.__slopsmithNamHooks" in source
assert "hookState.impl" in source
assert "if (hookState.installed) return" in source
def test_stems_screen_uses_stable_singleton_hooks_for_rehydration():
source = _sibling_text("slopsmith-plugin-stems", "screen.js", "window.__slopsmithStemsHooks")
manifest = _sibling_text("slopsmith-plugin-stems", "plugin.json", "capability-pipelines.v1")
assert "plugin-runtime-idempotent.v1" in manifest
assert "capability-pipelines.v1" in manifest
assert "window.__slopsmithStemsHooks" in source
assert "hookState.impl" in source
assert "if (hookState.installed) return" in source