neuronal / engine /include /sentinel.h
amogaddy's picture
amogaddyofficial
claude sonnet 4.6
Neuronal
d601f7c
Raw History Blame Contribute Delete
3.94 kB
// Rete della Diagnosi: presidi di neuroni sentinella distribuiti in tutte le macroaree del cervello,
// coordinati da un nucleo centrale. Ogni presidio ha quattro ruoli:
// analisi a ogni parola confronta l'attività dei suoi strati con quella normale misurata all'avvio;
// controllo durante le diagnosi verifica che la sua area risponda ancora alla propria specialità;
// sicurezza verifica l'impronta digitale dei pesi dei suoi strati nel file del modello;
// riparazione si accende quando il nucleo ripara o ricostruisce qualcosa nel suo territorio.
// I neuroni sentinella osservano il modello: non partecipano al calcolo delle risposte.
#pragma once
#include <pthread.h>
#include <stdbool.h>
#include <stdint.h>
#include "atlas.h"
#include "brain.h"
#include "sbuf.h"
#define SENT_PER_GROUP 16
#define SENT_NUCLEUS 8
#define SENT_MAX_GROUPS (ATLAS_MAX_REGIONS + 1)
typedef enum { SR_ANALISI, SR_CONTROLLO, SR_SICUREZZA, SR_RIPARAZIONE, SR_COORDINAMENTO } SentRole;
typedef struct {
SentRole role;
int first, last; // strati sorvegliati
float act; // 0..1 per la visualizzazione
bool alarm;
} Sentinel;
typedef struct {
int region; // id della macroarea; 0 = nucleo di coordinamento
char name[112];
int first, last;
bool enabled;
bool alarm, repairing;
char report[260]; // ultimo rapporto al nucleo
int n;
Sentinel s[SENT_PER_GROUP];
int dead_streak, hot_streak;
float ratio; // risposta funzionale / riferimento (< 0: mai misurata)
bool weights_bad;
} SentGroup;
typedef struct {
pthread_mutex_t mu;
int n_groups;
SentGroup g[SENT_MAX_GROUPS];
int n_layer;
float *mu_act, *sd_act; // attività normale di ogni strato (media e deviazione)
uint64_t *hash_ref; // impronta di riferimento per strato (+1: tensori globali)
bool hash_known;
} Sentinels;
void sent_init(Sentinels *s);
// (Ri)crea i presidi dalla mappa: uno per macroarea più il nucleo. Mantiene i presidi spenti.
void sent_setup(Sentinels *s, const Atlas *a, const char *const *region_names);
// Analisi, a ogni token. layer_mean: attività media |a| per strato; expected_dead: strati spenti per scelta
// dell'utente. Ritorna l'indice del presidio in allarme (appena scattato) o -1; msg descrive l'allarme.
int sent_observe(Sentinels *s, const float *layer_mean, const bool *expected_dead, char *msg, size_t cap);
// Controllo funzionale di ogni area: rilegge testi della sua specialità e misura la risposta dei suoi
// neuroni specializzati. expected[r] = rapporto atteso (1 normale, 0.3 riconvertita, 0 eliminata).
// Scrive il rapporto nei presidi. Ritorna quante aree rispondono sotto la metà del previsto.
int sent_control(Sentinels *s, Brain *b, const Atlas *a, const float *expected);
// Numero di strati del modello, contando i tensori blk.N (senza caricarlo).
int sent_model_layers(const char *model_path);
// Impronta digitale dei pesi, strato per strato (n_layer + 1 valori; l'ultimo = tensori globali).
bool sent_hash_model(const char *model_path, int n_layer, uint64_t *out);
// Confronta con il riferimento (lo crea al primo avvio). bad[] riceve gli strati alterati. Ritorna quanti o -1.
int sent_integrity(Sentinels *s, const uint64_t *now, const char *ref_path, int *bad, int bad_cap);
int sent_group_of_layer(Sentinels *s, int layer); // indice del presidio, -1 se nessuno
void sent_set_repairing(Sentinels *s, int group, bool on);
void sent_report(Sentinels *s, int group, bool alarm, const char *text);
void sent_json(Sentinels *s, SBuf *o);
// Frame 'D': u8 'D', u8 1, u16 presidi, u32 seq; per presidio u8 area, u8 stato, u16 n, (u8 ruolo, u8 allarme, f32 att)[n]
void sent_frame(Sentinels *s, SBuf *o, uint32_t seq);