naeural-core 7.7.240__tar.gz → 7.7.242__tar.gz

{naeural_core-7.7.240 → naeural_core-7.7.242}/AGENTS.md

@@ -1,4 +1,5 @@
 # Repository Guidelines
+This file is "alive." When you discover horizontal insights during prompts (cross-cutting behavior, gotchas, performance hotspots, shared workflows), append a brief note at the end so future agents can reuse it. Keep entries short, dated, and specific.
 
 ## Project Structure & Module Organization
 `naeural_core/` houses the runtime: `main/` orchestrates startup, `business/` contains pipeline plugins and the testing harness, `comm/` handles transports, and `serving/` wraps model execution. Runtime artifacts land in `_local_cache/`, created on demand. Optional packages live under `extensions/`, docs under `docs/`, and hardware spikes stay in `xperimental/`. Use `start_nen.py` as the launcher when embedding the core into Edge Node deployments.
@@ -21,3 +22,12 @@ Follow the Conventional Commit voice observed in history (`feat:`, `fix:`, `chor
 
 ## Configuration & Security Notes
 Runtime configuration resolves from `config_startup.json`, `EE_CONFIG`, and `EE_ID`; keep secrets outside the repo and feed them through `.env`. Validate external payloads using the filters defined in `naeural_core.constants` when extending comms modules, and avoid embedding credential defaults inside plugin code.
+
+## Living Notes (append-only)
+Format:
+- `YYYY-MM-DD`: one-sentence insight (include file/path or subsystem if relevant).
+
+Latest:
+- `2026-02-02`: Initialized living notes; append new cross-cutting insights here.
+- `2026-02-02`: Comms send/recv queues are bounded deques (1000); when MQTT is down, one message is popped and retried while queues fill/drop, and the main loop will shut down once retries exceed `CONN_MAX_RETRY_ITERS` unless bypassed (see `naeural_core/comm` + `naeural_core/main/orchestrator.py`).
+- `2026-02-02`: Correction: comm send loops pop from `_send_buff` even when disconnected, so messages may be dropped while offline; buffering is best-effort (see `naeural_core/comm/mixins`).

{naeural_core-7.7.240 → naeural_core-7.7.242}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: naeural_core
-Version: 7.7.240
+Version: 7.7.242
 Summary: Ratio1 Core is the backbone of the Ratio1 Edge Protocol.
 Project-URL: Homepage, https://github.com/Ratio1/naeural_core
 Project-URL: Bug Tracker, https://github.com/Ratio1/naeural_core/issues

{naeural_core-7.7.240 → naeural_core-7.7.242}/naeural_core/comm/communication_manager.py

@@ -74,13 +74,18 @@ class CommunicationManager(Manager, _ConfigHandlerMixin):
     _id = self.log.config_data.get(ct.CONFIG_STARTUP_v2.K_EE_ID, '')[:ct.EE_ALIAS_MAX_SIZE]
     return _id  
 
+  def _has_failed_comms(self):
+    for comm in self._dct_comm_plugins.values():
+      if comm.comm_failed_after_retries:
+        return comm
+    return None
 
   @property
   def has_failed_comms(self):
-    for comm in self._dct_comm_plugins.values():
-      if comm.comm_failed_after_retries:
-        self.P("Detected total communication failure on comm {}. This may generate shutdown/restart.".format(comm.__class__.__name__), color='error')
-        return True
+    comm = self._has_failed_comms()
+    if comm is not None:
+      self.P("Detected total communication failure on comm {}. This may generate shutdown/restart.".format(comm.__class__.__name__), color='error')
+      return True
     return False  
 
 

{naeural_core-7.7.240 → naeural_core-7.7.242}/naeural_core/comm/mixins/default_comm_mixin.py

@@ -80,4 +80,3 @@ class _DefaultCommMixin(object):
     self.P('`run_thread` finished')
     self._thread_stopped = True
     return
-

{naeural_core-7.7.240 → naeural_core-7.7.242}/naeural_core/main/orchestrator.py

@@ -121,6 +121,7 @@ class Orchestrator(DecentrAIObject,
     self._current_dct_config_streams = {}
     self._should_send_initial_log = False
     self._initial_log_sent = False
+    self._last_offline_log = 0
     self.loop_timings = deque(maxlen=3600)
     self._reset_timers = False
     self.__is_mlstop_dangerous = False
@@ -709,6 +710,10 @@ class Orchestrator(DecentrAIObject,
   def cfg_main_loop_resolution(self):
     return self.config_data.get('MAIN_LOOP_RESOLUTION', 20)
 
+  @property
+  def cfg_work_offline(self):
+    return self.config_data.get('WORK_OFFLINE', False)
+
   @property
   def cfg_sequential_streams(self):
     """
@@ -1613,6 +1618,27 @@ class Orchestrator(DecentrAIObject,
     self._comm_manager.maybe_show_info()    
     return
 
+  def _maybe_log_offline_status(self):
+    if not self.cfg_work_offline or self._comm_manager is None or not self._comm_manager._has_failed_comms():
+      return
+    now = time()
+    if (now - self._last_offline_log) < ct.COMMS.COMM_SECS_SHOW_INFO:
+      return
+    self._last_offline_log = now
+
+    comm_attempts = [
+      "{}:try={} fails={}".format(
+        name,
+        getattr(comm, "_nr_conn_retry_iters", None),
+        getattr(comm, "_total_conn_fails", None),
+      )
+      for name, comm in self._comm_manager._dct_comm_plugins.items()
+      if comm is not None
+    ]
+    attempts_str = "; ".join(comm_attempts) if len(comm_attempts) > 0 else "no comm plugins"
+    self.P(f"WORK_OFFLINE enabled; reconnect attempts: {attempts_str}", color='r')
+    return
+
   def _save_exception_main_loop_state(self, txt, **save_kwargs):
     fn = '{}_main_loop_exception'.format(self.log.now_str())
     self.log.save_pickle_to_output(data=save_kwargs, fn=fn + '.pickle', subfolder_path='main_loop_exceptions')
@@ -1829,6 +1855,7 @@ class Orchestrator(DecentrAIObject,
         #9. Comm info, timers, ... - later we gonna check for total comm failures
         self.__loop_stage = '9.logs'
         self.comm_manager_show_info()
+        self._maybe_log_offline_status()
 
 
         self.log.stop_timer(self._main_loop_timer_name)
@@ -1844,7 +1871,7 @@ class Orchestrator(DecentrAIObject,
         return_code = self._return_code
 
         self.__loop_stage = '10.checks'
-        if self.comm_manager.has_failed_comms:
+        if (not self.cfg_work_offline) and self.comm_manager.has_failed_comms:
           self.P("Shutdown initiated due to multiple failure in communication!", color='r')
           return_code = ct.CODE_EXCEPTION
 

{naeural_core-7.7.240 → naeural_core-7.7.242}/naeural_core/main/ver.py

@@ -1,4 +1,4 @@
-__VER__ = '7.7.240'
+__VER__ = '7.7.242'
 
 
 

{naeural_core-7.7.240 → naeural_core-7.7.242}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "naeural_core"
-version = "7.7.240"
+version = "7.7.242"
 authors = [
   { name="Andrei Ionut Damian", email="andrei.damian@me.com" },
   { name="Cristan Bleotiu", email="cristibleotiu@gmail.com" },