---
name: ewa-dart-runtime
description: Dart ile çok platformlu (minimal RAM) Edge Workflow Agent runtime’ını (YAML job engine + BLE + local KV + sadece MQTT) scaffold etmek, güncellemek ve doğrulamak için kullan.
---

# EWA Dart Runtime Skill

## Amaç
Bu skill, bu repoda "Edge Workflow Agent (EWA) — Agent Model v1" mimarisine uygun bir Dart runtime üretir/uygular:
- YAML ile job/trigger/step
- BLE/GATT adapter (universal_ble)
- Network: sadece MQTT
- Local KV (memory/disk/hybrid), TTL, düşük RAM
- Raw payload log opsiyonel (segment files)
- Sync/async (spawn/await), try/catch, if/switch

## Kesin Kurallar (Minimal + Optimize)
- Ağ protokolü sadece MQTT olacak. HTTP/REST/Websocket ekleme.
- Reflection/dynamic invocation yok: step runner switch-case.
- Bounded queue + bounded concurrency: event/task/job limitleri şart.
- Default davranış: job step’leri sıralı (sync). Async sadece açıkça istenirse.
- Persist KV opsiyonel olacak (store.mode = memory|disk|hybrid).
- Raw payload saklama default kapalı; açılırsa segment log (append-only + rotate).
- Her yeni feature eklemeden önce mevcut modeli stabilize et.

## Kullanım Senaryoları (Ne zaman tetiklenmeli)
- "EWA runtime skeletonunu oluştur"
- "YAML step/trigger ekle ama minimal kalsın"
- "KV persist/hybrid store ekle"
- "try/catch + if + async spawn/await semantiğini uygula"
- "RAM tüketimini azalt / bounded queue uygula"
- "Örnek YAML config üret ve test ekle"

## Yapılacaklar (Uygulama Planı)
1) Repo içinde `.agent/skills/ewa-dart-runtime/resources/agent-model-v1.md` dosyasını kaynak doğrusu kabul et.
2) `resources/project-layout.txt` ile aynı path yapısını oluştur/koru.
3) Dart projesi yoksa CLI tabanlı oluştur (UI yok).
4) Core arayüzleri üret:
   - BleAdapter, MqttAdapter, Store(KV+stream+queue), Codec
5) Engine’i üret:
   - Trigger dispatcher: startup/interval/mqtt/ble_notify
   - Step runner: ble.*, mqtt.*, parse.*, store.*, control (if/try/await)
   - Task registry: spawn/await (bounded)
   - Event bus: bounded queue + coalesce policy
6) Store:
   - memory store: LRU+TTL
   - disk store: SQLite KV (minimal indexes) veya eşdeğer
   - hybrid store: RAM cache + disk backing
   - spool queue: MQTT offline publish
7) Örnek YAML’ı `resources/sample-config.yaml` ile hizala.
8) Test:
   - mock BLE + mock MQTT
   - engine step/trigger semantiği (try/catch, spawn/await)
9) Çıktıyı doğrula:
   - `dart analyze`
   - temel unit testler yeşil
   - RAM patlaması oluşturacak sınırsız kuyruk yok

## Çıktı Formatı
- Uyguladığın/oluşturduğun dosyaları bir liste olarak raporla.
- Önemli kararları 5-10 satırda özetle (özellikle concurrency/store).
- Ekstra feature önerme; sadece istenen kapsam.

## Not
Antigravity Skills formatı: SKILL.md YAML frontmatter + markdown body. :contentReference[oaicite:3]{index=3}