Coordinator
Possiede il lifecycle del run: apre il ciclo, governa gli stage osservabili e chiude il flow in modo esplicito.
- Coordinator è l’owner del lifecycle del run assistant nel prototipo AIKA. Riceve il prompt, lo sanifica, usa il canale della request e apre il ciclo operativo solo quando l’input è valido.
- Il modello è stage-oriented: Composer, Memory Search e Memory CRUD sono le fasi della sequenza operativa del run, i momenti in cui il dato cambia stato e produce un esito leggibile. Nel prototipo, gli stage seguono lo stesso schema interno: il modulo di dominio produce l’esito, Streamer lo trasforma in blocco osservabile e Receiver lo consegna al canale del run.
- Ogni stage restituisce un esito osservabile: microsensi estratti o assenti, costellazioni trovate, scartate o non disponibili, memoria aggiornata, rinnovata o non modificata. L’osservabilità non coincide quindi solo con il successo, ma con la capacità del prototipo di dichiarare cosa è accaduto.
- Il sistema può misurare i tempi del run e degli stage in millisecondi. Nel prototipo, il timing resta infrastruttura di verifica e report: rende il ciclo osservabile e controllabile, senza diventare logica cognitiva o decisione di routing. La sua presenza prepara una possibile evoluzione futura: usare i tempi del run come segnali operativi per rendere il sistema più adattivo.
- Coordinator non sostituisce i moduli nel loro lavoro interno. Governa il lifecycle complessivo: decide se proseguire allo stage successivo, se interrompere il run e se uno stage deve diventare osservabile.
- Se uno stage fallisce, Coordinator interrompe la sequenza: gli stage successivi non partono, ma i blocchi già emessi restano validi come stato osservato del run.
- Il run non produce un payload finale unico verso il frontend. Gli esiti del run passano dal canale come blocchi progressivi, poi Coordinator chiude il ciclo con complete o fail e torna idle in attesa del prompt successivo.