@appaflytech/zeyrek-ai-mcp 0.0.6 → 0.0.7

package/dist/resources/guides/microfunction.md

@@ -0,0 +1,166 @@
+# Microfunction Rehberi
+
+Microfunction, kullanıcının yazdığı **tek bir fonksiyonun** platformun dışında, kendi
+runtime'ında koşmasıdır: Node ya da Python kodu kaydedilir, yayınlanır, workflow adımı onu
+çağırır ve çıktısı sonraki adımlara akar. Platformun JavaScript ifade motoru (global function'lar,
+code step) sürecin İÇİNDE koşar; microfunction ise ayrı bir runtime'dadır — bu yüzden ağır iş,
+üçüncü parti kütüphane ve zaman aşımı riski taşıyan işler oraya taşınır.
+
+Kayıtlar **proje + environment** kapsamlıdır (`development` ile `production` ayrı kayıtlardır);
+`microfunction_list` bir uygulamaya değil projeye bakar. Süzme ve sayfalama uçta yapılır:
+`searchTerm` ad, slug ve açıklamada arar, `status` durum süzgecidir, `pageIndex`/`pageLength` sayfa
+verir (gateway kendi çağrısında 200 gönderir; platform varsayılanı 10'dur).
+
+## Ne zaman microfunction, ne zaman code step
+
+| İhtiyaç | Doğru yer |
+|---|---|
+| Birkaç satır dönüşüm, alan eşleme, koşul | `code` step / ifade (aynı süreç, en ucuz) |
+| İfadelerde çıplak adla çağrılacak yardımcı | global function (`global_function_create`, JS) |
+| Kütüphane gerektiren iş (kriptografi, PDF, görüntü, parse) | microfunction (zip kaynak) |
+| Python gereken iş | microfunction — platformun ifade motoru YALNIZ JavaScript'tir |
+| Uzun süren/CPU yiyen iş | microfunction (kendi bütçesi, API sürecini bloke etmez) |
+
+Global function'lar JS'tir ve Python fonksiyonlarına bağlanmaz; microfunction çağrısı yalnız
+workflow adımından (ve test için `microfunction_invoke`'tan) yapılır.
+
+## Çalışma zamanı sözleşmesi (protocol 1)
+
+Kullanıcı kodu **tek bir handler** dışa aktarır. Inline kaynakta dosya adı SABİTTİR: Node'da
+`function.js`, Python'da `function.py`; entrypoint `function.handler`'dır ve gönderilmez.
+
+```js
+// node — function.js
+exports.handler = async (args, context) => {
+  return { total: args.a + args.b, environment: context.environment }
+}
+```
+
+```python
+# python — function.py
+def handler(args, context):
+    return {"total": args["a"] + args["b"], "environment": context["environment"]}
+```
+
+- `args` — adımın `rule.expression`'ından üretilen argüman nesnesi. Fonksiyonun
+  `parameterDtoId`'si yoksa `{}` gelir.
+- `context` — **salt okunur anlık görüntü**. İçine yazmak hiçbir şeyi değiştirmez; akışa dönen
+  tek kanal fonksiyonun DÖNÜŞ DEĞERİdir.
+
+`context` şekli (ölçüldü, `MicrofunctionStep.BuildContext`):
+
+```jsonc
+{
+  "input": {},                    // akışın parameterDto girdisi
+  "variables": {},                // workflow değişkenleri (middleware'in kurduğu 'user' dahil)
+  "steps": { "<adım adı>": { "data": {}, "error": { "code": null, "message": null, "type": null } } },
+  "user": { "id": "…", "email": "…", "roles": [] },
+  "request": { "headers": {}, "queryString": {} },
+  "triggerSource": {},
+  "language": "tr",
+  "project": "<proje slug'ı>",
+  "environment": "development"
+}
+```
+
+**`request` yalnız `headers` + `queryString` taşır** ve `authorization` · `cookie` ·
+`x-impersonated-user-id` başlıkları AYIKLANIR (ölçüldü 2026-09-10) — token'ı fonksiyona taşımaya
+çalışmayın, taşınmaz. Çerez okuma yolu yoktur.
+
+Yanıt zarfını shim üretir; `microfunction_invoke` bunu olduğu gibi döner:
+
+```jsonc
+{ "protocol": 1, "ok": true, "output": { "total": 3 }, "error": null, "logs": [], "durationMs": 12 }
+```
+
+- `ok: false` ⇒ `error: { type, message, stack }` ve adım **fail dalına** düşer.
+- `logs` yalnız `preview: true` çağrılarında dolar (`console.log` / `print` yakalanır). Normal
+  koşumda log toplanmaz — hata ayıklarken `microfunction_invoke(preview: true)` kullanın.
+- İstek gövdesi (args + context) 5 MB'ı aşarsa adım `MicrofunctionPayloadTooLargeException` ile
+  fail dalına düşer: bütün tabloyu fonksiyona geçirmeyin, işi fonksiyona taşıyacak kadarını geçirin.
+
+## Yaşam döngüsü: kayıt yayınlanmadan ÇALIŞMAZ
+
+```
+draft ──publish──▶ publishing ──▶ published ──update──▶ published + hasUnpublishedChanges
+                        └────────▶ publish-failed (publishError)
+```
+
+1. `microfunction_create` kaydı **draft** açar. `publish: true` verirseniz aynı çağrıda yayın istenir.
+2. Yayın **asenkrondur**: çağrı `publishing` döner, kuyruk paketi runtime'a kurar ve bir `probe`
+   çağrısıyla duman testi yapar. Sözdizimi/import hatası **yayın anında** `publish-failed` olur —
+   koşumda değil. Durumu `microfunction_get` ile birkaç saniye arayla okuyun.
+3. Yayındaki kaydı `microfunction_update` ile değiştirirseniz runtime **ESKİ sürümü koşmaya
+   devam eder**: `hasUnpublishedChanges: true` olur (`revision` ≠ `publishedRevision`). Yeni kodu
+   canlıya almak için `microfunction_publish`.
+4. `microfunction_delete` runtime'daki fonksiyonu da kaldırır; bir workflow adımı kaydı
+   kullanıyorsa 400 ile reddedilir.
+
+## Workflow adımı (WF-MF-001)
+
+Adım tipi `microfunction`; `workflow`, `automation` ve `middleware` akışlarının hepsinde
+kullanılabilir. Kuralı iki alan taşır:
+
+```jsonc
+{
+  "id": "<GUID>",
+  "name": "toplam",
+  "type": "microfunction",
+  "description": "İki sayıyı microfunction'da toplar.",
+  "rule": {
+    "microfunctionId": "<published kaydın id'si>",
+    "expression": "({ a: input.a, b: input.b })"
+  },
+  "branches": [
+    { "id": "<GUID>", "name": "success", "type": "success", "nextStepId": "<sonraki adım>" },
+    { "id": "<GUID>", "name": "fail", "type": "fail", "nextStepId": "<hata adımı>" }
+  ]
+}
+```
+
+- `microfunctionId` **zorunludur** ve gateway kaydı çağrıdan önce okur: durum `published` değilse
+  (ya da kayıt o ortamda yoksa) istek platforma GÖNDERİLMEZ. Adım taslak bir fonksiyona bağlıysa
+  akış kaydedilir, koşar ve sessizce fail dalına düşer (`MicrofunctionNotPublishedException`) —
+  ön-denetimin varlık sebebi budur.
+- `expression` argüman nesnesini üreten JavaScript ifadesidir; şemayı `microfunction_get`
+  çıktısındaki `parameterScheme` verir. Fonksiyonun parametre DTO'su varken ifade boşsa gateway
+  uyarır (fonksiyon `args` içinde hiçbir alan göremez).
+- Çıktı sonraki adımlara `Steps.<adım adı>.data` ile akar; şemasını `returnDtoId` belirler.
+- Adım **senkrondur**: akış fonksiyon dönene kadar bekler. Zaman aşımı fonksiyonun
+  `timeoutSeconds` bütçesidir, aşılırsa fail dalı.
+- `workflow_preview` adımı GERÇEK runtime'da koşturur; preview'ın rollback garantisi fonksiyonun
+  dış dünyada yaptığı işi geri ALMAZ.
+
+Tam gövde örneği: `ngapps://examples/microfunction-node-sum`.
+
+## Built-In ve AWS Lambda farkı
+
+| | `built-in` | `aws-lambda` |
+|---|---|---|
+| Nerede koşar | Platformun kendi Fission kümesi | Müşterinin AWS hesabı |
+| Runtime kaydı | YOK — `runtimeId` verilmez | `microfunction_runtime_create` ile zorunlu |
+| Zaman aşımı tavanı | 300 s | 900 s |
+| `memoryMb` | kaydedilir, küme limiti geçerlidir | gerçekten uygulanır |
+| Ölçüm alanları | `billedDurationMs`/`memoryUsedMb` boş | Lambda raporundan dolar |
+
+`azure-functions` enum'da tanımlıdır ama v1'de reddedilir (Faz 2). Lambda hesabı kimlik
+bilgilerini düz metin tutar (Datasource emsali) ve DTO'da maskeli döner — dar yetkili bir IAM
+kullanıcısı verin, `roleArn` fonksiyonun koşacağı execution rolüdür ve **zorunludur** —
+deseni tutmayan hesap gateway'de durur (MFR-001, block). Kaydettikten sonra
+`microfunction_runtime_test_connection` ile doğrulayın.
+
+## Sınırlar (v1)
+
+- **Bağımlılık build'i yok:** inline kod yalnız standart kütüphanedir; bağımlılık zip içinde gelir.
+- **MCP'den zip yükleme ve indirme yok** (`sourceKind: 'archive'` kaydı açılabilir, dosya
+  Studio'dan yüklenir) — Faz 2. Yüklenmiş zip platform ucunda okunabilir durumdadır
+  (`GET /{proje}/microfunctions/{id}/archive`, `application/zip`) ve Studio inspector'ında bir
+  indirme düğmesi taşır.
+- `timeoutSeconds` ve `memoryMb` komutta non-nullable int'tir: **göndermezseniz 0 gider ve platform
+  422 döner.** Gateway değer uydurmaz, eksikliği çağrıdan önce söyler (MF-001, block; ürün
+  varsayılanları 30 / 256). Aynı kural provider ↔ `runtimeId` eşleşmesini, inline kaynakta `code`
+  zorunluluğunu ve env anahtarlarını da çağrıdan önce denetler.
+- Env değişkenleri düz metin saklanır; anahtar `^[A-Z_][A-Z0-9_]*$`, toplam ≤ 4 KB. Sır yönetimi
+  için kullanmayın.
+- Asenkron (fire-and-forget) çağrı, preview ekranı, microservice'in doğrudan microfunction kaynağı
+  olması ve metering Faz 2'dedir.

package/dist/resources/guides/microservice.md

@@ -188,9 +188,12 @@ DTO'dan süzülmez (WF-026 — `platform_guide('workflow')` §Hata yolu). Sözle
   `ArgumentNullException(key)`, farklı alias verilirse "missing FROM-clause entry" gelir.
 - `sort` ve `limit` **her zaman** verilir (MS-008, block) — aşağıya bak.
 - Filtrelerde `value` bir **JavaScript ifadesidir** — sabit metin tırnak içinde
-  (`"'ACTIVE'"`), dinamik değer ifade olarak (`"input.status"`).
+  (`"'ACTIVE'"`), dinamik değer ifade olarak (`"input.status"`). **İki operatör bunun dışındadır:**
+  `isnull` ve `isnotnull` değer taşımaz — `value` verilmez, `source` da zorunlu değildir; verirsen
+  platform yok sayar, doğrulama da değer beklemez.
 - **Operatör sözlüğü kapalıdır:** `eq · neq · lt · lte · gt · gte · contains · icontains ·
-  in · notin · startswith · endswith · istartswith · iendswith`. **`like` YOKTUR** — metin
+  in · notin · startswith · endswith · istartswith · iendswith · isnull · isnotnull`.
+  **`like` YOKTUR** — metin
   araması `contains`/`icontains` iledir. Kritik tuzak: platform bilinmeyen operatörü 400 ile
   reddetmez, **sessizce `eq`'e düşürür** (enum çözümlemesi unknown'da default'a düşer) — uç
   testten geçer ama arama hiçbir şey döndürmez. Gateway MS-012/WF-015 bunu istek gitmeden keser.
@@ -531,6 +534,62 @@ kabul etti. Ayrıntı ve doğru rol kapısı tarifi: `platform_guide('middleware
 > rota `/{project}/m/{application}/{microservice SLUG'ı}`'dır ( `url` alanı rotaya GİRMEZ) ve
 > `Host: <org>.<suffix>` + `X-Environment` başlıkları zorunludur.
 
+## Alias nerede geçerli
+
+Alias bir **SQL tablo takma adıdır**: yalnız okunan tarafta anlamı vardır. Sözleşme iki ayrı
+tiple modellenmiştir ve ikisi karıştırılırsa alan sessizce düşer.
+
+| Yer | Tip | Alanlar |
+|---|---|---|
+| `selectFields[]` · `returnFields[]` | `TableSelect` | `alias` · `fieldId` · `path` · `fieldSlug` |
+| `filters[]` · `joins[]` | filtre/join | `alias` (+ kendi alanları) |
+| `sourceParameters.alias` | kök alias | join varken ZORUNLU, kök entity'nin slug'ı |
+| **`fields[]` (yazılacak alanlar)** | `TableField` | `fieldId` · `source` · `value` · `folderId` · `order` · `writeOn` — **`alias` YOK** |
+
+`fields[]` yalnız `create` / `update` / `upsert` operasyonlarında bulunur ve WHERE değil SET
+üretir: hangi tabloya yazılacağı zaten `entityId` ile bellidir, takma ada ihtiyaç yoktur. Aynı
+`TableField` tipi workflow table adımlarının `rule.fields[]` listesinde de kullanılır.
+
+Yazma alanına `alias` koyarsan istek **hata vermez**, alan model bağlamada düşer. Gateway bunu
+istek gitmeden gövdeden çıkarır ve `gatewayNormalized` ile bildirir — böylece `silentlyDropped`
+listesi yalnız gerçek kayıpları gösterir.
+
+## Zamanlanmış iş (`type: 'schedule-job'`) — `typeParameters.schedule`
+
+Zamanlama tek bir tanımdır; `cronExpression` tek başına verilirse **UTC cron** sayılır (eski gövde).
+Yeni işte tanımı `typeParameters.schedule` ile yazın ve kaydetmeden önce
+`microservice_schedule_forecast` ile sıradaki koşuları görün.
+
+| Alan | Değer |
+|---|---|
+| `mode` | `once` · `interval` · `cron` |
+| `timeZoneId` | IANA (`Europe/Istanbul`); yoksa `UTC`. Saatler BU dilimde yorumlanır |
+| `startAt` | yerel tarih-saat, dilimsiz (`2026-09-14T09:00:00`); once/interval için, cron'da `end.type:'after'` ile zorunlu |
+| `every` · `unit` | 1–1000 · `minute` `hour` `day` `week` `month` |
+| `timeOfDay` | `HH:mm` — `day`/`week`/`month` için zorunlu |
+| `daysOfWeek` | `monday`…`sunday` — `week` için en az bir |
+| `daysOfMonth` | 1–31, `-1` = ayın son günü — `month` için en az bir |
+| `cronExpression` | Quartz cron (6–7 alan, `?` zorunlu) — yalnız `cron` modu |
+| `end` | `{type:'never'}` · `{type:'on', at}` · `{type:'after', count}` (1–10000) |
+
+```json
+{ "mode": "interval", "timeZoneId": "Europe/Istanbul", "startAt": "2026-09-14T00:00:00",
+  "every": 2, "unit": "week", "daysOfWeek": ["tuesday", "thursday"], "timeOfDay": "09:00",
+  "end": { "type": "after", "count": 30 } }
+```
+
+- Aralık başlangıçtan sayılır: "7 dakikada bir" saat başında sıfırlanmaz, "3 günde bir" ay sonunda
+  başa sarmaz, "2 haftada bir" gerçekten iki haftada birdir. Cron'da bunlar DOĞRU İFADE EDİLEMEZ
+  (`MON/2` = haftada 3 gün) — bu ihtiyaçlar için `interval` kullanın.
+- `after N` başlangıçtan hesaplanan N'inci koşuda biter; `microservice_schedule_control trigger`
+  sayılmaz. Biten iş `microservice_schedule_get`'te `state: 'ended'` görünür.
+- Geçersiz tanım `422` + alan adıyla lokalize mesaj döner (bozuk cron artık `500` değil). `after` ile
+  toplam süre sınırlıdır (gün × sayı ≤ 36500, hafta ≤ 5200, ay ≤ 1200).
+- **`schedule` ile `cronExpression` çelişemez.** `microservice_get` ikisini de döndürür; güncellemede
+  yalnız `typeParameters.schedule`'ı değiştirin (cron modunda `schedule.cronExpression`). Yalnız
+  `cronExpression`'ı değiştiren PUT/PATCH `422 ScheduleCronConflict` alır — sessizce eski cron
+  kalmaz. `typeParameters: null` işi zamanlayıcıdan siler.
+
 ## Sık hatalar
 
 - `description` boş (MS-014, block — uç listesinde ne işe yaradığı okunamaz)

package/dist/resources/guides/modify-existing.md

@@ -25,6 +25,29 @@ yeniden yazımlarda.
   `view:'part'` ile doğrulayarak yaz.
 - Silme yerine `replace` tercih et; `remove` kullanacaksan önce o path'i `part` ile görüntüle.
 - Yanıttaki outline özeti değişikliğin uygulandığı hâli gösterir — teyit için oku.
+- **Kullanıcı fonksiyonunda patch aracı yok:** `function_update` tam gövde yazar ama vermediğin
+  alanları mevcut kayıttan doldurur — yalnız `body` göndermen yeter (fonksiyonun tek büyük alanı
+  gövdedir). Adı değiştirmeden önce `dependency_graph` (`module:'ui-function'`) ile çağıranları
+  bul: `{{ }}`/`code` ifadelerindeki `Functions.<eskiAd>(` çağrıları metinseldir ve kırılır.
+
+## Değiştirmeden önce geçmişe bak
+
+Platform her tanım yazmasını append-only bir deftere düşürür. Bir kaydı değiştirmeden önce son
+revizyonunu okumak, başka birinin işinin üstüne yazmayı önler:
+
+```
+revision_list {projectId, module:'page', recordId, pageLength: 3}
+  → son satırda revisionNo, operation, actor ve source
+revision_diff {projectId, module:'page', recordId}
+  → son iki sürüm arasındaki alan bazlı fark + summaryText
+```
+
+`source` işin nereden geldiğini söyler: `mcp` bu gateway'in kendi izidir, `studio` bir insanın
+Studio'da yaptığıdır, `merge` / `deployment` / `template` / `revert` ise taşıma yollarıdır.
+Son revizyon `studio` ise ve dakikalar önceyse, üstüne yazmadan önce kullanıcıya sor.
+
+Gövdenin tamamı gerekirse `revision_get {projectId, id}` — ama büyük sayfalarda MB'lar tutar ve
+yanıt kırpılabilir; ne değiştiğini anlamak için `revision_diff` yeter.
 
 ## Uyum kuralları
 

package/dist/resources/guides/page.md

@@ -479,7 +479,7 @@ Tarif: `platform_guide('middleware')`.
 
 **Sözlükler** (`StepType.cs`, `StepParameterValueType.cs` — hepsi küçük harf):
 `start · microservice · setter · setcookie · validation · condition · redirect · alert ·
-confirm · flow-trigger · storage · navigate · code · download · end`
+confirm · flow-trigger · storage · navigate · code · download · function · end`
 değer tipleri: `static · page · property · storage · variable · code · item · state`
 
 > **Sözlükte olmak KOŞACAĞI anlamına gelmez — koşan tipler barındırıcıdan gelir.** Motor yedi
@@ -490,7 +490,7 @@ değer tipleri: `static · page · property · storage · variable · code · it
 >
 > | Adım tipi | Web | Mobil | Nerede register ediliyor |
 > |---|---|---|---|
-> | `start` · `setter` · `code` · `condition` · `microservice` · `validation` · `flow-trigger` | ✅ | ✅ | `flow-engine.ts` — motorun kendisi |
+> | `start` · `setter` · `code` · `condition` · `microservice` · `validation` · `flow-trigger` · `function` | ✅ | ✅ | `flow-engine.ts` — motorun kendisi (`function` mobilde kayıtlıdır ama mobil runtime `Functions`'ı boş kurar — K11, çağrı çalışmaz) |
 > | `alert` · `redirect` · `setcookie` · `storage` | ✅ | ✅ | uygulama; mobilde `redirect` navigate, `setcookie` storage uygulamasına eşlenir |
 > | `confirm` · `download` | ✅ | ❌ | yalnız `Runtime.svelte` |
 > | `navigate` | ❌ | ✅ | yalnız `ScreenRuntime.tsx` — web'deki karşılığı `redirect` |
@@ -521,6 +521,14 @@ değer tipleri: `static · page · property · storage · variable · code · it
 > (`Page.*`, komponentlere adıyla erişim, `state.page/app`, `Steps`, `self`/`item`/`event`,
 > `cookie.get/set`, `await`) ve `value.type` çözümleme tablosu için
 > **`platform_guide('expressions')`** — uydurma erişim adı sessizce `undefined` üretir.
+>
+> **`function` adımı ("Call function")** bir kullanıcı fonksiyonunu çağırır: `args: { functionId, functionName,
+> parameters: [{ name, value }] }` — `functionId` zorunlu ve gerçek (`function_list`; FLOW-024 block),
+> `parameters[].name` fonksiyonun bildirimindeki adla eşleşir, `value` şekli `microservice` adımıyla
+> aynıdır. Çıktı `Steps.<adımAdı>.data` (hata `.error.message`), dal `always`. Aynı fonksiyon `code`
+> adımında ve `{{ }}` bağlamasında `Functions.<ad>(…)` ile de çağrılır; gateway bilinmeyen adı ve
+> fazla argümanı FLOW-025 ile uyarır. Tam gövde `ngapps://examples/flow-call-function`, kurallar
+> **`platform_guide('functions')`**.
 
 > Bir microservice adımı kaydedildiğinde platform `args.microserviceSchema`'yı
 > (parameterScheme + returnScheme + `isReturnArray`) kendisi doldurur — `flow_get` ile geri
@@ -812,8 +820,9 @@ kullanır: `page.mappers.ts` `mapPageLayoutToPreview` — layout varsa çizilen
 >
 > Kural: **`isWrapper` yalnız gerçekten sayfa boyu kaplaması gereken kap içindir**
 > (`page_container` böyledir ve öyle kalmalı). Sadece "başlık/çerçeve çizilmesin" diye wrapper
-> yapma — o iş `container` için `style` ile (`background:'transparent'`, `border:'none'`),
-> `form` için `hideBorders`/`hidePadding` prop'larıyla yapılır. **`states` için micro-op
+> yapma — o iş `container` için de `form` için de `style` ile yapılır (`background:'transparent'`,
+> `border:'none'`, `padding:0`). `form`'un eski `hideBorders`/`hidePadding` prop'ları
+> 2026-09-09'da şemadan kaldırıldı — bileşen onları hiçbir zaman okumuyordu, no-op'tu. **`states` için micro-op
 > YOKTUR:** yanlış `isWrapper`'ı düzeltmenin tek yolu düğümü `remove_component` +
 > `add_component` ile yeniden kurmaktır (sonrasında Kural 2'deki flow yeniden kaydetme adımı
 > ZORUNLU olur).
@@ -1129,6 +1138,13 @@ yapmazsan ekran "platform mavisi" görünür; marka rengine çevirmek tek satır
 BÜTÜN girdileri yuvarlar; aynı şeyi komponent komponent `&__input { borderRadius }` yazarak
 yapmak hem uzun sürer hem de yeni komponent eklendiğinde tutarsızlık üretir.
 
+**Koyu tema karesi için sayfada `theme-toggle` bulunması gerekmez.** Ziyaretçinin tema tercihi
+çerezde değil `localStorage`'da (`zeyrek-viewer-theme-mode`) yaşar ve tema store'u onu sayfa
+açılırken bir kez okur; `page_screenshot` `colorScheme: 'dark' | 'light'` parametresi tercihi
+sayfa script'lerinden ÖNCE eker. İki temayı da doğrulamak, tasarıma düğme eklemeden iki çağrıdır
+(aynı tool'un `language` parametresi ikinci dil için aynı işi yapar —
+`platform_guide('translation')`).
+
 ### 1h-3 — Ölçülmüş hazır bloklar (anket ekranından, olduğu gibi kullanılabilir)
 
 ```jsonc

package/dist/resources/guides/translation.md

@@ -123,6 +123,30 @@ Son kullanıcı dili `language-selector` komponentiyle değiştirir (`platform_g
 prop'lar sayfa yenilenmeden yeniden çözülür — ayrı bir akış kurmana gerek yok, komponenti sayfaya
 eklemen yeterli. Projede dil tanımlı değilse (`languages` boşsa) liste boş çizilir.
 
+## Kareyi ikinci dilde almak: `page_screenshot(language:)`
+
+Dil değiştirici **kanıt için gerekli değildir.** Runtime boot dilini şu sırayla seçer:
+`?lang=<kod>` → tarayıcıda kayıtlı seçim → tarayıcı dilleri → projenin varsayılanı
+(`resolveRuntimeLanguage`). `page_screenshot` `language` parametresi adrese o sorgu değerini
+ekler; seçim hem çeviriye bağlı prop'ları hem **çok dilli alanların satır değerlerini** kapsar,
+çünkü aynı değer veri diline de geçirilir.
+
+```jsonc
+{ "applicationSlug": "app", "pageSlug": "dashboard", "language": "en" }
+{ "applicationSlug": "app", "pageSlug": "dashboard", "language": "tr" }   // aynı sayfa, ikinci dil
+```
+
+Bunun pratik sonucu: **referans tasarımına dil değiştirici eklemek zorunda değilsin.** Görsel
+repro'su olan bir ekranı bozmadan iki dilin karesini alabilirsin; `language-selector` yalnız son
+kullanıcı gerçekten dil değiştirecekse gerekir.
+
+- Kod projenin `languages` listesinde değilse çağrı **reddedilir**. Runtime tanımadığı kodu yok
+  sayıp kareyi varsayılan dilde çizerdi ve "çevrildi" sanılan yanlış bir kare rapora girerdi.
+- Bölgeli kod (`tr-TR`) indirgenir ve indirgeme yanıtta `languageNote` ile bildirilir.
+- Aynı tool'un `colorScheme` parametresi ziyaretçinin tema tercihini sayfa açılmadan eker
+  (`localStorage`'daki `zeyrek-viewer-theme-mode`), yani koyu tema karesi için sayfada
+  `theme-toggle` bulunması da gerekmez.
+
 ## İstek dili: nereden gelir, hangi ifadede ne denir
 
 Her istekte dil şu sırayla çözülür: **`X-Data-Language` başlığı → `Accept-Language` → projenin

package/dist/resources/guides/workflow.md

@@ -537,7 +537,7 @@ yolunu değiştirir: kapalı yolu deneyip raporuna "kanıtlayamadım" yazma, kan
 - Join'li table step'inde kök `rule.alias` boş (WF-019, block — Postgres 42601'in sebebi)
 - Akışta hiç okunmayan `selectFields` alanı (WF-023, warn — gereksiz taşınan sütun)
 - Adımda ya da akışta `description` yok (WF-024, block — Studio'da adım okunamaz kalır)
-- İlişki alanının içini okuyan ifade (WF-020, warn — join yoksa alan düz FK'dır)
+- İlişki alanının içini okuyan ifade (WF-020, warn — join yoksa alan düz FK'dır); `Functions.<ad>()` çağrısı SUNUCUDA GEÇERSİZDİR (`WF-030` block, 2026-09-10) — `function_create source:'workflow'` ile tanımla, çıplak adla çağır
 - `set-user` adımı olmadan `user` okuyan middleware (MW-003, warn)
 - Backend zorunlulukları (WF-026, block — istek gitmeden): `name`/`slug`; `returnDtoId` varsa
   `returnBehavior`, `parameterDtoId` varsa `parameterBehavior` (`primitive` | `object` | `array`),

package/dist/resources/schema-fingerprint.json

@@ -1,8 +1,8 @@
 {
-  "hash": "0e6bb2b45f8c545b50dc6d6169e7d816d9cb9532ecbaed894307995d537ff3b6",
-  "generatedAt": "2026-09-09T09:49:52.511Z",
-  "types": 103,
-  "files": 73,
+  "hash": "7702a2d5d690f0d9b1aeab42e9253096f68dfaca040952b07d6c2911f1a37a7f",
+  "generatedAt": "2026-09-14T09:08:38.743Z",
+  "types": 185,
+  "files": 107,
   "note": "Şemaları üreten backend kaynaklarının parmak izi. Elle düzenlemeyin: 'npm run generate-schemas' yazar, 'npm run schema:check' denetler.",
   "missing": []
 }

package/dist/resources/schemas/AnalyzeImportQuery.json

@@ -0,0 +1,51 @@
+{
+  "schema": {
+    "required": [
+      "fileId"
+    ],
+    "type": "object",
+    "properties": {
+      "datasourceId": {
+        "type": "string",
+        "format": "uuid"
+      },
+      "fileId": {
+        "minLength": 1,
+        "type": "string",
+        "format": "uuid"
+      },
+      "locale": {
+        "type": "string",
+        "nullable": true
+      },
+      "headerRow": {
+        "minimum": 0,
+        "type": "integer",
+        "format": "int32",
+        "nullable": true
+      },
+      "csv": {
+        "$ref": "#/components/schemas/NgApps.Application.Contexts.Datastore.Imports.ImportCsvOptionsDto"
+      }
+    },
+    "additionalProperties": false
+  },
+  "components": {
+    "schemas": {
+      "NgApps.Application.Contexts.Datastore.Imports.ImportCsvOptionsDto": {
+        "type": "object",
+        "properties": {
+          "delimiter": {
+            "type": "string",
+            "nullable": true
+          },
+          "encoding": {
+            "type": "string",
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      }
+    }
+  }
+}

package/dist/resources/schemas/ApplyMergePlanCommand.json

@@ -0,0 +1,19 @@
+{
+  "schema": {
+    "type": "object",
+    "properties": {
+      "projectId": {
+        "type": "string",
+        "format": "uuid"
+      },
+      "planId": {
+        "type": "string",
+        "format": "uuid"
+      }
+    },
+    "additionalProperties": false
+  },
+  "components": {
+    "schemas": {}
+  }
+}

package/dist/resources/schemas/CreateBulkRowCommand.json

@@ -23,6 +23,9 @@
           "nullable": true
         },
         "nullable": true
+      },
+      "relationsByName": {
+        "type": "boolean"
       }
     },
     "additionalProperties": false

package/dist/resources/schemas/CreateEnvironmentCommand.json

@@ -0,0 +1,31 @@
+{
+  "schema": {
+    "required": [
+      "name"
+    ],
+    "type": "object",
+    "properties": {
+      "projectId": {
+        "type": "string",
+        "format": "uuid"
+      },
+      "name": {
+        "minLength": 1,
+        "pattern": "\\A(?=.{3,31}\\z)[a-z][a-z0-9_-]*(/[a-z0-9][a-z0-9_-]*)*\\z",
+        "type": "string"
+      },
+      "parentEnvironmentId": {
+        "type": "string",
+        "format": "uuid",
+        "nullable": true
+      },
+      "includeRecords": {
+        "type": "boolean"
+      }
+    },
+    "additionalProperties": false
+  },
+  "components": {
+    "schemas": {}
+  }
+}

package/dist/resources/schemas/CreateGlobalFunctionCommand.json

@@ -0,0 +1,95 @@
+{
+  "schema": {
+    "required": [
+      "body",
+      "name",
+      "source"
+    ],
+    "type": "object",
+    "properties": {
+      "source": {
+        "$ref": "#/components/schemas/NgApps.Domain.Contexts.Studio.GlobalFunctions.GlobalFunctionSource"
+      },
+      "applicationId": {
+        "type": "string",
+        "format": "uuid",
+        "nullable": true
+      },
+      "pageId": {
+        "type": "string",
+        "format": "uuid",
+        "nullable": true
+      },
+      "scope": {
+        "$ref": "#/components/schemas/NgApps.Domain.Contexts.Studio.GlobalFunctions.GlobalFunctionScope"
+      },
+      "name": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "description": {
+        "type": "string",
+        "nullable": true
+      },
+      "isAsync": {
+        "type": "boolean"
+      },
+      "parameters": {
+        "type": "array",
+        "items": {
+          "$ref": "#/components/schemas/NgApps.Application.Contexts.Studio.GlobalFunctions.GlobalFunctionParameterDto"
+        },
+        "nullable": true
+      },
+      "body": {
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "additionalProperties": false
+  },
+  "components": {
+    "schemas": {
+      "NgApps.Domain.Contexts.Studio.GlobalFunctions.GlobalFunctionSource": {
+        "enum": [
+          "workflow",
+          "studio"
+        ],
+        "type": "string",
+        "format": ""
+      },
+      "NgApps.Domain.Contexts.Studio.GlobalFunctions.GlobalFunctionScope": {
+        "enum": [
+          "application",
+          "page"
+        ],
+        "type": "string",
+        "format": ""
+      },
+      "NgApps.Application.Contexts.Studio.GlobalFunctions.GlobalFunctionParameterDto": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "nullable": true
+          },
+          "type": {
+            "type": "string",
+            "nullable": true
+          },
+          "required": {
+            "type": "boolean"
+          },
+          "defaultValue": {
+            "nullable": true
+          },
+          "description": {
+            "type": "string",
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      }
+    }
+  }
+}