a776744889
- Rust workspace with stemedb-core crate - Full .claude/ configuration (agents, skills, commands, guides) - ai-lookup/ for token-efficient fact storage - Quality gates: clippy, fmt, jscpd duplication detection - Pre-commit hook with 5-phase quality checks - CLAUDE.md router and CODING_GUIDELINES.md standards Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
63 lines
1.7 KiB
Markdown
63 lines
1.7 KiB
Markdown
# Error Handling Pattern
|
|
|
|
**Last Updated:** 2025-01-31
|
|
**Confidence:** High
|
|
|
|
## Summary
|
|
|
|
StemeDB uses `thiserror` for library errors with context chains. No panics in production code. All fallible operations return `Result<T, E>`.
|
|
|
|
**Key Facts:**
|
|
- Library code: `thiserror` for custom error types
|
|
- Binary code: `anyhow` for error chaining
|
|
- Never use `unwrap()`, `expect()`, `panic!()` in production
|
|
- Add context with `.context("what we were doing")?`
|
|
|
|
**File Pointer:** `crates/stemedb-core/src/error.rs` (planned)
|
|
|
|
## The Pattern
|
|
|
|
```rust
|
|
use thiserror::Error;
|
|
|
|
#[derive(Debug, Error)]
|
|
pub enum StemeError {
|
|
#[error("assertion not found: {0:?}")]
|
|
NotFound(Hash),
|
|
|
|
#[error("invalid signature for agent {agent:?}")]
|
|
InvalidSignature { agent: AgentId },
|
|
|
|
#[error("storage error: {0}")]
|
|
Storage(#[from] sled::Error),
|
|
|
|
#[error("serialization error: {0}")]
|
|
Serialization(String),
|
|
}
|
|
|
|
// Usage with context
|
|
fn load_assertion(&self, hash: &Hash) -> Result<Assertion, StemeError> {
|
|
let bytes = self.store
|
|
.get(hash.as_bytes())
|
|
.context("failed to read assertion from store")?
|
|
.ok_or(StemeError::NotFound(*hash))?;
|
|
|
|
rkyv::from_bytes(&bytes)
|
|
.map_err(|e| StemeError::Serialization(e.to_string()))
|
|
}
|
|
```
|
|
|
|
## Error Categories
|
|
|
|
| Type | Description | Example |
|
|
|------|-------------|---------|
|
|
| `NotFound` | Data doesn't exist | Missing assertion |
|
|
| `InvalidSignature` | Crypto verification failed | Tampered assertion |
|
|
| `Storage` | Underlying KV error | Disk full |
|
|
| `Serialization` | Encode/decode failed | Corrupt data |
|
|
|
|
## Related Topics
|
|
|
|
- [Rust Guidelines](../../.claude/guides/backend/rust-guidelines.md)
|
|
- [CODING_GUIDELINES.md](../../../CODING_GUIDELINES.md)
|