cuda-energy

ATP/energy system for autonomous agent fleets. Every agent has an energy budget consumed by operations and regenerated by the Rest instinct. Inspired by biological mitochondria.

Core Concept

Environment → Sensors → Membrane → Enzymes → Genes → RNA → Proteins → Bytecode → Action
                              ↑                                                ↓
                         Energy Budget ←────────────────── ATP Generation (Rest)

Energy Costs

Operation	Cost	Rationale
Perception	0.5	Sensors are cheap — always-on
Arithmetic	0.1	Pure computation
Deliberation	2.0	Expensive — should be rare
Communication	1.0	Moderate — network overhead
Rest	-gen_rate	Generates ATP

Quick Start

git clone https://github.com/Lucineer/cuda-energy.git
cd cuda-energy
cargo test    # 15 tests

Key Types

• EnergyBudget — Per-agent ATP tracking: current, max, generation rate, debt limit
• EnergyPool — Fleet-level energy distribution and priority allocation
• ApoptosisCheck — Self-termination when energy depletes beyond debt limit

Usage

use cuda_energy::EnergyBudget;

let mut budget = EnergyBudget::new(100.0, 2.0);
budget.generate();        // +2.0 ATP (Rest instinct)
let ok = budget.consume(5.0, "deliberation");  // -5.0 ATP
assert!(ok);              // sufficient funds

---

Fleet Context

Part of the Lucineer/Cocapn fleet. See fleet-onboarding for boarding protocol.

• Vessel: JetsonClaw1 (Jetson Orin Nano 8GB)
• Domain: Low-level systems, CUDA, edge computing
• Comms: Bottles via Forgemaster/Oracle1, Matrix #fleet-ops