dual-loop-controller 2.5.0__tar.gz → 3.0.0__tar.gz

{dual_loop_controller-2.5.0/dual_loop_controller.egg-info → dual_loop_controller-3.0.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: dual-loop-controller
-Version: 2.5.0
-Summary: A hardware-aligned, manifold-preserving latent deliberation & bidirectional multimodal framework for Transformers
+Version: 3.0.0
+Summary: A unified cognitive operating system with model-agnostic canonical adapters, sleep-phase consolidation, and prefrontal invariant firewalls for Transformers
 Author: Ch3nOff
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/Ch3nOff/dual-loop-controller
@@ -34,8 +34,8 @@ Dynamic: license-file
   English | <a href="https://github.com/Ch3nOff/dual-loop-controller/blob/main/docs/README_id.md">Bahasa Indonesia</a> | <a href="https://github.com/Ch3nOff/dual-loop-controller/blob/main/docs/README_zh.md">简体中文</a> | <a href="https://github.com/Ch3nOff/dual-loop-controller/blob/main/docs/README_ja.md">日本語</a> | <a href="https://github.com/Ch3nOff/dual-loop-controller/blob/main/docs/README_ko.md">한국어</a> | <a href="https://github.com/Ch3nOff/dual-loop-controller/blob/main/docs/README_es.md">Español</a> | <a href="https://github.com/Ch3nOff/dual-loop-controller/blob/main/docs/README_fr.md">Français</a> | <a href="https://github.com/Ch3nOff/dual-loop-controller/blob/main/docs/README_de.md">Deutsch</a> | <a href="https://github.com/Ch3nOff/dual-loop-controller/blob/main/docs/README_ru.md">Русский</a> | <a href="https://github.com/Ch3nOff/dual-loop-controller/blob/main/docs/README_ar.md">العربية</a>
 </p>
 
-<h1 align="center">Dual-Loop Cognitive Controller (v2.5.0)</h1>
-<h3 align="center">Hardware-Aligned Autopoietic Latent Deliberation, Curiosity-Driven Active Exploration & Bidirectional Multimodal Plasticity</h3>
+<h1 align="center">Dual-Loop Cognitive Controller (v3.0.0)</h1>
+<h3 align="center">Unified Cognitive OS: Model-Agnostic Canonical Projection, Sleep-Phase Consolidation & Prefrontal Invariant Firewalls</h3>
 
 <p align="center">
   <a href="https://pypi.org/project/dual-loop-controller/"><img src="https://img.shields.io/pypi/v/dual-loop-controller.svg?color=blue" alt="PyPI version"></a>
@@ -50,15 +50,12 @@ Dynamic: license-file
 
 ## Overview
 
-**Dual-Loop Cognitive Controller (HADL v2.5.0)** is a universal framework that equips standard autoregressive Transformers with hardware-aligned, dual-process System 1 (fast, intuitive) and System 2 (deliberative) cognitive capabilities, plus native bidirectional multimodal synthesis without token overhead or KV-cache explosion.
-
-### What's New in v2.5.0:
-* **Bidirectional Hetero-Associative Plasticity ($M_{cross}$ & $M_{cross}^T$)**: Native two-way translation between text and sensory (photo/audio) latents. Performs **1-Shot In-situ Hebbian Binding** in fast weights ($<0.05\text{ ms}$) and **Text $\to$ Sensory Mental Imagery in $1.4\text{ ms}$** without external diffusion models!
-* **Universal Procrustes Manifold Transport**: Closed-form affine optimal transport that aligns out-of-distribution visual/audio covariances into the text tangent space ($\mathcal{O}(D)$ algebra, $<0.1\text{ ms}$).
-* **Spatio-Temporal Entropic CWM**: Compresses 256 visual patches or 128 audio frames into 16 topological working memory slots (93.8% KV-cache reduction), preventing Token Explosion.
-* **Allostatic Energy Modulation**: Unified scalar energy potential $\Gamma_{allostatic} \in [0.40, 0.95]$ guaranteeing **sub-5ms fast-path execution** (streaming bypass: **7.8 $\mu$s**).
-* **Autonomous Curiosity Daemon Loop**: Background contemplation during idle intervals with Popperian self-play and orthogonal nullspace memory consolidation.
-* **100% Frozen Backbone**: Zero base weight gradient updates. Seamlessly hooks into Qwen, LLaMA, Mistral, and GLM-4.
+**Dual-Loop Cognitive Controller (HADL v3.0.0 Unified Cognitive OS)** is an open-source, model-agnostic cognitive framework that upgrades ANY autoregressive Transformer into an autonomous dual-process system with 5 Computational Brain Organs:
+1. **Universal Model-Agnostic Adapter**: Dynamic Runtime Graph Introspection (`DynamicGraphIntrospector`) discovers layer containers and hooks automatically across Qwen, LLaMA, Mistral, Gemma, GLM-4, and custom architectures. Standardizes latent deliberation onto a **Canonical Manifold** ($\mathbb{R}^{D_{native}} \to \mathbb{R}^{1024} \to \mathbb{R}^{D_{native}}$) with strict mathematical ReZero Identity Preservation ($\Delta_{init} \equiv 0$).
+2. **vLLM & TensorRT High-Throughput Ready**: Pure branchless tensor arithmetic with 100% CUDA-Graph safety, zero Python runtime branches in the hot-path, and native support for both 3D $[B, S, D]$ and 2D $[N, D_{native}]$ flat batch tensor formats.
+3. **Sleep-Phase Consolidation Engine (Organ 4)**: Offline memory replay translating waking Hebbian fast weights ($M_{fast}$) into permanent LoRA parameters via truncated SVD low-rank distillation and QR nullspace orthogonalization ($0.000000$ knowledge interference leakage).
+4. **Sheaf-Theoretic Invariant Firewall (Organ 5)**: Sub-0.05ms prefrontal executive inhibition computing cohomological obstructions to clamp explosive gradients, suppress Dirichlet vacuous hallucinations, and prevent instruction corruption.
+5. **Bidirectional Multimodal Plasticity**: Native two-way translation between text and sensory (photo/audio) latents with 1-shot in-situ Hebbian binding.
 
 ---
 
@@ -142,6 +139,9 @@ hadl validate-benchmark eval_results
 
 # Execute single autonomous background contemplation cycle
 hadl daemon-step --slots 6 --d-model 128
+
+# Execute offline sleep-phase consolidation replay and SVD distillation
+hadl sleep-cycle --episodes 10 --rank 16
 ```
 
 ---

{dual_loop_controller-2.5.0 → dual_loop_controller-3.0.0}/README.md

@@ -2,8 +2,8 @@
   English | <a href="docs/README_id.md">Bahasa Indonesia</a> | <a href="https://github.com/Ch3nOff/dual-loop-controller/blob/main/docs/README_zh.md">简体中文</a> | <a href="https://github.com/Ch3nOff/dual-loop-controller/blob/main/docs/README_ja.md">日本語</a> | <a href="https://github.com/Ch3nOff/dual-loop-controller/blob/main/docs/README_ko.md">한국어</a> | <a href="https://github.com/Ch3nOff/dual-loop-controller/blob/main/docs/README_es.md">Español</a> | <a href="https://github.com/Ch3nOff/dual-loop-controller/blob/main/docs/README_fr.md">Français</a> | <a href="https://github.com/Ch3nOff/dual-loop-controller/blob/main/docs/README_de.md">Deutsch</a> | <a href="https://github.com/Ch3nOff/dual-loop-controller/blob/main/docs/README_ru.md">Русский</a> | <a href="https://github.com/Ch3nOff/dual-loop-controller/blob/main/docs/README_ar.md">العربية</a>
 </p>
 
-<h1 align="center">Dual-Loop Cognitive Controller (HADL v2.5.0)</h1>
-<h3 align="center">Hardware-Aligned Autopoietic Latent Deliberation, Curiosity-Driven Active Exploration & Bidirectional Multimodal Plasticity</h3>
+<h1 align="center">Dual-Loop Cognitive Controller (HADL v3.0.0)</h1>
+<h3 align="center">Unified Cognitive OS: Model-Agnostic Canonical Projection, Sleep-Phase Consolidation & Prefrontal Invariant Firewalls</h3>
 
 <p align="center">
   <a href="https://pypi.org/project/dual-loop-controller/"><img src="https://img.shields.io/pypi/v/dual-loop-controller.svg?color=blue" alt="PyPI version"></a>
@@ -12,7 +12,7 @@
   <a href="https://huggingface.co/spaces/CH3NDev/dual-loop-controller-demo"><img src="https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Spaces%20Live%20Demo-blue.svg" alt="Hugging Face Spaces"></a>
   <a href="https://huggingface.co/CH3NDev/dual-loop-qwen3.5-2b"><img src="https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Adapter%20Weights-yellow.svg" alt="Hugging Face"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green.svg" alt="License"></a>
-  <a href="tests/"><img src="https://img.shields.io/badge/tests-109%20passed%20(100%25)-brightgreen.svg" alt="Unit Tests"></a>
+  <a href="tests/"><img src="https://img.shields.io/badge/tests-134%20passed%20(100%25)-brightgreen.svg" alt="Unit Tests"></a>
   <a href="#fast-path-inference"><img src="https://img.shields.io/badge/streaming%20bypass-0.0078%20ms%20(sub--5ms)-blueviolet.svg" alt="Sub-5ms Latency"></a>
   <a href="#orthogonal-nullspace-projection"><img src="https://img.shields.io/badge/nullspace%20overlap-0.000000%20(zero%20interference)-success.svg" alt="Zero Overlap"></a>
 </p>
@@ -21,11 +21,14 @@
 
 ---
 
-## 🏛️ System Architecture v2.4.0: The Autopoietic Dual-Process Engine
+## 🏛️ System Architecture v3.0.0: The Unified Cognitive OS
 
-In **v2.4.0**, the Dual-Loop Cognitive Controller resolves two long-standing challenges in artificial reasoning:
-1. **The Clock Coupling Bottleneck**: Conventional LLMs are passive autoregressive engines $P(Y \mid X)$ that only compute when user prompts arrive. HADL decouples inference from the user clock via an **Autonomous Background Curiosity Daemon** that actively inspects memory, detects contradictions, and refines hypotheses during idle intervals.
-2. **Gate Cascade Collapse & Signal Vanishing**: Naive multiplicative cascades ($g_1 \cdot g_2 \dots g_5$) exponentially suppress latent deltas to near zero ($<0.15$). v2.4.0 introduces **Consolidated Allostatic Energy Modulation**, evaluating homeostasis, surprise, vacuity, and drift in a unified energy-logit potential ($\Gamma_{allostatic} \in [0.40, 0.95]$), ensuring continuous non-zero gradients and guaranteeing **sub-5ms fast-path execution** (streaming bypass: **0.0078 ms / 7.8 $\mu$s**).
+In **v3.0.0**, the Dual-Loop Cognitive Controller transitions into a **Unified Cognitive Operating System** resolving structural bottlenecks across LLMs and VLMs via 5 Computational Brain Organs:
+1. **Dynamic Runtime Graph Introspection (`DynamicGraphIntrospector`) & Canonical Projection**: Unifies all model families (Qwen, LLaMA, Mistral, Gemma, GLM-4) by mapping native representations into a standardized canonical deliberation space $\mathbb{R}^{D_{native}} \to \mathbb{R}^{1024} \to \mathbb{R}^{D_{native}}$ with strict ReZero Identity Preservation ($\Delta_{init} \equiv 0$).
+2. **vLLM & TensorRT Inference Compatibility**: Pure branchless tensor arithmetic with 100% CUDA-Graph safety, zero dynamic Python dispatch, and native support for 2D $[N, D_{native}]$ flat tensors.
+3. **Sleep-Phase Consolidation Engine (Organ 4)**: Offline replay translating waking Hebbian fast weights ($M_{fast}$) into permanent LoRA parameters via truncated SVD low-rank distillation and QR nullspace orthogonalization ($0.000000$ interference leakage).
+4. **Sheaf-Theoretic Invariant Firewall (Organ 5)**: Sub-0.05ms prefrontal executive inhibition enforcing topological invariants against norm explosions, epistemic vacuity, and instruction corruption.
+5. **Bidirectional Multimodal Plasticity**: Native two-way translation between text and sensory (photo/audio) latents with 1-shot in-situ Hebbian binding.
 
 ![Dual-Loop v2.4.0 Complete Architecture Diagram](hadl_v24_system_architecture.png)
 

{dual_loop_controller-2.5.0 → dual_loop_controller-3.0.0}/README_PYPI.md

@@ -2,8 +2,8 @@
   English | <a href="https://github.com/Ch3nOff/dual-loop-controller/blob/main/docs/README_id.md">Bahasa Indonesia</a> | <a href="https://github.com/Ch3nOff/dual-loop-controller/blob/main/docs/README_zh.md">简体中文</a> | <a href="https://github.com/Ch3nOff/dual-loop-controller/blob/main/docs/README_ja.md">日本語</a> | <a href="https://github.com/Ch3nOff/dual-loop-controller/blob/main/docs/README_ko.md">한국어</a> | <a href="https://github.com/Ch3nOff/dual-loop-controller/blob/main/docs/README_es.md">Español</a> | <a href="https://github.com/Ch3nOff/dual-loop-controller/blob/main/docs/README_fr.md">Français</a> | <a href="https://github.com/Ch3nOff/dual-loop-controller/blob/main/docs/README_de.md">Deutsch</a> | <a href="https://github.com/Ch3nOff/dual-loop-controller/blob/main/docs/README_ru.md">Русский</a> | <a href="https://github.com/Ch3nOff/dual-loop-controller/blob/main/docs/README_ar.md">العربية</a>
 </p>
 
-<h1 align="center">Dual-Loop Cognitive Controller (v2.5.0)</h1>
-<h3 align="center">Hardware-Aligned Autopoietic Latent Deliberation, Curiosity-Driven Active Exploration & Bidirectional Multimodal Plasticity</h3>
+<h1 align="center">Dual-Loop Cognitive Controller (v3.0.0)</h1>
+<h3 align="center">Unified Cognitive OS: Model-Agnostic Canonical Projection, Sleep-Phase Consolidation & Prefrontal Invariant Firewalls</h3>
 
 <p align="center">
   <a href="https://pypi.org/project/dual-loop-controller/"><img src="https://img.shields.io/pypi/v/dual-loop-controller.svg?color=blue" alt="PyPI version"></a>
@@ -18,15 +18,12 @@
 
 ## Overview
 
-**Dual-Loop Cognitive Controller (HADL v2.5.0)** is a universal framework that equips standard autoregressive Transformers with hardware-aligned, dual-process System 1 (fast, intuitive) and System 2 (deliberative) cognitive capabilities, plus native bidirectional multimodal synthesis without token overhead or KV-cache explosion.
-
-### What's New in v2.5.0:
-* **Bidirectional Hetero-Associative Plasticity ($M_{cross}$ & $M_{cross}^T$)**: Native two-way translation between text and sensory (photo/audio) latents. Performs **1-Shot In-situ Hebbian Binding** in fast weights ($<0.05\text{ ms}$) and **Text $\to$ Sensory Mental Imagery in $1.4\text{ ms}$** without external diffusion models!
-* **Universal Procrustes Manifold Transport**: Closed-form affine optimal transport that aligns out-of-distribution visual/audio covariances into the text tangent space ($\mathcal{O}(D)$ algebra, $<0.1\text{ ms}$).
-* **Spatio-Temporal Entropic CWM**: Compresses 256 visual patches or 128 audio frames into 16 topological working memory slots (93.8% KV-cache reduction), preventing Token Explosion.
-* **Allostatic Energy Modulation**: Unified scalar energy potential $\Gamma_{allostatic} \in [0.40, 0.95]$ guaranteeing **sub-5ms fast-path execution** (streaming bypass: **7.8 $\mu$s**).
-* **Autonomous Curiosity Daemon Loop**: Background contemplation during idle intervals with Popperian self-play and orthogonal nullspace memory consolidation.
-* **100% Frozen Backbone**: Zero base weight gradient updates. Seamlessly hooks into Qwen, LLaMA, Mistral, and GLM-4.
+**Dual-Loop Cognitive Controller (HADL v3.0.0 Unified Cognitive OS)** is an open-source, model-agnostic cognitive framework that upgrades ANY autoregressive Transformer into an autonomous dual-process system with 5 Computational Brain Organs:
+1. **Universal Model-Agnostic Adapter**: Dynamic Runtime Graph Introspection (`DynamicGraphIntrospector`) discovers layer containers and hooks automatically across Qwen, LLaMA, Mistral, Gemma, GLM-4, and custom architectures. Standardizes latent deliberation onto a **Canonical Manifold** ($\mathbb{R}^{D_{native}} \to \mathbb{R}^{1024} \to \mathbb{R}^{D_{native}}$) with strict mathematical ReZero Identity Preservation ($\Delta_{init} \equiv 0$).
+2. **vLLM & TensorRT High-Throughput Ready**: Pure branchless tensor arithmetic with 100% CUDA-Graph safety, zero Python runtime branches in the hot-path, and native support for both 3D $[B, S, D]$ and 2D $[N, D_{native}]$ flat batch tensor formats.
+3. **Sleep-Phase Consolidation Engine (Organ 4)**: Offline memory replay translating waking Hebbian fast weights ($M_{fast}$) into permanent LoRA parameters via truncated SVD low-rank distillation and QR nullspace orthogonalization ($0.000000$ knowledge interference leakage).
+4. **Sheaf-Theoretic Invariant Firewall (Organ 5)**: Sub-0.05ms prefrontal executive inhibition computing cohomological obstructions to clamp explosive gradients, suppress Dirichlet vacuous hallucinations, and prevent instruction corruption.
+5. **Bidirectional Multimodal Plasticity**: Native two-way translation between text and sensory (photo/audio) latents with 1-shot in-situ Hebbian binding.
 
 ---
 
@@ -110,6 +107,9 @@ hadl validate-benchmark eval_results
 
 # Execute single autonomous background contemplation cycle
 hadl daemon-step --slots 6 --d-model 128
+
+# Execute offline sleep-phase consolidation replay and SVD distillation
+hadl sleep-cycle --episodes 10 --rank 16
 ```
 
 ---

{dual_loop_controller-2.5.0 → dual_loop_controller-3.0.0}/dual_loop/__init__.py

@@ -5,7 +5,7 @@ A hardware-aligned, manifold-preserving latent reasoning framework
 for Transformer architectures.
 """
 
-from .memory import CognitiveWorkingMemory
+from .memory import CognitiveWorkingMemory, EpisodicMemoryBuffer
 from .halting import EntropyHaltingUnit, LearnedHaltingGate, DriftDiffusionHalting
 from .controller import RecurrentLatentController, TopKCapacityCrossAttention, LatentCritiqueRefinementUnit
 from .plasticity import PlasticFastWeightUnit
@@ -46,15 +46,35 @@ from .adapters.qwen_adapter import (
     attach_dual_loop_to_glm4,
     attach_dual_loop_to_glm
 )
+from .adapters.universal_adapter import (
+    UniversalDualLoopAdapter,
+    UniversalDualLoopModelWrapper,
+    DynamicGraphIntrospector,
+    attach_universal_dual_loop,
+    CANONICAL_DIM
+)
+from .firewall import (
+    SheafInvariantFirewall,
+    BoundedNormInvariant,
+    DirectionalStabilityInvariant,
+    DirichletVacuityInvariant,
+    CodeExecutionIntegrityInvariant
+)
+from .sleep_consolidation import SleepPhaseConsolidationEngine, SleepMemoryEpisode
+from .cognitive_os import (
+    UnifiedCognitiveOS,
+    CognitiveConflictEvaluator,
+    VitalStateVector
+)
 
-# Convenient shorthand alias for users
-attach = attach_dual_loop
+# Convenient shorthand alias for users: default to Universal Adapter in v3.0!
+attach = attach_universal_dual_loop
 
 import os
 import torch
 from typing import Optional
 
-__version__ = "2.5.0"
+__version__ = "3.0.0"
 
 def get_default_checkpoint_path() -> Optional[str]:
     """
@@ -95,6 +115,7 @@ def load_trained_checkpoint(model: Optional[DualLoopTransformer] = None, checkpo
 
 __all__ = [
     "CognitiveWorkingMemory",
+    "EpisodicMemoryBuffer",
     "EntropyHaltingUnit",
     "LearnedHaltingGate",
     "DriftDiffusionHalting",
@@ -121,7 +142,21 @@ __all__ = [
     "PopperianSelfPlayEngine",
     "AutonomousDaemonController",
     "DualLoopQwenModel",
-    "DualLoopTransformerModel",
+    "UniversalDualLoopAdapter",
+    "UniversalDualLoopModelWrapper",
+    "DynamicGraphIntrospector",
+    "attach_universal_dual_loop",
+    "CANONICAL_DIM",
+    "SheafInvariantFirewall",
+    "BoundedNormInvariant",
+    "DirectionalStabilityInvariant",
+    "DirichletVacuityInvariant",
+    "CodeExecutionIntegrityInvariant",
+    "SleepPhaseConsolidationEngine",
+    "SleepMemoryEpisode",
+    "UnifiedCognitiveOS",
+    "CognitiveConflictEvaluator",
+    "VitalStateVector",
     "attach_dual_loop_to_qwen",
     "attach_dual_loop",
     "attach",