How sentomk/nekomata works
Nekomata is a C/C++ native hot-reload library: an application watches a reload group, receives a published object generation, prepares it away from the update path, then commits or rolls back entry-point changes at the caller’s safe point while preserving state. The repository also contains a browser/Wasm reload path, a PE backend, and an optional TUI. README documents the end-to-end behavior; source excerpts show selected orchestration and backend details, so unsampled subsystem links are omitted or marked unverified.
Main entry points: managed_worker.cpp Generation preparation · loader.cpp ELF object loader · native_session.cpp Native session · reload_transaction.cpp Reload transaction
Components 19
Reload runtime
- Session API
include/neko/session.hpp - Native session
src/runtime/native_session.cpp - Descriptor discovery
src/runtime/descriptor_discovery.cpp - Generation preparation
src/runtime/managed_worker.cpp - Generation stream
src/runtime/generation_stream.cpp - Reload transaction
src/runtime/reload_transaction.cpp
Generation protocol
- Generation publisher
src/runtime/publisher.cpp - Generation offer
src/protocol/generation_offer.cpp - Group descriptor
src/protocol/group_descriptor.cpp
Native backends
- ELF object loader
src/backends/elf/runtime/loader.cpp - Process symbols
src/backends/elf/runtime/process_symbols.hpp - ELF binary reader
src/backends/elf/format/binary_file.cpp - PE object loader
src/backends/pe/runtime/loader.cpp - PE image layout
src/backends/pe/format/image_layout.hpp
Browser backend
- Wasm session
src/backends/wasm/session.cpp - Offer poller
src/backends/wasm/offer_poller.hpp - Module candidate
src/backends/wasm/candidate.hpp
Monitoring
- TUI monitor
src/tui/monitor.cpp
Other components
- Application
Connections 21
- Application → Session API: watches and updates
- Session API → Native session: drives session
- Native session → Descriptor discovery: discovers descriptors
src/runtime/native_session.cpp - Native session → Generation preparation: prepares groups
- Generation preparation → Generation stream: polls generations
src/runtime/managed_worker.cpp - Generation preparation → Reload transaction: prepares reloads
- Application → Reload transaction: safe-point update
- Generation publisher → Generation offer: publishes generation
- Generation publisher → Group descriptor: serializes descriptors
- Generation offer → Generation stream: feeds generations
- Group descriptor → Descriptor discovery: configures groups
- Generation preparation → ELF object loader: loads objects
- ELF object loader → Process symbols: resolves symbols
src/backends/elf/runtime/loader.cpp - ELF binary reader → ELF object loader: parses object input
- Reload transaction → ELF object loader: activates prepared code
- Generation preparation → PE object loader: loads objects
- PE object loader → PE image layout: uses image layout
src/backends/pe/runtime/loader.cpp - Application → Wasm session: watches and updates
- Wasm session → Offer poller: creates pollers
src/backends/wasm/session.cpp - Offer poller → Module candidate: prepares candidates
src/backends/wasm/offer_poller.hpp - Application → TUI monitor: observes reload status