Struct SpatialService 

pub struct SpatialService { /* private fields */ }

Kernel service for the spatial BVH index.

Implementations

impl SpatialService

pub fn new( config: SpatialServiceConfig, backend: Arc<dyn SpatialBackend>, ) -> Self

Wrap an existing backend.

pub fn from_config(config: SpatialServiceConfig) -> Self

Construct the default BVH backend from config.

pub fn from_spatial_config(cfg: &SpatialConfig) -> Self

Construct from types-layer SpatialConfig.

pub fn attach_chain(&self, cm: Arc<ChainManager>)

Attach ExoChain sink to the underlying BVH backend.

pub fn backend(&self) -> &Arc<dyn SpatialBackend>

Shared backend handle.

pub fn bvh(&self) -> Option<&Arc<BvhBackend>>

Concrete BVH backend when available.

pub fn insert(&self, leaf: Leaf) -> SpatialResult<LeafId>

Insert a leaf.

pub fn remove(&self, id: LeafId) -> bool

Remove a leaf.

pub fn get(&self, id: LeafId) -> Option<Leaf>

Get a leaf.

pub fn query_point(&self, p: Vec3) -> Vec<LeafId>

Query point.

pub fn query_aabb(&self, bb: Aabb) -> Vec<LeafId>

Query AABB.

pub fn query_sphere(&self, center: Vec3, radius: f32) -> Vec<LeafId>

Query sphere.

pub fn query_ray(&self, ray: Ray, max_t: f32) -> Vec<RayHit>

Query ray.

pub fn query_frustum(&self, frustum: &Frustum) -> Vec<LeafId>

Query frustum.

pub fn query_knn(&self, p: Vec3, k: usize) -> Vec<LeafId>

Query k-NN.

pub fn derive_branch(&self, meta: BranchMeta) -> SpatialResult<BranchId>

Derive a branch.

pub fn branch_diff( &self, a: BranchId, b: BranchId, region: Aabb, ) -> Vec<DiffEntry>

Branch diff.

pub fn status(&self) -> SpatialServiceStatus

Status snapshot for CLI / health_detail.

Trait Implementations

impl SystemService for SpatialService

fn name(&self) -> &str

Human-readable service name.

fn service_type(&self) -> ServiceType

Service type category.

fn start<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<(), Box<dyn Error + Send + Sync>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Start the service.

fn stop<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<(), Box<dyn Error + Send + Sync>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Stop the service.

fn health_check<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = HealthStatus> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Perform a health check.

fn health_detail(&self) -> Option<String>

Optional operator-facing detail (metrics, endpoints, …).

fn liveness_check<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = ProbeResult> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Liveness probe (K2b-G2, os-patterns).

fn readiness_check<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = ProbeResult> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Readiness probe (K2b-G2, os-patterns).