# Changelog
All notable changes to this project will be documented in this file.
## [1.9.0] - 2026-01-25
### š¦ Sparse Snapshot Format - "Portable Memory"
Snapshot size reduced from 1.5GB to ~100 bytes for empty arenas.
### Changed
- **StrataArena Serialization**: Only non-empty engrams are serialized
- INVARIANT: `timestamp == 0` means "empty slot" (now part of ABI)
- Added `StrataArena::set_at()` and `restore_from_sparse()` for restoration
- **zstd Compression**: All strata data compressed with zstd level 3
- **Format v2**: New snapshot format with sparse representation
### Breaking
> [!WARNING]
> v1.9.0 snapshots are NOT backward compatible with v1.8.0.
> v1.9.0 CAN read v1.8.0 snapshots and auto-migrates on save.
### Technical
- 90/90 tests passing (+1 sparse size reduction test)
- Empty 10KĆ64 arena: 15MB ā ~100 bytes (>99.99% reduction)
---
## [1.8.0] - 2026-01-25
### š©¹ Crash Recovery - "Trauma-Aware Restart"
MindFry now remembers how it was shut down and adapts accordingly.
### Added
- **`recovery.rs`**: Trauma detection on startup
- `RecoveryState::Normal` ā Clean restart
- `RecoveryState::Shock` ā Unclean shutdown (no graceful marker)
- `RecoveryState::Coma` ā Prolonged downtime (>1 hour)
- **`RecoveryAnalyzer`**: Analyzes shutdown marker on startup
- **`ShutdownMarker`**: Persisted to sled before graceful exit
- **Warmup Enforcement**: Handler rejects ops during resurrection
- `Ping` and `Stats` always allowed (exempt)
- Other ops return `ErrorCode::WarmingUp`
- **Stability Benchmark**: 10 new benchmarks, all sub-microsecond
- `recovery_analyzer_analyze`: 1.21 ns
- `warmup_tracker_is_ready`: 1.19 ns
- `exhaustion_level_from_energy`: 715 ps
### Changed
- `CommandHandler` now accepts `WarmupTracker` via `with_warmup()`
- `AkashicStore` has `read_shutdown_marker()` / `write_shutdown_marker()`
### Technical
- 89/89 tests passing (+6 recovery tests)
- Server startup shows recovery state: `(clean)`, `(SHOCK detected)`, `(COMA detected)`
---
## [1.7.0] - 2026-01-24
### š”ļø Stability Layer - "Self-Healing Infrastructure"
Zero startup delay with async resurrection and progressive availability.
### Added
- **Stability Module** (`src/stability/`):
- `exhaustion.rs`: Circuit breaker with adaptive thresholds (Ī¼Ā±kĻ AutoTuner)
- `health.rs`: Self-diagnostic pulse monitoring
- `shutdown.rs`: Shutdown experience recording (graceful/forced/crash/coma)
- `warmup.rs`: Progressive availability tracking during resurrection
- **System Lineages** (`_system.*`): Reserved namespace for stability tracking
- `_system.health`, `_system.state`, `_system.shock`, `_system.coma`
- **Background Snapshot Loading**: Server accepts connections immediately
- Network binds in < 100ms
- Resurrection runs in async background thread
- **`ErrorCode::WarmingUp` (0x03)**: New error code for clients during resurrection
- **Exhaustion Backpressure**: Write rejection under high load
- **Graceful Shutdown**: Ctrl+C handling with pre-shutdown snapshot
### Technical
- 83/83 tests passing
- 1.5 GB snapshot: ~5.4s async load (verified)
---
## [1.6.0] - 2026-01-17
### š± Phase 5: Auto-Propagation - "Life Has Begun"
When `stimulate(A)` is called, energy automatically propagates through bonds.
### Added
- **SynapseEngine Integration**: Handler wires synapse.propagate() on stimulate
- **StimulateFlags**: Control propagation behavior
- `0x00` (default): Auto-propagate through bonds
- `0x01` `NO_PROPAGATE`: Surgical mode (direct update only)
- **The Domino Test**: AāBāC chain verification
- A: +0.9 (direct)
- B: +0.625 (hop 1, damped)
- C: +0.250 (hop 2, damped) ā
### Technical
- Used raw pointer trick to bypass RwLockWriteGuard borrow checker limitation
- SAFETY: bonds are read-only during propagate, psyche is mutated
---
## [1.5.0] - 2026-01-17
### ā ļø Breaking Change: Response Framing
`LINEAGE.GET` response now includes status header for unambiguous client parsing.
### Changed
- **Response Format**: `[status:u8] + [payload?]`
- `0x00` (Found): Full `LineageInfo` payload follows
- `0x01` (NotFound): No payload, lineage doesn't exist
- `0x02` (Repressed): No payload, hidden by Antagonism
- `0x03` (Dormant): No payload, in retention buffer
- **`ResponseData::Lineage`** ā **`ResponseData::LineageResult`**
- **`LineageResult`** struct: `{ status: LineageStatus, info: Option<LineageInfo> }`
### Why Breaking?
Previously, NotFound returned `Response::Error`. Now returns `Response::Ok(LineageResult { status: NotFound })`.
This enables richer client-side handling (distinguish "doesn't exist" from "hidden by system").
---
## [1.4.1] - 2026-01-17
### š Executive Override
User authority layer above cognitive filters for reliable data access.
### Added
- **`QueryFlags`**: Bitmask for access control
- `BYPASS_FILTERS` (0x01): Skip Cortex/Antagonism filters
- `INCLUDE_REPRESSED` (0x02): Reveal hidden data with REPRESSED status
- `NO_SIDE_EFFECTS` (0x04): Read without observer effect
- `FORENSIC` (0x07): All flags combined (god mode)
- **`LineageStatus`**: Rich result states
- `Found` (0): Normal success
- `NotFound` (1): Doesn't exist
- `Repressed` (2): Hidden by Antagonism
- `Dormant` (3): In retention buffer
- **Observer Effect**: `LINEAGE.GET` now stimulates memory on read (+0.01)
### Protocol
- `LINEAGE.GET` now accepts optional `flags:u8` (backward compat: default 0)
---
## [1.4.0] - 2026-01-17
### š§ Synaptic Evolution
Bonds now have polarity for biologically-inspired signal propagation.
### Added
- **`Bond.polarity`**: Ternary bond type (+1/0/-1)
- `Trit::True` (+1): Synergy (excitatory) - both stimulate
- `Trit::Unknown` (0): Neutral (insulator) - no propagation
- `Trit::False` (-1): Antagonism (inhibitory) - suppression
- **`SynapseEngine`**: Damped signal propagation
- Resistance: 0.5 (50% energy loss per hop)
- Cutoff: 0.1 (noise floor)
- Max depth: ~3 hops (mathematically bounded)
- Loop protection via visited set
### Internal
- 74/74 tests passing (+4 synapse tests)
- Backward compatible: old bonds default to `polarity: Trit::True`
---
## [1.3.0] - 2026-01-17
### š§¬ Cortex Persistence
Nabu's identity (mood, personality) now survives server restarts.
### Added
- **Serde derives**: `Trit`, `Octet`, `Quantizer`, `Cortex`, `RetentionBuffer` now serializable
- **`cortex_data` in Snapshot**: Optional Cortex state preserved in snapshots
- **Mood-Coupled Sensitivity**: Consciousness sensitivity now varies with mood (0.5x-1.5x)
- **`LineageIndexer`**: O(1) key-to-id lookup via sled tree
- `insert()`, `get()`, `remove()`, `rebuild()` methods
- Integrated into `AkashicStore` with `indexer()` accessor
- **Resurrection Protocol**: Server boot restores from latest snapshot
- `MindFry::resurrect()` - restore Cortex + Lineages + Bonds
- `MindFry::with_store()` - attach persistent storage
- Graceful degradation on corrupted snapshots
### Changed
- `take_snapshot()` now accepts optional `Cortex` parameter
- Base consciousness sensitivity reduced from 10.0 to 5.0 for mood modulation
### Internal
- 70/70 tests passing
- Backward compatible: old snapshots load with `cortex_data: None`
---
## [1.2.1] - 2026-01-17
### š§ Bug Fix: Consciousness Threshold Tuning
Fixed edge case where energy 0.95 with threshold 0.8 was classified as "Dreaming" instead of "Lucid".
### Added
- **`SysMoodSet` OpCode (0x46)**: External mood injection from NABU
- Payload: `[mood: f32]` (-1.0 to +1.0)
- Enables real-time emotional state control
### Fixed
- **Consciousness amplification**: Delta now multiplied by 10x for clearer Lucid/Dreaming/Dormant decisions
- `>3% above threshold` ā Lucid (+1)
- `<3% above threshold` ā Dreaming (0)
- `Below threshold` ā Dormant (-1)
### Internal
- 66/66 tests passing
- E2E verified: 0.95 energy ā LUCID
---
## [1.2.0] - 2026-01-17
### š§ NEW: Tri-Cortex Decision Engine (Setun Module)
Introduces balanced ternary logic primitives for organic decision-making.
### Added
- **`Trit` Primitive**: Balanced ternary digit (`-1 / 0 / +1`)
- Biological semantics: Inhibition / Latent / Excitation
- Operations: `consensus()` (AND), `invert()`, `weight()` (as i8)
- Full conversions: `From<i8>`, `From<bool>`
- **`Octet` Vector**: 8-dimensional personality/event vector
- Fixed dimensions: Curiosity, Preservation, Efficiency, Empathy, Rigidity, Volatility, Aggression, Latency
- `resonance(&other)` ā f64: Compatibility score (-1.0 to +1.0)
- `dissonance(&other)` ā f64: Conflict intensity (0.0 to 1.0)
- `pack() / unpack()`: 8-bit binary serialization
- **`Quantizer` Struct**: Analog-to-Trit converter
- Dynamic thresholds via `mood_modifier` (-1.0 to +1.0)
- Positive mood ā easier True; Negative mood ā easier True=harder
- `set_mood()` for external modulation (future NABU integration)
- **`Cortex` Struct**: The decision-making brain
- Encapsulates system personality (Octet DNA)
- Mood state with internal shift and external override
- `consciousness_state()`: Ternary consciousness evaluation (Lucid/Dreaming/Dormant)
- `decide()`: Mood-modulated analog-to-Trit conversion
- `evaluate()`: Event resonance calculation
- Integrated `RetentionBuffer` for safe garbage collection
- **`RetentionBuffer` Struct**: TTL-based data lifecycle management
- Prevents mass extinction by debouncing deletion decisions
- `mark_or_tick(id)`: Add to buffer or decrement TTL
- `restore(id)`: Remove from buffer (data recovered)
- Configurable TTL (default: 3 ticks)
- **`DecayEngine::process_gc()`**: Cortex-aware garbage collection
- Ternary viability assessment (Stable/Unstable/Obsolete)
- Personality-influenced preservation bias
- Safe deletion via RetentionBuffer TTL
### Fixed
- Clippy warnings in `psyche.rs`, `decay.rs`, `bond.rs`, `handler.rs`
### Internal
- 27 new unit tests (Trit, Octet, Quantizer, Cortex, RetentionBuffer, GC)
- 66/66 total tests passing
---
## [1.0.0] - 2026-01-17
### š¦ MAJOR: Rust Pivot
MindFry has been rewritten in Rust as a standalone Cognitive Database Engine.
### Added
- **Core Engine**
- `PsycheArena`: 32-byte cache-aligned Lineage storage with O(1) access
- `StrataArena`: Ring buffer Engram history per lineage
- `BondGraph`: Living bonds with Hebbian learning and decay
- `DecayEngine`: Pre-computed LUT (256Ć32) for O(1) decay calculation
- **MFBP Protocol v1.0**: Binary wire protocol (22 OpCodes)
- Lineage: `CREATE`, `GET`, `STIMULATE`, `FORGET`, `TOUCH`
- Bond: `CONNECT`, `REINFORCE`, `SEVER`, `NEIGHBORS`
- Query: `CONSCIOUS`, `TOP_K`, `TRAUMA`, `PATTERN`
- System: `PING`, `STATS`, `SNAPSHOT`, `RESTORE`, `FREEZE`, `PHYSICS_TUNE`
- Stream: `SUBSCRIBE`, `UNSUBSCRIBE`
- **Akashic Records**: sled-based persistence layer
- Snapshot/Restore with bincode serialization
- Named snapshots for Time Travel
- **TCP Server** (`mindfry-server`): Async Tokio server
- **CLI Client** (`mfcli`): Command-line interface for testing
- **Benchmarks**: Criterion benchmarks for decay and graph operations
- **CEREBRO Design Doc**: GUI visualization specification (commercial - separate repo)
### Changed
- **Technology**: TypeScript ā Rust
- **Architecture**: Library ā Database Engine
- **Structure**: Flattened repo (no more `mindfry-core/` subfolder)
- **Package**: Renamed `mindfry-core` ā `mindfry`
### Removed
- Legacy TypeScript implementation
### Technical Decisions
| Protocol | Custom TCP Binary (MFBP) |
| Persistence | sled (Rust-native) |
| Target | Dual (Server + WASM) |
| Integration | Network (TCP) |
---
## [0.3.0] - 2026-01-14 [Legacy TypeScript]
### Added
- **Morpheus** (God of Dreams): Background maintenance layer
- Event-hinted execution (not clock-driven)
- Self-managed queue (no external enqueue API)
- Atomic tasks: prune, transfer, consolidate (stub)
- **AkashicRecords**: Cold storage persistence
- `inscribe()`: Memory ā Archive
- `retrieve()`: Archive ā Memory (with accessScore decay)
- MemoryAkashicBackend for testing
- Shell layer stats in demo (Morpheus state, Akashic count, Pressure)
### Changed
- **Mind ā Psyche**: Main class renamed (backwards compat alias kept)
- Demo updated with mythological branding
## [0.2.1] - 2026-01-14 [Legacy TypeScript]
### Added
- **Decay Lookup Table**: Pre-computed exp() values (32 time buckets Ć 256 rates)
- **Epoch-bounded TopK Cache**: Only recomputes when state changes
- **Bond Density Cap**: Max 20 bonds per node
- **Performance metrics** in demo (JS Heap, Store Memory, Render Time)
### Changed
- `getEnergy()` now uses LUT instead of `Math.exp()`
- `topKConscious()` cached and invalidated on epoch change
- `createBond()` returns `null` if density cap exceeded
## [0.2.0] - 2026-01-14 [Legacy TypeScript]
### Added
- **Uint8Array Storage**: 4 bytes per memory (25x reduction)
- **Priming-based Auto-Association**: Automatic bonds on `remember()`
- **MemoryStore class**: Low-level typed array backend
### Changed
- Lazy decay model: energy computed on-demand
- `recall()` switched from async to sync iterator
- API: `remember(id, content, energy)` instead of object config
### Removed
- `tick()` method (no longer needed)
- Object-based Memory/Bond primitives
## [0.1.0] - 2026-01-14 [Legacy TypeScript]
### Added
- Initial implementation
- Memory/Bond primitives with object storage
- Mind core with conscious/subconscious layers
- Priming propagation
- Time skip demo