🧬 I Built Memory That Dies If You Don't Use It (And You Should Too)

#programming #cpp #opensource #learning

*# 🧬 I Built Memory That Dies If You Don't Use It (And You Should Too)
*
What if your variables had expiration dates? What if they rotted away when you forgot about them? Welcome to LibOrganic — biodegradable memory for C++.

The Problem With Immortal Variables

You know that feeling when you're debugging at 3 AM and you find a variable that's been holding a stale value for the last 47 function calls? Or when you're building a game and your player's health never drains because you forgot to update it?

Traditional variables are immortal. They hold their value forever, until you explicitly change them. They don't care if you've touched them in the last hour, day, or year. They just... sit there.

But what if variables could decay? What if they had a time-to-live and started corrupting themselves when you neglected them?

That's exactly what I built: LibOrganic — a C++20 library that makes your memory mortal.

🎯 The Concept

LibOrganic wraps any type T in an Organic<T> container that:

⏱️ Has a time-to-live (TTL) in milliseconds
🦠 Decays when you don't access it for too long
🔄 Resets its timer when you touch it (via get())
🎨 Uses pluggable corruption strategies (drift, bit-flip, nullify, regen)
⏸️ Can be paused/resumed on demand

Think of it like:

🥛 Milk that spoils if you don't drink it
🔋 Batteries that drain when idle
🧠 Memories that fade without recall

💻 How It Works

Basic Usage

#include "Organic.h"

int main() {
    // Create a variable with 2 second lifetime
    auto health = Organic<int>::create(100, 2000);

    std::cout << health->get();  // 100 — access resets timer

    // Wait 3 seconds (not accessing it)
    std::this_thread::sleep_for(3s);

    std::cout << health->peek(); // 89 — it decayed! 🦠

    return 0;
}

The Magic Behind It

Under the hood, LibOrganic uses:

DecayManager — A singleton with a background thread (std::jthread) that checks every second if any Organic objects have expired
Strategy Pattern — Pluggable corruption algorithms:
- DriftStrategy — Gradually shifts values (±10%)
- BitFlipStrategy — Random bit corruption (chaos mode)
- NullifyStrategy — Resets to zero/default
- RegenStrategy — Increases value up to max (perfect for stamina/mana)
Smart Pointers — Uses weak_ptr to avoid circular dependencies and auto-cleanup

Architecture

User Code
    ↓
Organic<T> (wraps your value + tracks last access)
    ↓ (registers via weak_ptr)
DecayManager (background thread checks every 1s)
    ↓ (calls decay() if expired)
CorruptionStrategy (modifies the value)

🎮 Real-World Use Cases

1. Game Development

// Health that drains when idle
auto playerHealth = Organic<int>::create(100, 5000);
playerHealth->setStrategy(std::make_unique<DriftStrategy<int>>());

// Stamina that regenerates
auto stamina = Organic<int>::create(30, 2000);
stamina->setStrategy(std::make_unique<RegenStrategy<int>>(100, 0.2));

2. Security — Auto-Expiring Keys

// Encryption key that nullifies after 5 minutes
auto secretKey = Organic<std::string>::create("super-secret-key", 300000);
secretKey->setStrategy(std::make_unique<NullifyStrategy<std::string>>());

secretKey->onDecay([](const std::string& old, const std::string& now) {
    std::cout << "⚠️ Key expired! Clearing memory...\n";
});

3. Testing — Memory Corruption Simulation

// Simulate bit-flip errors
auto testData = Organic<uint32_t>::create(0xDEADBEEF, 1000);
testData->setStrategy(std::make_unique<BitFlipStrategy<uint32_t>>());

// Perfect for testing error handling!

4. Self-Invalidating Cache

// Cache entry that decays after 10 seconds
auto cachedResult = Organic<MyData>::create(computeExpensive(), 10000);
// If you don't access it, it corrupts and forces recomputation

🚀 Advanced Features

Callbacks

auto mana = Organic<int>::create(50, 1500);
mana->onDecay([](const int& old, const int& now) {
    std::cout << "Mana changed: " << old << " -> " << now << "\n";
    if (now < 10) {
        playLowManaSound();
    }
});

Pause/Resume

mana->pause();  // Freeze decay
// ... do something that takes time ...
mana->resume(); // Unfreeze (timer resets)

Peek vs Get

auto value = health->get();   // Reads AND resets timer
auto value = health->peek();  // Reads WITHOUT resetting timer
health->touch();              // Resets timer WITHOUT reading

🧪 Why I Built This

I was working on a game prototype and wanted health/stamina systems that felt more "organic" — values that naturally degraded over time unless you actively maintained them. I also wanted to experiment with C++20 features like std::jthread and modern memory management patterns.

The result? A library that's:

✅ Header-only (easy to integrate)
✅ Lock-free (uses atomics for performance)
✅ Type-safe (templates, baby!)
✅ Extensible (add your own strategies)

📦 Installation

Header-Only (Recommended)

Just copy the include/ folder:

#include "liborganic/Organic.h"

Build from Source

git clone https://github.com/alexandrusu1/LibOrganic.git
cd LibOrganic
mkdir build && cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
cmake --build . --parallel