punkgo_core/lib.rs
1//! Core types and protocol definitions for the PunkGo kernel.
2//!
3//! This crate defines the foundational primitives of the PunkGo system:
4//!
5//! - [`action`] — Action types (`observe`, `create`, `mutate`, `execute`) and cost quoting
6//! - [`actor`] — Actor model: `Human` (unconditional) and `Agent` (conditional), with lineage
7//! - [`boundary`] — Writable-target enforcement via glob patterns (PIP-001 §8–§10)
8//! - [`consent`] — Authorization envelopes with budget, checkpoint levels, and lifecycle (PIP-001 §11)
9//! - [`stellar`] — Energy production config anchored to hardware INT8 TOPS (PIP-001 §1)
10//! - [`protocol`] — IPC request/response envelope format
11//! - [`policy`] — Action validation and visibility rules
12//! - [`errors`] — Unified kernel error types
13//!
14//! All types in this crate are serializable and form the shared vocabulary between
15//! the kernel runtime, state persistence, and CLI client.
16
17/// Kernel version, inherited from workspace Cargo.toml.
18pub const VERSION: &str = env!("CARGO_PKG_VERSION");
19
20pub mod action;
21pub mod actor;
22pub mod boundary;
23pub mod consent;
24pub mod errors;
25pub mod policy;
26pub mod protocol;
27pub mod stellar;