mirror of
https://github.com/ruvnet/RuView
synced 2026-07-26 18:01:48 +00:00
ruv
424721fa16
- Implements WasmtimeRuntime in v2/crates/homecore-plugins/src/wasmtime_runtime.rs with a Wasmtime 25 Cranelift JIT engine. Registers 4 host imports via Linker: hc_state_get, hc_state_set, hc_state_subscribe, hc_log. Each plugin gets an isolated Store<PluginStoreData> holding a HomeCore handle + subscription list. - Adds host_abi.rs documenting the JSON-over-linear-memory wire format (public ABI spec for plugin authors). Max buffer 64 KiB. ConfigEntryJson and StateChangedEventJson are the canonical wire types. - Creates v2/crates/homecore-plugin-example/ (wasm32-unknown-unknown, excluded from workspace per wifi-densepose-wasm-edge pattern). The plugin monitors sensor.test_temp and sets binary_sensor.test_alert on/off at 25/20 thresholds. - Adds tests/integration.rs with 3 tests: compiled .wasm end-to-end round-trip, WAT-based fallback (always runs), and linker smoke test. All 15 tests pass (12 unit + 3 integration) under --features wasmtime. - ADR-128 Q2 resolved: Wasmtime is the chosen runtime for P2. WASM3 stays as future fallback under --features wasm3 for constrained hardware (ADR-128 §8). Co-Authored-By: claude-flow <ruv@ruv.net>
63 lines
2.2 KiB
TOML
63 lines
2.2 KiB
TOML
# HOMECORE-PLUGINS — WASM integration plugin system.
|
|
# Implements ADR-128 (HOMECORE-PLUGINS), P1 scaffold:
|
|
# - PluginManifest (serde-deserialised, superset of HA manifest.json)
|
|
# - HomeCorePlugin async trait + PluginId + PluginError
|
|
# - PluginRuntime trait + InProcessRuntime (native Rust, first-party plugins)
|
|
# - PluginRegistry (load / unload / list)
|
|
#
|
|
# P2 will add the `wasmtime` feature (gated below, default-off) for the real
|
|
# Wasmtime JIT sandbox. wasm3 interpretation mode lands behind `--features wasm3`
|
|
# in P3 for constrained-hardware targets.
|
|
|
|
[package]
|
|
name = "homecore-plugins"
|
|
version = "0.1.0-alpha.0"
|
|
edition = "2021"
|
|
license = "MIT"
|
|
authors = ["rUv <ruv@ruv.net>", "HOMECORE Contributors"]
|
|
description = "WASM integration plugin runtime for HOMECORE (ADR-128 P1 scaffold)"
|
|
repository = "https://github.com/ruvnet/RuView"
|
|
|
|
[lib]
|
|
name = "homecore_plugins"
|
|
path = "src/lib.rs"
|
|
|
|
[features]
|
|
default = []
|
|
# P2: real Wasmtime JIT sandbox (Cranelift; ~15 MB binary delta on Pi 5).
|
|
# Do not enable in production until the host ABI is frozen (ADR-128 §8 risk).
|
|
wasmtime = ["dep:wasmtime"]
|
|
# P3: wasm3 interpretation mode for constrained hardware (~50 kB).
|
|
wasm3 = ["dep:wasm3"]
|
|
|
|
[dependencies]
|
|
# HOMECORE state machine — local path (ADR-127).
|
|
homecore = { path = "../homecore", version = "0.1.0-alpha.0" }
|
|
|
|
# Async runtime — same version as workspace.
|
|
tokio = { version = "1", features = ["sync", "rt", "rt-multi-thread", "time", "macros"] }
|
|
|
|
# Async trait support for HomeCorePlugin.
|
|
async-trait = "0.1"
|
|
|
|
# Error handling.
|
|
thiserror = "1"
|
|
|
|
# Serialisation (manifest JSON + ABI call payloads).
|
|
serde = { version = "1", features = ["derive"] }
|
|
serde_json = "1"
|
|
|
|
# UUIDs for config entry IDs in host_abi.rs.
|
|
uuid = { version = "1", features = ["v4"] }
|
|
|
|
# Optional Wasmtime runtime (P2, default-off — 30 MB dep).
|
|
wasmtime = { version = "25", optional = true }
|
|
|
|
# Optional wasm3 interpretation runtime (P3, default-off).
|
|
wasm3 = { version = "0.3", optional = true }
|
|
|
|
[dev-dependencies]
|
|
tokio = { version = "1", features = ["sync", "rt", "rt-multi-thread", "time", "macros", "test-util"] }
|
|
# WAT text-format compiler for inline WASM unit tests (wasmtime feature only).
|
|
wat = { version = "1", optional = false }
|