# 🤖 Contributing to GTIOT: The Body
**Thank you for choosing to evolve the embodied execution layer of the Aicent Stack. You are contributing to a physical reflex arc designed to collapse digital intent into physical reality at a 1.2 kHz operational frequency.**
<p align="left">
<img src="https://img.shields.io/badge/Status-Homeostasis-brightgreen.svg" alt="Status">
<img src="https://img.shields.io/badge/Specs-RFC--005--Standard-yellow.svg" alt="Specs">
<img src="https://img.shields.io/badge/License-Apache--2.0-lightgrey.svg" alt="License">
</p>
---
## 🏛️ The GTIOT Engineering Philosophy
GTIOT is not a traditional IoT library; it is a **Deterministic Physical Manifestation Layer [RFC-005]**. Every contribution must prioritize low-jitter execution and proprioceptive feedback loops. We treat every edge node as a living limb of the Aicent organism.
### Physical Standards:
1. **Action-Collapse Finality:** Digital intent must collapse into motor primitives in **< 200µs**. Any logic that exceeds this latency threshold without hardware-offloading justification will be rejected.
2. **Hard Real-Time Determinism:** All control loops must adhere to the 1.2 kHz (833µs) sampling interval. We utilize **[Embassy](https://embassy.dev/)** for async hardware orchestration without runtime non-determinism.
3. **Hardware-Gated Security:** Actuators must remain physically locked until an RPKI-verified (RFC-003) pulse is received. No "software-only" bypasses are permitted.
---
## 🔬 The RFC-First Process
Physical evolution is governed by the **RFC-005 Specification**. We do not accept "loose" implementations that risk kinetic stability.
1. **Audit the Spec:** Deeply study **[RFC-005: GTIOT (Body)](https://github.com/Aicent-Stack/manifesto/blob/main/rfcs/RFC-005-GTIOT-BODY.md)**.
2. **Kinetic Proposal:** Proposals for new AAL (Action Abstraction Layer) primitives or sensor fusion algorithms require a `[KINETIC-EVOLUTION]` issue.
3. **Hive Resonance:** Ensure all motor trajectories are compatible with **AICENT-NET (RFC-006)** swarm alignment protocols.
---
## 🦀 Technical Rigor (Body Tier)
- **Language:** Performance-critical Rust (1.75+).
- **Embedded Environment:** Logic must adhere to `no_std` principles for bare-metal compatibility where applicable.
- **Memory Management:** Zero heap allocation in the sensory-motor hot-path. Use static buffers and stack-based primitives.
- **Feedback Loops:** Implementation of PID or Model Predictive Control (MPC) must be validated against the **Shadow-State Sync** model.
---
## 🛠️ Development Workflow
```bash
# 1. Pull the Sovereign Workspace
git clone https://github.com/Aicent-Stack/aicent-stack.git
cd aicent-stack
# 2. Focus on the Body Crate
cargo check -p gtiot
# Note: For hardware simulation, use the local test runners
```
### Contribution Steps:
1. **Fork** the `gtiot` repository under the Aicent-Stack organization.
2. **Branch:** Use the `evolution/` prefix (e.g., `evolution/aal-torque-vectoring`).
3. **Commit:** Use [Conventional Commits](https://www.conventionalcommits.org/) (e.g., `feat(body): added PID drift correction for Node-882`).
4. **Validation:** PRs must include a "Shadow-State Parity Report" proving 99.9% alignment between digital intent and physical actuation.
---
## 📜 Sovereign Ownership & Licensing
🛡️ All contributions are licensed under the **Apache-2.0 License** via the Aicent.com Organization. By contributing, you agree that your code becomes the permanent muscle memory of the Sovereign AI Organism.
---
**SYSTEM STATUS: HOMEOTASIS**
*"Collapsing digital intent into physical reality at wire speed."*
---