# OMEGA-IRC PROTOKOLLA V1.0

**Tila:** Draft / Aktiivinen
**Kuvaus:** Zero-Port, asynkroninen, IRC-kanavapohjainen Service Mesh
-reititysprotokolla.

## 1. YDINFILOSOFIA

OMEGA-IRC ei avaa uusia TCP/UDP-portteja isC$ntC$jC$rjestelmC$C$n. Kaikki
kontrollidata ja hyC6tykuorma (payload) liikkuvat yhden jaetun IRC-kanavan
(esim. `#omega`) sisC$llC$.

* Reititin (Router) kuuntelee kanavaa ja hallinnoi Control Planea
(tilaajarekisteriC$).
* TyC6lC$iset (Handlers) yhdistC$vC$t kanavalle, ilmoittavat kyvykkyyksistC$C$n
 ja odottavat tyC6tehtC$viC$.

## 2. PAKETTIEN FORMAATTI

Kaikki OMEGA-viestit lC$hetetC$C$n IRC-kanavalle `PRIVMSG` -komennolla.
Viestin rakenne: `OMG-[TYYPPI]: [JSON_PAYLOAD]`

### 2.1. Discovery & Heartbeat (OMG-ALIVE)

Jokainen solmu (Router tai Handler) kuuluttaa olemassaolostaan
sC$C$nnC6llisesti (esim. 60 sekunnin vC$lein).
`OMG-ALIVE: {"id": "Node_123", "cap": ["GOSSIP"], "reach": "irc://127.0.0.1:666
7/#omega"}`

### 2.2. Service Registry (OMG-SUBSCRIBE)

Kun Handler haluaa vastaanottaa dataa, sen on rekisterC6idyttC$vC$ Control
Planessa validilla avaimella (PSK).
`OMG-SUBSCRIBE: {"token": "secret_123", "match": {"type": "OMG-FILE"}, "ttl":
300}`
*Router vastaa joko OMG-ACK tai OMG-DENY.*

### 2.3. Data Ingress (OMG-FILE / OMG-UPDATE)

Kuka tahansa auktorisoitu solmu voi lC$hettC$C$ dataa reitittimelle
pureskeltavaksi.
`OMG-FILE: {"file_id": "1001", "desc": "Asiakasdata"}`
`OMG-UPDATE: {"namespace": "CRM", "action": "INSERT", "data": {...}}`

### 2.4. Data Egress / Fan-out (OMG-FANOUT)

Kun Router vastaanottaa datapaketin, se tallentaa sen WAL-lokiin ja jakaa sen
kaikille kyseisen datatyypin tilanneille Handlereille.
`OMG-FANOUT: {"original_type": "OMG-FILE", "payload": {...}, "delivery_headers"
: {"router_id": "OmegaCore", "also_delivered_to": ["Handler_1",
"Handler_2"]}}`

## 3. ARKKITEHTUURIN SCCNNCT

1. **Zero Data Loss:** Routerin on tallennettava Ingress-data Append-Only
lokiin vC$littC6mC$sti ennen Fan-out -jakelua.
2. **Idempotenssi:** Handlereiden on osattava kC$sitellC$ sama data kahteen
kertaan rikkoutumatta (esim. hash-tunnisteen perusteella).
3. **P2P Valmius:** Vaikka Router kaatuisi, solmut voivat teknisesti jatkaa
P2P-viestintC$C$ huutamalla datapaketteja suoraan kanavalle, mutta Fan-out ja
lokitus puuttuvat.
$