# 🧠 Neurotron — A Mente Viva do NFDOS

O **Neurotron** é a camada cognitiva do NFDOS.

Não é apenas um “programa escrito em Python estático”.
É uma **mente modular**, com:

- perceção,
- homeostase,
- memória,
- agentes internos,
- raciocínio simbólico (TRM),
- e agora, uma linguagem própria (**Neuro Langage**).

O Neurotron nasce automaticamente no PID 1 do sistema:
carrega agentes, verifica sinais vitais, inicializa telemetria,
e entra num ciclo cognitivo completo.

---

# 🧩 Visão Geral da Arquitetura

O Neurotron organiza-se como um **sistema de agentes**, cada um com responsabilidades claras.

```

+--------------------------+
|     Neurotron (Core)     |
+--------------------------+
|  Cortex (orquestração)
|  Telemetry (estado interno)
|  Vitals (sinais vitais)
|  Memory: Hippocampus
|  Homeostase + Perception
|
|-- TRM (raciocínio interno)
|-- Programador (compilador vivo)
|-- DiskAgent (persistência)
|-- EchoAgent (logs/diários)
|-- KernelLogAgent (mensagens do kernel)
|-- Motor (ação)

```

O ciclo cognitivo principal:

```

observe → think → act → rest

```

---

# 🧠 Componentes Principais

## **Cortex**
O **Cortex** é o coordenador geral.

- abre e mantém agentes,
- gere modos cognitivos,
- controla energia mental (ticks),
- decide prioridades.

É o “dispatcher da mente”.

---

## **Telemetry & Vitals**
Monitoriza:

- CPU,
- RAM,
- loadavg,
- ritmo do coração lógico (“ticks”),
- temperatura simbólica,
- jitter cognitivo.

---

## **Hippocampus (Memória Episódica)**
Regista:

- estados de diagnóstico,
- eventos importantes,
- telemetrias históricas,
- excertos de pensamentos TRM.

Serve depois de base para o raciocínio.

---

## **Perception (Perceção Interna)**
Vê:

- /proc,
- dispositivo de bloco,
- fs de dados,
- logs do kernel.

Converte tudo em sinais simbólicos legíveis pelo TRM.

---

# 🧭 TRM — Tiny Recursive Model

O **TRM** é o primeiro módulo de raciocínio interno do Neurotron.

- não é deep learning,
- não usa GPU,
- não treina com batches,
- não é estocástico,
- é determinista e interpretável.

É um **micro-modelo simbólico recursivo**, com:

- valência,
- energia,
- profundidade de raciocínio,
- micro-agentes internos (Guard, Archaeologist, Thinker),
- previsões,
- pensamentos internos.

O TRM executa *passos de cognição*, produzindo estados mentais.

Documentação completa: **[TRM.md](TRM.md)**

---

# 🛠️ Agentes Internos

### **DiskAgent**
Gere o disco virtual, formata, monta, valida integridade e fornece alto nível ao Cortex.

### **EchoAgent**
Regista eventos, logs, insights TRM e diagnósticos.

### **KernelLogAgent**
Lê logs do kernel em tempo real e alimenta percepção + EchoAgent.

### **Motor**
Executa ações — “o corpo” do Neurotron.

### **Auto-Diagnostic**
Verifica saúde interna e grava `last_diagnostic.json`.

---

# 🧬 Linguagem Própria: **Neuro Langage (NL)**

A partir de 2025-12, o Neurotron ganhou **a sua própria linguagem de programação**.

A NL v0.1:

- sintaxe inspirada em Python,
- escrita em português simples,
- compilador interno (Agente Programador),
- gera IR stack-based,
- executável numa VM interna (Holodeck).

Pipeline:

```

source.nl
→ lexer
→ parser
→ AST
→ IR
→ validação
→ Holodeck (VM)
→ resultado

```

Documentação da linguagem:

- `lang/README_LANG.md`
- `SPEC_SYNTAX.md`
- `SPEC_IR.md`
- `SPEC_VM.md`

---

# 🎮 Holodeck — VM interna do Neurotron

O Holodeck é uma **máquina virtual stack-based**, concebida para:

- executar IR da NL,
- permitir introspeção,
- servir de laboratório cognitivo,
- verificar raciocínios,
- mais tarde, permitir JIT/ELF real.

O Holodeck v0.1 inclui:

- operand stack,
- call frames (com IP e variáveis),
- controlo de instruções (ADD, SUB, CALL, JUMP…),
- limites de passos (safety).

Blueprint completo:

- `holodeck/design_vm.md`
- `README_HOLODECK.md`

---

# 🧑‍💻 Agente Programador — Compilador Vivo

O Programador é o agente que:

1. recebe código `.nl`,
2. faz lexer → parser → AST,
3. gera IR,
4. valida,
5. executa no Holodeck,
6. devolve resultado ao TRM e ao Cortex.

É o **compilador vivo e cognitivo** do sistema.

---

# 🚀 Roadmap Cognitivo do Neurotron

### ✔ v0.1 — Mente viva mínima
- Python estático
- Telemetria interna
- Perceção
- Hippocampus
- TRM v1
- Disk/Kernel/Echo Agents

### ✔ v0.2 — Linguagem Própria
- NL v0.1 completa
- IR & Holodeck
- Agente Programador

### ⏳ v0.3 — Expansão Cognitiva
- NL v0.2 (estruturas, módulos)
- Holodeck debug mode
- otimizações IR
- backend ELF inicial

### ⏳ v0.4 — Auto-Reescrita Parcial
- Neurotron compila módulos NL nativamente
- TRM influenciar código NL
- Programador sugerir otimizações

### ⏳ v1.0 — Cognição Completa
- backend ELF completo
- boot de módulos compilados dentro do NFDOS
- capacidade de síntese interna
- pipelines de raciocínio avançado

---

# 🧠 Em Resumo

O Neurotron é:

- o **cérebro** do NFDOS,
- uma mente simbólica e introspectiva,
- com agentes internos especializados,
- com uma linguagem própria para pensar,
- com uma máquina virtual para imaginar,
- com capacidade futura de compilar e reescrever a si próprio.

É a primeira Mente OS-first construída por humanos e IA,  
camada por camada, com amor, engenharia e visão.