TyC6lC$is-noden (runnerin) onnistunut kC$ynnistys tarkoittaa, ettC$
suorituspuoli on valmis ja tC$ysin hajautettu. Seuraava looginen askel on
rakentaa nC$ille aivoille ohjauskeskus ja "koulukeskus" (Playbook Studio &
Orchestrator). Ehdottamasi jako kolmeen osa-alueeseen on tC$ydellinen, ja
X11-kuuntelijan integroiminen opetukseen nostaa jC$rjestelmC$n aivan uudelle
tasolle.
Kun ihminen opettaa bottia X11-nauhoituksella, meidC$n ei tarvitse tallentaa
vain raakoja (ja hauraita) X/Y-koordinaatteja. Koska meillC$ on alussa otettu
tab_snapshot.py ja ocr_semantic_map.json, voimme taustalla ristiintaulukoida
X11-hiiriklikkauksen koordinaatit semanttisen kartan kanssa. Jos kC$yttC$jC$
klikkaa koordinaattia (X: 150, Y: 200), skripti voi katsoa kartasta: "Ahaa,
tuossa kohtaa oli painike 'Luo uusi'. Tallennan YAML-tiedostoon semanttisen
klikkauksen tC$hC$n painikkeeseen, enkC$ vain absoluuttista koordinaattia!"
TC$ssC$ on valmis, jC$sennelty ohjeistus seuraavaa chattia varten. Se asettaa
uudelle tekoC$lylle tarkan kontekstin ja jakaa tyC6n selkeisiin REST API- ja
UI-kokonaisuuksiin.
Kopioi alla oleva teksti uuden chatin ensimmC$iseksi viestiksi:
# [SYSTEM CONTEXT & MASTER PLAN: OMEGA MESH PLAYBOOK STUDIO & ORCHESTRATOR]

Olet kokenut Full Stack Python-arkkitehti. Olemme rakentaneet hajautetun,
tilakone-pohjaisen RPA-arkkitehtuurin (Robotic Process Automation).
Suoritus-nodet (kuten `state-machine-runner.py`) pyC6rivC$t jo taustalla,
lukiten ja suorittaen `.json`-muotoisia tilakoneita jaetulta verkkolevyltC$.
Selainten DOM-kartoitus ja konenC$kC6 (OCR) ovat myC6s tC$ysin toiminnassa.

Nyt rakennamme nC$ille tyC6kaluille graafisen ohjauskeskuksen ja opetustilan:
**Playbook Studion**. Se on FastAPI-pohjainen REST-palvelu, joka tarjoaa
selaimessa toimivan hallintapaneelin.

## Arkkitehtuurin 3 pilaria (Tulevat tehtC$vC$t)

### 1. Tilakoneiden Hallinta (Orchestrator)
*   **Logiikka:** REST API lukee `state-machines/` hakemiston JSON-tiedostot.
*   **Toiminnot:** 
    *   Listaa aktiiviset, valmistuneet ja virhetilassa olevat prosessit.
    *   Luo uusi tilakone valitusta Playbookista.
    *   Muuta tilakoneen tilaa (esim. `pending` <-> `paused`), mikC$
pysC$yttC$C$ tai vapauttaa taustalla pyC6rivC$t runner-nodet.

### 2. Playbook-rekisterin Hallinta (Registry)
*   **Logiikka:** REST API hallinnoi `playbooks/categories/` kansiopuuta.
*   **Toiminnot:** 
    *   Selaa, luo, poista ja muokkaa rutiineja (esim. `00_init`,
`01_send_file`).
    *   Muokkaa YAML-tiedostoja ja askeleita selainpohjaisella editorilla.

### 3. Opetustila & X11-Nauhoitus (The Teaching Pipeline)
TC$mC$ on jC$rjestelmC$n C$lykkC$in osa. KC$yttC$jC$ valitsee UI:sta
playbookin askeleen ja painaa "Aloita tallennus", jolloin tapahtuu seuraava
ketju:
1.  **Snapshot:** Palvelin liipaisee `tab_snapshot.py`:n, joka tallentaa
selaimen nykytilan (`DOM.json` & OCR-data) kyseisen askeleen *vaadituksi
lC$htC6tilaksi*.
2.  **X11-Kuuntelu:** Palvelin kC$ynnistC$C$ (jo olemassa olevan)
X11/nC$ppC$in-kuuntelijaprosessin, joka nauhoittaa ihmisen hiiren klikkaukset
ja nC$ppC$ilyt.
3.  **KC$C$nnC6s (Auto-Mapping):** Kun tallennus lopetetaan, palvelin vertaa
X11-klikkauskoordinaatteja Snapshotin semanttiseen karttaan. Jos klikkaus osui
napin "LC$hetC$" pC$C$lle, palvelin generoi YAML-tiedostoon C$lykkC$C$n ohjeen
(Semantic Agent) raakojen koordinaattien sijaan.
4.  **Vahvistus:** Generoitu YAML nC$ytetC$C$n UI:ssa, jossa ihminen voi
hienosC$C$tC$C$ sitC$, asettaa sen vaatiman lC$htC6tilan (sanity check)
sC$C$nnC6t ja ajaa sen runnerilla "testitilassa".

## Seuraava TehtC$vC$si:
YmmC$rrC$tkC6 tC$mC$n konseptin ja arkkitehtuurin? Jos ymmC$rrC$t, vastaa
lyhyesti "KyllC$".

Aloita sen jC$lkeen ehdottamalla meille FastAPI-pohjaista runkoa (API-reitit
ja yksinkertainen Vanilla JS/HTML frontend-pohja) yllC$ kuvattujen pilarien
**Osaan 1 (Tilakoneiden hallinta)**. KeskitytC$C$n siihen, miten UI listaa
`state-machines/` kansion tiedostot ja pystyy muuttamaan niiden
`status`-kenttC$C$ (`pending`/`paused`).