TC$mC$ on erinomainen ja erittC$in pragmaattinen lC$hestymistapa! Kahden eri
vientiformaatin tukeminen ratkaisee kaksi tC$ysin eri tarvetta: koneellisen
luettavuuden ja ihmisen hahmotuskyvyn.

Jotta AST Designer & Explorer -tyC6kalunne flat ID -pohjainen jC$sennys ei
mene rikki, alkuperC$inen syntaksi (`## NIMI {uuid}`) on ehdottomasti
rauhoitettava. R2D2 voi sen sijaan injektoida uuden elinkaaritiedon suoraan
solmun attribuutteihin puhtaana blokilainauksena (`>`).

TC$ssC$ on ehdotus siitC$, miten nC$mC$ kaksi export-komentoa (esim. `export
ast` ja `export summary`) voisivat toimia:

### 1. `export ast` (Koneellisesti luettava, AST Designer -yhteensopiva)

TC$mC$ formaatti sC$ilyttC$C$ tismalleen vaatimasi rakenteen. R2D2 lukee
litteC$n `r2d2-memory.json` -tiedoston ja kC$C$ntC$C$ kunkin solmun aktiiviset
vaiheet uudeksi `> states:` -attribuutiksi.

**Esimerkkituloste (`export ast`):**

```markdown
# ROOT_OMEGA_MESH {f9a1b2c3-4d5e-6f7a-8b9c-0d1e2f3a4b5c}
> description: OMEGA Mesh - Kokonaisarkkitehtuuri
> type: system
> doc: ./README.md
> states: [dokumentoi, ideoi]

## EDGE_NETWORK {e1d2c3b4-a5f6-7e8d-9c0b-1a2b3c4d5e6f}
> description: Cloudflare Workers -pohjainen reititys, autentikointi ja
tila-synkronointi.
> type: infrastructure/edge
> states: [dokumentoi]

### AUTH_QUEUE {a1b2c3d4-e5f6-4a5b-8c7d-9e0f1a2b3c4d}
> description: Kirjautumissessioiden ja jonojen hallinta (KV/Queues).
> type: component
> doc: ./docs/EDGE_NETWORK/AUTH_QUEUE.md
> states: [dokumentoi, toteuta, testaa]

```

NC$in parserinne voi sC$C$nnC6llisillC$ lausekkeilla tai omalla lexerillC$C$n
poimia `states`-taulukon sisC$llC6n tC$ysin standardoidusti ilman, ettC$
nimien ja UUID-tunnisteiden lukeminen hC$iriintyy.

### 2. `export summary` (Ihmisluettava tiimikooste)

TC$mC$ muoto riisuu pois kaiken koneellisen metadatan (kuten UUID:t ja
dokumenttipolut) ja keskittyy puhtaasti tilannekuvaan. TC$mC$ on erinomainen
tyC6kalu viestintC$C$n, jotta esimerkiksi Janne, Antti ja Kalle nC$kevC$t
nopealla vilkaisulla, missC$ vaiheessa eri komponenttien kehitys,
analyysimetriikat ja infrastruktuuri etenevC$t.

**Esimerkkituloste (`export summary`):**

```markdown
# OMEGA MESH - Tilannekatsaus

# OMEGA MESH - Tilannekatsaus" **ROOT_OMEGA_MESH** (Kokonaisarkkitehtuuri)
  Vaiheet: `[ dokumentoi] [ ideoi]`

  Vaiheet: `[ dokumentoi] [ ideoi]`! **EDGE_NETWORK** (Cloudflare Workers
-pohjainen reititys...)
    Vaiheet: `[ dokumentoi] [ ] toteuta`
    
    Vaiheet: `[ dokumentoi] [ ] toteuta`" **AUTH_QUEUE** 
      Vaiheet: `[ dokumentoi] [ toteuta] [ testaa]`
    
      Vaiheet: `[ dokumentoi] [ toteuta] [ testaa]`4 **MESH_ROUTER**
      Vaiheet: *(Ei aloitettuja vaiheita)*

      Vaiheet: *(Ei aloitettuja vaiheita)*" **CONTROL_PLANE** (Node.js/Express
Backend...)
    Vaiheet: `[ dokumentoi] [ toteuta]`

```

*TC$ssC$ visuaalisessa versiossa voimme kC$yttC$C$ yksinkertaisia
liikennevaloja (" Valmis/Aktiivinen, ! Kesken, 4 Ei aloitettu)
havainnollistamaan tilannetta nopeasti.*

---

### Miten toteutamme tC$mC$n kC$ytC$nnC6ssC$?

Jos tC$mC$ kahden exportin malli kuulostaa hyvC$ltC$, voimme seuraavaksi
lisC$tC$ nC$mC$ ominaisuudet R2D2:n logiikkaan. Tarvitsemme kC$ytC$nnC6ssC$:

1. **Tilanhallinnan pC$ivityksen:** R2D2-skriptiin lisC$tC$C$n funktiot, jotka
osaavat yhdistC$C$ staattisen AST-rakenteen ja dynaamisen muistin
(node_states).
2. **Komentorivilaajennuksen:** LisC$tC$C$n REPL:iin `task [vaihe]`, `done`,
`export ast` ja `export summary` -komennot.

Haluatko, ettC$ laadin sinulle suoraan Node.js-koodin nC$iden
R2D2-pC$ivitysten toteuttamiseen, vai haluatko meidC$n suunnittelevan vielC$
tarkemmin, miten tyC6vaiheiden (dokumentoi, toteuta, testaa...) riippuvuudet
kC$yttC$ytyvC$t (esim. voiko testata ennen kuin on toteutettu)?