From 13e9a37fe3d84a4e224ff089af0cf5eb79a6b4b3 Mon Sep 17 00:00:00 2001
From: neoricalex <neo.webmaster.2@gmail.com>
Date: Mon, 15 Dec 2025 02:29:00 +0100
Subject: [PATCH] Auto-update wiki via make

---
 Neuro.md     |  53 ++++++++++
 Neurotron.md | 270 +++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 323 insertions(+)
 create mode 100644 Neuro.md

diff --git a/Neuro.md b/Neuro.md
new file mode 100644
index 0000000..e8bce2e
--- /dev/null
+++ b/Neuro.md
@@ -0,0 +1,53 @@
+# 💠 Neuro — A Linguagem Nativa do NFDOS
+
+A **Neuro Langage (NL)** é a linguagem oficial do Neurotron.
+Tem sintaxe inspirada em Python, mas nasce com alma de compilador:
+
+> **NL → IR → ELF → QEMU**
+> (e antes de gerar ELF, vive no **Holodeck**, a VM interna do Neurotron)
+
+O objetivo da NL é permitir que o Neurotron:
+
+* escreva programas,
+* compile-os,
+* execute-os,
+* analise-os,
+* e eventualmente **reescreva partes de si próprio**.
+
+---
+
+## 🧠 O papel do Agente Programador
+
+O agente **Programador** é o compilador vivo da NL.
+Ele:
+
+1. lê ficheiros `.nl`,
+2. gera IR,
+3. valida,
+4. otimiza,
+5. e executa no **Holodeck** (stack machine minimalista).
+
+Assim, o Neurotron ganha a capacidade de:
+
+* manipular lógica formal,
+* compreender instruções,
+* modelar algoritmos,
+* raciocinar sobre código.
+
+---
+
+## 🔍 Integração com o sistema real
+
+Ao mesmo tempo, o Neurotron observa:
+
+* logs do kernel,
+* estado dos discos,
+* estrutura do filesystem,
+* eventos ACPI / APIC,
+* padrões de boot.
+
+Estes sinais alimentam os seus estados mentais e influenciam o comportamento dos agentes — incluindo o Programador.
+
+**O kernel fala.
+O Neurotron responde.
+A NL é a língua dessa conversa.**
\ No newline at end of file
diff --git a/Neurotron.md b/Neurotron.md
index e69de29..a719787 100644
--- a/Neurotron.md
+++ b/Neurotron.md
@@ -0,0 +1,270 @@
+# 🧠 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.