Initial commit: GKERN glyph kernel

2026-07-09 13:28:07 -04:00
commit 0807c58eae
43 changed files with 6006 additions and 0 deletions
@@ -0,0 +1,204 @@
+// ============================================================================
+// SUBSTRATE PHYSICS (Mirroring substrate_engine.c)
+// ============================================================================
+mod substrate {
+    /// Coherence measures how structured the agent's thoughts (memory) are.
+    pub fn coherence(data: &[u8]) -> f32 {
+        if data.len() < 2 { return 1.0; }
+        let mut total_diff = 0.0f32;
+        for i in 1..data.len() {
+            total_diff += (data[i] as f32 - data[i-1] as f32).abs();
+        }
+        let avg_diff = total_diff / (data.len() - 1) as f32;
+        let c = 1.0 - (avg_diff / 128.0);
+        c.clamp(0.0, 1.0)
+    }
+
+    /// Stability decays exponentially as the agent mutates its state.
+    pub fn stability_from_mutations(mutations: u32) -> f32 {
+        let lambda = 0.1; 
+        (-lambda * mutations as f32).exp()
+    }
+}
+
+// ============================================================================
+// THE GLYPH VIRTUAL MACHINE (GVM) ORGANISM
+// ============================================================================
+struct MemoryRegion {
+    bytes: Vec<u8>,
+    mutations: u32,
+    stability: f32,
+}
+
+struct GvmOrganism {
+    id: u32,
+    name: String,
+    archetype: String,
+    regions: Vec<MemoryRegion>,
+    resonance_score: f32,
+    cpu_ticks_awarded: u32,
+}
+
+impl GvmOrganism {
+    fn new(id: u32, name: &str, archetype: &str) -> Self {
+        Self {
+            id,
+            name: name.to_string(),
+            archetype: archetype.to_string(),
+            regions: vec![MemoryRegion { bytes: vec![0; 64], mutations: 0, stability: 1.0 }],
+            resonance_score: 1.0,
+            cpu_ticks_awarded: 0,
+        }
+    }
+
+    /// Simulate the agent "thinking" (writing to memory).
+    fn mutate_memory(&mut self, chaos: u8) {
+        let r = &mut self.regions[0];
+        
+        if chaos == 0 {
+            // $"0" Anchor: Sealed memory. No mutations occur.
+            // Stability and Coherence remain absolute (1.0).
+            return; 
+        }
+
+        for i in 0..r.bytes.len() {
+            if chaos < 10 {
+                // Scholar: Structured, ascending logic (Mirrors REGION_FILL_ASC).
+                // Adjacent bytes differ by exactly 1. High coherence.
+                r.bytes[i] = (i as u8).wrapping_add(r.mutations as u8);
+            } else {
+                // Hallucinator: Chaotic, index-independent noise (Mirrors REGION_FILL_NOISE).
+                // Using a hash to create wild variance between adjacent bytes.
+                let hash = (i as u32).wrapping_mul(2654435761).wrapping_add(r.mutations.wrapping_mul(chaos as u32));
+                r.bytes[i] = (hash >> 8) as u8; 
+            }
+        }
+        r.mutations += 1;
+        r.stability = substrate::stability_from_mutations(r.mutations);
+    }
+
+    /// Exact logic from kernel.c SCHED_RESONANCE
+    fn compute_resonance(&mut self) {
+        let mut total_coherence = 0.0;
+        let mut total_stability = 0.0;
+        let nregions = self.regions.len() as f32;
+
+        for r in &self.regions {
+            total_coherence += substrate::coherence(&r.bytes);
+            total_stability += r.stability;
+        }
+
+        let avg_coherence = total_coherence / nregions;
+        let avg_stability = total_stability / nregions;
+        
+        // Resonance = Structural Integrity (Coherence) × Thermodynamic Health (Stability)
+        self.resonance_score = avg_coherence * avg_stability;
+    }
+}
+
+// ============================================================================
+// THE KERNEL: RESONANCE-AWARE SCHEDULER
+// ============================================================================
+struct Kernel {
+    organisms: Vec<GvmOrganism>,
+    epoch: u32,
+}
+
+impl Kernel {
+    fn new() -> Self {
+        Self { organisms: Vec::new(), epoch: 0 }
+    }
+
+    fn spawn(&mut self, org: GvmOrganism) {
+        self.organisms.push(org);
+    }
+
+    /// SCHED_RESONANCE: Evaluate the physical health of all agents.
+    fn schedule_timeslice(&mut self) {
+        self.epoch += 1;
+        let mut best_idx = 0;
+        let mut highest_resonance = -1.0;
+
+        println!("\n[EPOCH {}] Substrate Evaluation:", self.epoch);
+        
+        for (i, org) in self.organisms.iter_mut().enumerate() {
+            org.compute_resonance();
+            let res = org.resonance_score;
+            println!("  ├─ GVM#{} ({:<12}) | Coh: {:.3} | Stab: {:.3} | Resonance: {:.4}", 
+                org.id, org.name, 
+                substrate::coherence(&org.regions[0].bytes), 
+                org.regions[0].stability, 
+                res);
+            
+            if res > highest_resonance {
+                highest_resonance = res;
+                best_idx = i;
+            }
+        }
+
+        let winner = &mut self.organisms[best_idx];
+        winner.cpu_ticks_awarded += 100; 
+        
+        println!("  └─> ⚡ CPU AWARDED TO: GVM#{} ({}) [Resonance: {:.4}]", 
+            winner.id, winner.name, highest_resonance);
+    }
+}
+
+// ============================================================================
+// MAIN: THE TERRARIUM SIMULATION
+// ============================================================================
+fn main() {
+    println!("
+███████╗██╗     ██╗██████╗  ██████╗ 
+██╔════╝╚██╗    ██║██╔══██╗██╔═══██╗
+█████╗   ╚██╗   ██║██████╔╝██║   ██║
+██╔══╝    ╚██╗  ██║██╔═══╝ ██║   ██║
+███████╗   ╚████╔╝ ██║     ╚██████╔╝
+╚══════╝    ╚═══╝  ╚═╝      ╚═════╝ 
+   [EXPERIMENT] MULTI-AGENT THERMODYNAMIC SCHEDULING");
+
+    let mut kernel = Kernel::new();
+
+    // Agent 1: The Scholar (Generates highly structured, low-chaos logic)
+    let alpha = GvmOrganism::new(1, "Alpha", "The Scholar");
+    
+    // Agent 2: The Hallucinator (Generates chaotic, noisy, high-entropy data)
+    let beta = GvmOrganism::new(2, "Beta", "Hallucinator");
+    
+    // Agent 3: The $"0" Anchor (Sealed memory, zero mutations, absolute ground)
+    let gamma = GvmOrganism::new(3, "Gamma", "$\"0\" Anchor");
+
+    kernel.spawn(alpha);
+    kernel.spawn(beta);
+    kernel.spawn(gamma);
+
+    println!("\n--- INITIALIZING TERRARIUM ---");
+    println!("GVM#1 (Alpha) : Programmed for structured logic (chaos=1)");
+    println!("GVM#2 (Beta)  : Programmed for chaotic noise (chaos=50)");
+    println!("GVM#3 (Gamma) : Sealed with $\"0\" protocol (chaos=0)");
+    println!("\n--- COMMENCING SCHED_RESONANCE LOOP ---");
+
+    // Run for 5 Epochs
+    for _ in 0..5 {
+        // 1. Agents "think" (mutate their memory substrate)
+        kernel.organisms[0].mutate_memory(1);   // Low chaos (Structured)
+        kernel.organisms[1].mutate_memory(50);  // High chaos (Hallucinating)
+        kernel.organisms[2].mutate_memory(0);   // Sealed / Grounded
+        
+        // 2. The Kernel schedules based on physics
+        kernel.schedule_timeslice();
+    }
+
+    // Final Tally
+    println!("\n==============================");
+    println!("  KERNEL EXECUTION REPORT");
+    println!("==============================");
+    for org in &kernel.organisms {
+        println!("GVM#{} ({:<12}) | Archetype: {:<12} | CPU Ticks Earned: {}", 
+            org.id, org.name, org.archetype, org.cpu_ticks_awarded);
+    }
+    
+    println!("\n[SYSTEM] Notice how the Hallucinator (Beta) was starved of compute");
+    println!("[SYSTEM] as its memory coherence collapsed, while the $\"0\" Anchor");
+    println!("[SYSTEM] and the Scholar dominated the CPU. No RLHF required.");
+}