1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
//! Kernel error types.
//!
//! All kernel operations return [`KernelError`] for typed error
//! handling. The error variants cover process table operations,
//! service lifecycle, IPC, and boot sequence failures.
use crate::process::ProcessState;
/// Kernel-level errors.
#[non_exhaustive]
#[derive(Debug, thiserror::Error)]
pub enum KernelError {
/// Process not found in the process table.
#[error("process not found: PID {pid}")]
ProcessNotFound {
/// The PID that was looked up.
pid: u64,
},
/// Invalid process state transition.
#[error("invalid state transition for PID {pid}: {from} -> {to}")]
InvalidStateTransition {
/// The affected PID.
pid: u64,
/// Current state.
from: ProcessState,
/// Requested state.
to: ProcessState,
},
/// Process table has reached maximum capacity.
#[error("process table full (max: {max})")]
ProcessTableFull {
/// Maximum number of processes allowed.
max: u32,
},
/// Service-related error.
#[error("service error: {0}")]
Service(String),
/// Boot sequence error.
#[error("boot error: {0}")]
Boot(String),
/// IPC / messaging error.
#[error("ipc error: {0}")]
Ipc(String),
/// Kernel is in wrong state for requested operation.
#[error("kernel state error: expected {expected}, got {actual}")]
WrongState {
/// Expected state.
expected: String,
/// Actual state.
actual: String,
},
/// Capability check denied an action.
#[error("capability denied for PID {pid}: cannot {action} -- {reason}")]
CapabilityDenied {
/// The PID of the process that was denied.
pid: u64,
/// The action that was attempted.
action: String,
/// Why the action was denied.
reason: String,
},
/// Resource limit exceeded.
#[error("resource limit exceeded for PID {pid}: {resource} ({current} > {limit})")]
ResourceLimitExceeded {
/// The PID of the process.
pid: u64,
/// Name of the resource (memory, cpu_time, etc.).
resource: String,
/// Current usage value.
current: u64,
/// Configured limit.
limit: u64,
},
/// Agent spawn failed.
#[error("spawn failed for agent '{agent_id}': {reason}")]
SpawnFailed {
/// The agent that was being spawned.
agent_id: String,
/// Why the spawn failed.
reason: String,
},
/// Spawn backend not available (defined but not yet implemented).
#[error("backend not available: {backend} ({reason})")]
BackendNotAvailable {
/// The backend that was requested.
backend: String,
/// Why the backend is not available.
reason: String,
},
/// Operation timed out.
#[error("timeout: {operation} after {duration_ms}ms")]
Timeout {
/// Description of the operation that timed out.
operation: String,
/// How long we waited before timing out.
duration_ms: u64,
},
/// Configuration error.
#[error("config error: {0}")]
Config(String),
/// Disk quota exceeded (K1-G4).
#[cfg(feature = "os-patterns")]
#[error("disk quota exceeded for agent '{agent_id}': {current_bytes} > {limit_bytes} bytes")]
QuotaExceeded {
/// Agent that exceeded its quota.
agent_id: String,
/// Current disk usage.
current_bytes: u64,
/// Configured limit.
limit_bytes: u64,
},
/// Mesh networking error.
#[error("mesh error: {0}")]
Mesh(String),
/// Wraps a generic error from downstream crates.
#[error(transparent)]
Other(#[from] Box<dyn std::error::Error + Send + Sync>),
}
/// Convenience alias for kernel results.
pub type KernelResult<T> = Result<T, KernelError>;