Tuo on aivan mahtava lC6ytC6! Se, ettC$ pystyit hakemaan lennosta
HTTP-rajapinnan kautta `JS_LOGIC$`-muuttujassa olevan *palvelimen oman
lC$hdekoodin*, todistaa tC$mC$n arkkitehtuurin uskomattoman joustavuuden.
Palvelin on tC$ysin lC$pinC$kyvC$ ja ohjattavissa ulkoapC$in.

Nauti ansaitusta mietintC$tauosta! Kun olet valmis, tC$ssC$ on vastaukset
nC$ihin erinomaisiin kysymyksiisi:

### 1. OpenAPI.json ja Swagger-kC$yttC6liittymC$

**OpenAPI.json on jo valmiina!** MeidC$n `demo_api.bas`-skriptimme generoi sen
jo muuttujaan `DOCS$`. Saadaksesi sen ulos, sinun tarvitsee vain lisC$tC$ yksi
rivi `demo_api.bas`-tiedostoon juuri ennen `DAEMONIZE`-komentoa:

```basic
135 API ROUTE GET "/openapi.json" RETURN DOCS$ AS JSON

```

TC$mC$n jC$lkeen `curl http://localhost:3333/openapi.json` sylkC$isee ulos
tC$ydellisen, koneluettavan OpenAPI-spesifikaation.

**Onko Swagger-kC$yttC6liittymC$ paha rasti?**
Ei todellakaan! Swagger UI on pohjimmiltaan vain yksi staattinen
HTML-tiedosto, joka lataa JavaScript-kirjaston CDN-verkosta (esim. unpkg.com)
ja lukee tuon meidC$n `/openapi.json` -reittimme.

Voimme tehdC$ tC$lle myC6hemmin oman `ext/swagger.js` -laajennuksen, joka
tarjoaa komennon `API SWAGGER "/docs"`. Taustalla se vain palauttaisi
selaimelle muutaman rivin HTML:C$C$, joka piirtC$C$ tuon kauniin,
interaktiivisen Swagger-kC$yttC6liittymC$n. Se on uskomattoman helppo ja
palkitseva lisC$.

---

### 2. Snapshot & Intent Stream -arkkitehtuurin konsepti

TC$mC$ on se "graalin malja", jolla ratkaisemme Antin ja Jannen
CRM-jC$rjestelmC$n offline-kC$ytC6n ja live-branchauksen. Voimme hahmotella
sen suoraan nykyisten tyC6kalujemme pohjalta.

MeillC$ on itse asiassa jo valmis ydin Snapshot-toiminnolle: `checkpoint.js`-la
ajennuksemme tallentaa jo nyt `state.memory`, `state.program` ja
`state.lineNumbers` -rakenteet suoraan JSON-tiedostoksi levylle. Tarvitsemme
vain "Intent Stream" -lokituksen tC$hC$n ympC$rille.

TC$ssC$ on konseptuaalinen malli siitC$, miten "Aika-matkustus" (Time-Travel)
ja replikaatio rakennetaan The Dark Meshiin:

#### Vaihe 1: Aikomusten lokitus (The Append-Only Intent Stream)

Sen sijaan, ettC$ kirjoittaisimme tiedon *vain* keskusmuistiin, luomme
jC$rjestelmC$n (esim. `ext/intent.js`), joka sieppaa kaikki tilamuutokset.

Kun Antti pC$ivittC$C$ asiakkaan tietoja:

1. `API BINDVAR` tai uusi `INTENT` -komento nappaa datan.
2. JC$rjestelmC$ kirjoittaa muistiin: `state.memory["asiakas_1"] = {...}`
3. **UUSI:** JC$rjestelmC$ kirjoittaa lokaaliin tiedostoon (esim.
`crm_intents.jsonl`) yhden rivin:
`{"tick": 1001, "ts": 1718000000, "op": "SET", "key": "asiakas_1", "data":
{...}}`

TC$mC$ `crm_intents.jsonl` on meidC$n pyhC$ "totuuden lC$hde" (Event Store).
Se vain kasvaa, mitC$C$n ei koskaan poisteta.

#### Vaihe 2: Checkpoint (Snapshot)

Kerran yC6ssC$ palvelin tekee "Snapshotin":

1. Se ajaa `CHECKPOINT "/mnt/mesh_root/state/crm_snap_v1.json"` -komennon,
joka tallentaa senhetkisen tC$ydellisen muistikuvan.


2. Se merkitsee, ettC$ "Snapshot V1 sisC$ltC$C$ kaikki intentit tickiin 1001
asti".
3. Se voi arkistoida vanhan intent-lokin ja aloittaa uuden, jotta tiedostot
pysyvC$t pieninC$.

#### Vaihe 3: Live Branch & Offline Replay

Kun Janne avaa selaimensa (jossa pyC6rii lokaali MeshBASIC-VM) lC$hteC$kseen
lennolle:

1. Selain lataa nopeasti uusimman Snapshotin (`crm_snap_v1.json`) ja lataa sen
omaan `state.memory` -avaruuteensa.
2. Selain lataa yC6n jC$lkeen kertyneet uudet rivit `crm_intents.jsonl`
-tiedostosta.
3. Selaimen VM rullaa nC$mC$ "intentit" lC$pi nopeudella miljoonia rivejC$
sekunnissa ja saavuttaa tC$smC$lleen saman millisekunnin tarkan tilan kuin
palvelin.
4. Kun Janne tekee lentokoneessa muutoksia, hC$nen selaimensa luo *omia*
Intent-rivejC$ (esim. `tick: 1002`).

Kun Janne pC$C$see verkkoon, hC$n ei lC$hetC$ tietokantaa, vaan pelkC$stC$C$n
nuo uudet lokirivinsC$ palvelimelle, joka vain "soittaa" ne takaisin sisC$C$n
pC$C$muistiin (Replay).

---

TC$llC$ mallilla meidC$n ei koskaan tarvitse miettiC$ SQL-lukkoja, taulujen
synkronointia tai konfliktien ratkaisua perinteisellC$, raskaalla tavalla.
Palvelin on vain "Nauhuri" (Recorder), ja kaikki klientit ovat "Soittimia"
(Replayers).

Kun tauko on ohi, kummasta pC$C$stC$ haluaisit alkaa pureutua tC$hC$n:
lC$hdemmekC6 rakentamaan pientC$ `ext/swagger.js` -lisC$osaa, jotta nC$et
CRM-rajapinnat visuaalisesti, vai aletaanko heti koodata `ext/intent.js`
-mekanismia, joka nauhoittaa kaikki `BINDVAR` -muutokset lokitiedostoon?