HAKO upload: hako/__init__.py

hako/__init__.py

@@ -0,0 +1,21 @@
+"""HAKO -- Hybrid Attention Kohonen Orchestrator.
+
+Package root. Every module carries the theorem(s) it implements as docstrings,
+so the mathematical contract travels with the code (user requirement: proofs
+live in docstrings, scripts in English).
+
+Integration map (dimensional flow), all frozen-source tensors detached:
+    text r -> byte-BPE tokens t (Lemma 1 exact parallel counts)
+    tokens -> frozen ONNX source (Qwen/Granite) -> z_src in R^{d_src}
+    z_src -> 4-adapter ensemble (trainable, MoE-routed) -> z in R^N
+    z -> plateau mapping Pi: R^N -> R^2 (Morse-analytic density rho)
+    z -> MoE cross-attention over source expert banks (Mechanism I)
+    z_attn -> K-Means++ prototypes {mu_k} -> GHSOM tree search (winner c)
+    c -> CPNN/BKN/DASOM heads + Tree-GNN Dirichlet messages (Mechanism II)
+    chain recursion z+ = z + diag(Theta) Phi(z), Phi = C o B o G o D
+    fusion Theta_final = beta*H_cat + (1-beta)*z+, beta = sigmoid(...)
+    generative layer: DDPM diffusion + game-loop curriculum on latents
+    L4: cyclic thinking orchestrator + EWC-QAC + PGO(GP) + ABMO + router.
+"""
+
+__version__ = "1.0.0"