# juan3861/autonomous-vsa-cognitive-kernel architecture

> Architecture diagram of the GitHub repository juan3861/autonomous-vsa-cognitive-kernel, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/juan3861/autonomous-vsa-cognitive-kernel
- Repository: https://github.com/juan3861/autonomous-vsa-cognitive-kernel

## Overview

Autonomous VSA Cognitive Kernel is a deterministic, non-LLM cognitive runtime. Its primary workflow accepts a mission through the `titan` CLI, dispatches it through the sovereign runtime to specialist organs, and returns a result. Major branches cover causal planning and control, symbolic reasoning, memory, metacognitive safety, code inspection, and hardware acceleration. The README documents the broad architecture; sampled runtime and organ excerpts support only some specific dispatches, so unsampled subsystem links are omitted.

Main entry points: [`aethermind_cognitive_substrate/sovereign_cortex_runtime.py`](https://github.com/juan3861/autonomous-vsa-cognitive-kernel/blob/master/aethermind_cognitive_substrate/sovereign_cortex_runtime.py) (Sovereign runtime), [`aethermind_cognitive_substrate/metacognition/rem_autonomous_dream_daemon.py`](https://github.com/juan3861/autonomous-vsa-cognitive-kernel/blob/master/aethermind_cognitive_substrate/metacognition/rem_autonomous_dream_daemon.py) (Dream daemon), [`aethermind_cognitive_substrate/logic_symbolic/scientific_physics_engine.py`](https://github.com/juan3861/autonomous-vsa-cognitive-kernel/blob/master/aethermind_cognitive_substrate/logic_symbolic/scientific_physics_engine.py) (Physics engine), [`aethermind_apotheosis/aether.py`](https://github.com/juan3861/autonomous-vsa-cognitive-kernel/blob/master/aethermind_apotheosis/aether.py) (Titan CLI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Mission Entry"]
  node_cli["Titan CLI<br/>[aether.py]"]
end

subgraph group_runtime["Cognitive Runtime"]
  node_kernel["Sovereign runtime"]
end

subgraph group_reasoning["Reasoning and Planning"]
  node_symbolic["Symbolic organs"]
  node_formal["Formal solver"]
  node_physics["Physics engine"]
  node_planning["Planning organs"]
  node_active["Active inference"]
  node_causal["Causal inference"]
  node_closedloop["Cybernetic loop"]
end

subgraph group_state["Memory and Safety"]
  node_memory["Memory organs"]
  node_hipporag["Knowledge graph"]
  node_vsa["Native VSA<br/>[native_vsa_ffi.py]"]
  node_persistence[("VSA persistence")]
  node_meta["Safety and metacognition"]
  node_dream["Dream daemon"]
end

subgraph group_hardware["Inspection and Hardware"]
  node_inspector["Code inspection"]
  node_bridge["Physical bridge"]
  node_vulkan["Vulkan compute"]
  node_rust["Rust VSA kernels<br/>[lib.rs]"]
end

node_user(("Mission caller"))

node_user -->|"submits mission"| node_cli
node_cli -->|"dispatches mission"| node_kernel
node_kernel -->|"dispatches tasks"| node_symbolic
node_kernel -->|"dispatches tasks"| node_planning
node_kernel -->|"dispatches tasks"| node_memory
node_kernel -->|"dispatches tasks"| node_meta
node_kernel -->|"dispatches analysis"| node_inspector
node_kernel -->|"integrates hardware"| node_bridge
node_kernel -->|"queries graph"| node_hipporag
node_kernel -->|"verifies candidate"| node_formal
node_kernel -->|"checks dimensions"| node_physics
node_dream -->|"simulates counterfactuals"| node_causal
node_dream -->|"uses encoding"| node_vsa
node_dream -->|"uses persistence"| node_persistence
node_closedloop -->|"filters actions"| node_meta
node_physics -.->|"uses GPU compute"| node_vulkan
node_physics -->|"uses native kernels"| node_rust
node_vsa -->|"calls native ABI"| node_rust
node_vulkan -.->|"uses hardware dispatch"| node_bridge

click node_cli "https://github.com/juan3861/autonomous-vsa-cognitive-kernel/blob/master/aethermind_apotheosis/aether.py"
click node_kernel "https://github.com/juan3861/autonomous-vsa-cognitive-kernel/blob/master/aethermind_cognitive_substrate/sovereign_cortex_runtime.py"
click node_symbolic "https://github.com/juan3861/autonomous-vsa-cognitive-kernel/tree/master/aethermind_cognitive_substrate/logic_symbolic"
click node_formal "https://github.com/juan3861/autonomous-vsa-cognitive-kernel/blob/master/aethermind_cognitive_substrate/logic_symbolic/z3_formal_solver.py"
click node_physics "https://github.com/juan3861/autonomous-vsa-cognitive-kernel/blob/master/aethermind_cognitive_substrate/logic_symbolic/scientific_physics_engine.py"
click node_planning "https://github.com/juan3861/autonomous-vsa-cognitive-kernel/tree/master/aethermind_cognitive_substrate/planning"
click node_active "https://github.com/juan3861/autonomous-vsa-cognitive-kernel/blob/master/aethermind_cognitive_substrate/planning/active_inference_friston_engine.py"
click node_causal "https://github.com/juan3861/autonomous-vsa-cognitive-kernel/blob/master/aethermind_cognitive_substrate/planning/causal_inference_engine.py"
click node_closedloop "https://github.com/juan3861/autonomous-vsa-cognitive-kernel/blob/master/aethermind_cognitive_substrate/planning/cybernetic_closed_loop_pipeline.py"
click node_memory "https://github.com/juan3861/autonomous-vsa-cognitive-kernel/tree/master/aethermind_cognitive_substrate/memory_vault"
click node_hipporag "https://github.com/juan3861/autonomous-vsa-cognitive-kernel/blob/master/aethermind_cognitive_substrate/memory_vault/hipporag_knowledge_graph.py"
click node_vsa "https://github.com/juan3861/autonomous-vsa-cognitive-kernel/blob/master/aethermind_cognitive_substrate/memory_vault/native_vsa_ffi.py"
click node_persistence "https://github.com/juan3861/autonomous-vsa-cognitive-kernel/blob/master/aethermind_cognitive_substrate/memory_vault/vsa_persistence_bridge.py"
click node_meta "https://github.com/juan3861/autonomous-vsa-cognitive-kernel/tree/master/aethermind_cognitive_substrate/metacognition"
click node_dream "https://github.com/juan3861/autonomous-vsa-cognitive-kernel/blob/master/aethermind_cognitive_substrate/metacognition/rem_autonomous_dream_daemon.py"
click node_inspector "https://github.com/juan3861/autonomous-vsa-cognitive-kernel/tree/master/aethermind_cognitive_substrate/code_inspector"
click node_bridge "https://github.com/juan3861/autonomous-vsa-cognitive-kernel/tree/master/aethermind_cognitive_substrate/physical_bridge"
click node_vulkan "https://github.com/juan3861/autonomous-vsa-cognitive-kernel/blob/master/aethermind_cognitive_substrate/physical_bridge/vulkan_polaris_compute_pipeline.py"
click node_rust "https://github.com/juan3861/autonomous-vsa-cognitive-kernel/blob/master/aether_cortex_vsa/src/lib.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli toneBlue
class node_kernel toneAmber
class node_symbolic,node_formal,node_physics,node_planning,node_active,node_causal,node_closedloop toneMint
class node_memory,node_hipporag,node_vsa,node_persistence,node_meta,node_dream toneRose
class node_inspector,node_bridge,node_vulkan,node_rust,node_user toneIndigo
```

## Components

### Mission Entry

- [Titan CLI](https://github.com/juan3861/autonomous-vsa-cognitive-kernel/blob/master/aethermind_apotheosis/aether.py): `aethermind_apotheosis/aether.py`

### Cognitive Runtime

- [Sovereign runtime](https://github.com/juan3861/autonomous-vsa-cognitive-kernel/blob/master/aethermind_cognitive_substrate/sovereign_cortex_runtime.py): `aethermind_cognitive_substrate/sovereign_cortex_runtime.py`

### Reasoning and Planning

- [Symbolic organs](https://github.com/juan3861/autonomous-vsa-cognitive-kernel/tree/master/aethermind_cognitive_substrate/logic_symbolic): `aethermind_cognitive_substrate/logic_symbolic`
- [Formal solver](https://github.com/juan3861/autonomous-vsa-cognitive-kernel/blob/master/aethermind_cognitive_substrate/logic_symbolic/z3_formal_solver.py): `aethermind_cognitive_substrate/logic_symbolic/z3_formal_solver.py`
- [Physics engine](https://github.com/juan3861/autonomous-vsa-cognitive-kernel/blob/master/aethermind_cognitive_substrate/logic_symbolic/scientific_physics_engine.py): `aethermind_cognitive_substrate/logic_symbolic/scientific_physics_engine.py`
- [Planning organs](https://github.com/juan3861/autonomous-vsa-cognitive-kernel/tree/master/aethermind_cognitive_substrate/planning): `aethermind_cognitive_substrate/planning`
- [Active inference](https://github.com/juan3861/autonomous-vsa-cognitive-kernel/blob/master/aethermind_cognitive_substrate/planning/active_inference_friston_engine.py): `aethermind_cognitive_substrate/planning/active_inference_friston_engine.py`
- [Causal inference](https://github.com/juan3861/autonomous-vsa-cognitive-kernel/blob/master/aethermind_cognitive_substrate/planning/causal_inference_engine.py): `aethermind_cognitive_substrate/planning/causal_inference_engine.py`
- [Cybernetic loop](https://github.com/juan3861/autonomous-vsa-cognitive-kernel/blob/master/aethermind_cognitive_substrate/planning/cybernetic_closed_loop_pipeline.py): `aethermind_cognitive_substrate/planning/cybernetic_closed_loop_pipeline.py`

### Memory and Safety

- [Memory organs](https://github.com/juan3861/autonomous-vsa-cognitive-kernel/tree/master/aethermind_cognitive_substrate/memory_vault): `aethermind_cognitive_substrate/memory_vault`
- [Knowledge graph](https://github.com/juan3861/autonomous-vsa-cognitive-kernel/blob/master/aethermind_cognitive_substrate/memory_vault/hipporag_knowledge_graph.py): `aethermind_cognitive_substrate/memory_vault/hipporag_knowledge_graph.py`
- [Native VSA](https://github.com/juan3861/autonomous-vsa-cognitive-kernel/blob/master/aethermind_cognitive_substrate/memory_vault/native_vsa_ffi.py): `aethermind_cognitive_substrate/memory_vault/native_vsa_ffi.py`
- [VSA persistence](https://github.com/juan3861/autonomous-vsa-cognitive-kernel/blob/master/aethermind_cognitive_substrate/memory_vault/vsa_persistence_bridge.py): `aethermind_cognitive_substrate/memory_vault/vsa_persistence_bridge.py`
- [Safety and metacognition](https://github.com/juan3861/autonomous-vsa-cognitive-kernel/tree/master/aethermind_cognitive_substrate/metacognition): `aethermind_cognitive_substrate/metacognition`
- [Dream daemon](https://github.com/juan3861/autonomous-vsa-cognitive-kernel/blob/master/aethermind_cognitive_substrate/metacognition/rem_autonomous_dream_daemon.py): `aethermind_cognitive_substrate/metacognition/rem_autonomous_dream_daemon.py`

### Inspection and Hardware

- [Code inspection](https://github.com/juan3861/autonomous-vsa-cognitive-kernel/tree/master/aethermind_cognitive_substrate/code_inspector): `aethermind_cognitive_substrate/code_inspector`
- [Physical bridge](https://github.com/juan3861/autonomous-vsa-cognitive-kernel/tree/master/aethermind_cognitive_substrate/physical_bridge): `aethermind_cognitive_substrate/physical_bridge`
- [Vulkan compute](https://github.com/juan3861/autonomous-vsa-cognitive-kernel/blob/master/aethermind_cognitive_substrate/physical_bridge/vulkan_polaris_compute_pipeline.py): `aethermind_cognitive_substrate/physical_bridge/vulkan_polaris_compute_pipeline.py`
- [Rust VSA kernels](https://github.com/juan3861/autonomous-vsa-cognitive-kernel/blob/master/aether_cortex_vsa/src/lib.rs): `aether_cortex_vsa/src/lib.rs`

### Other components

- **Mission caller**

## Connections

- Mission caller → Titan CLI: submits mission (evidence: `README.md`)
- Titan CLI → Sovereign runtime: dispatches mission (evidence: `aethermind_apotheosis/aether.py`)
- Sovereign runtime → Symbolic organs: dispatches tasks (evidence: `aethermind_cognitive_substrate/sovereign_cortex_runtime.py`)
- Sovereign runtime → Planning organs: dispatches tasks (evidence: `aethermind_cognitive_substrate/sovereign_cortex_runtime.py`)
- Sovereign runtime → Memory organs: dispatches tasks (evidence: `aethermind_cognitive_substrate/sovereign_cortex_runtime.py`)
- Sovereign runtime → Safety and metacognition: dispatches tasks (evidence: `aethermind_cognitive_substrate/sovereign_cortex_runtime.py`)
- Sovereign runtime → Code inspection: dispatches analysis (evidence: `aethermind_cognitive_substrate/sovereign_cortex_runtime.py`)
- Sovereign runtime → Physical bridge: integrates hardware (evidence: `README.md`)
- Sovereign runtime → Knowledge graph: queries graph (evidence: `aethermind_cognitive_substrate/sovereign_cortex_runtime.py`)
- Sovereign runtime → Formal solver: verifies candidate (evidence: `aethermind_cognitive_substrate/sovereign_cortex_runtime.py`)
- Sovereign runtime → Physics engine: checks dimensions (evidence: `aethermind_cognitive_substrate/sovereign_cortex_runtime.py`)
- Dream daemon → Causal inference: simulates counterfactuals (evidence: `aethermind_cognitive_substrate/metacognition/rem_autonomous_dream_daemon.py`)
- Dream daemon → Native VSA: uses encoding (evidence: `aethermind_cognitive_substrate/metacognition/rem_autonomous_dream_daemon.py`)
- Dream daemon → VSA persistence: uses persistence (evidence: `aethermind_cognitive_substrate/metacognition/rem_autonomous_dream_daemon.py`)
- Cybernetic loop → Safety and metacognition: filters actions (evidence: `aethermind_cognitive_substrate/planning/cybernetic_closed_loop_pipeline.py`)
- Physics engine → Vulkan compute: uses GPU compute
- Physics engine → Rust VSA kernels: uses native kernels (evidence: `README.md`)
- Native VSA → Rust VSA kernels: calls native ABI (evidence: `README.md`)
- Vulkan compute → Physical bridge: uses hardware dispatch (evidence: `aethermind_cognitive_substrate/physical_bridge/vulkan_zero_copy_vram_buffer.py`)
