Struct Kernel 

pub struct Kernel<P: Platform> { /* private fields */ }

The WeftOS kernel.

Wraps AppContext<P> in a managed boot sequence with process tracking, service lifecycle, IPC, and health monitoring.

Lifecycle

1. Call Kernel::boot to initialize all subsystems.
2. The kernel transitions from Booting -> Running.
3. Call Kernel::shutdown to gracefully stop everything.
4. The kernel transitions from Running -> ShuttingDown -> Halted.

Implementations

impl<P: Platform> Kernel<P>

pub async fn boot( config: Config, kernel_config: KernelConfig, platform: Arc<P>, ) -> KernelResult<Self>

Boot the kernel from configuration and platform.

This is the primary entry point. It:

1. Creates subsystems (process table, service registry, IPC, health)
2. Creates AppContext (reuses existing bootstrap)
3. Registers the kernel process (PID 0)
4. Starts all registered services
5. Transitions to Running state

Errors

Returns KernelError::Boot if any critical subsystem fails to initialize.

pub async fn shutdown(&mut self) -> KernelResult<()>

Shut down the kernel gracefully.

Stops all services, cancels all processes, and transitions to the Halted state.

pub fn state(&self) -> &KernelState

Get the current kernel state.

pub fn kernel_config(&self) -> &KernelConfig

Get the kernel configuration.

pub fn process_table(&self) -> &Arc<ProcessTable>

Get the process table.

pub fn services(&self) -> &Arc<ServiceRegistry>

Get the service registry.

pub fn ipc(&self) -> &Arc<KernelIpc>

Get the IPC subsystem.

pub fn bus(&self) -> &Arc<MessageBus>

Get the message bus.

pub fn a2a_router(&self) -> &Arc<A2ARouter>

Get the A2A router.

pub fn cron_service(&self) -> &Arc<CronService>

Get the cron service.

pub fn health(&self) -> &HealthSystem

Get the health system.

pub fn supervisor(&self) -> &AgentSupervisor<P>

Get the agent supervisor.

pub fn boot_log(&self) -> &BootLog

Get the boot log.

pub fn event_log(&self) -> &Arc<KernelEventLog>

Get the runtime event log (ring buffer).

pub fn uptime(&self) -> Duration

Get kernel uptime.

pub fn cluster_membership(&self) -> &Arc<ClusterMembership>

Get the cluster membership tracker.

pub fn chain_manager(&self) -> Option<&Arc<ChainManager>>

Get the local chain manager (when exochain feature is enabled).

pub fn tree_manager(&self) -> Option<&Arc<TreeManager>>

Get the tree manager (when exochain feature is enabled).

pub fn governance_gate(&self) -> Option<&Arc<dyn GateBackend>>

Get the governance gate backend (if configured).

pub fn ecc_hnsw(&self) -> Option<&Arc<HnswService>>

Get the ECC HNSW service (if ecc feature enabled).

pub fn ecc_causal(&self) -> Option<&Arc<CausalGraph>>

Get the ECC causal graph (if ecc feature enabled).

pub fn ecc_tick(&self) -> Option<&Arc<CognitiveTick>>

Get the ECC cognitive tick (if ecc feature enabled).

pub fn ecc_calibration(&self) -> Option<&EccCalibration>

Get the ECC calibration results (if ecc feature enabled).

pub fn ecc_crossrefs(&self) -> Option<&Arc<CrossRefStore>>

Get the ECC cross-reference store (if ecc feature enabled).

pub fn ecc_impulses(&self) -> Option<&Arc<ImpulseQueue>>

Get the ECC impulse queue (if ecc feature enabled).

pub fn take_app_context(&mut self) -> Option<AppContext<P>>

Take ownership of the AppContext for agent loop consumption.

This is a one-shot operation: after calling this, the kernel no longer holds the AppContext. Use this before calling AppContext::into_agent_loop().