@appaflytech/zeyrek-ai-mcp 0.0.52 → 0.0.54

package/dist/tools/screenWrite.js

@@ -4,6 +4,7 @@ import { FUNCTIONS_NAMESPACE } from '../knowledge/functionGuards.js';
 import { reservedExpressionName } from '../knowledge/expressionPrelude.js';
 import { applyCatalogLayoutRules, applyCatalogLayoutRulesFrom, fetchCatalogComponents } from './components.js';
 import { PlatformApiError } from '../platform/errors.js';
+import { closestNames } from '../platform/argumentAliases.js';
 const GUARD_CODES = {
     page: { events: 'PAGE-011', widgets: 'PAGE-012', noun: 'sayfa', tree: 'schema' },
     layout: { events: 'LAY-004', widgets: 'LAY-005', noun: 'layout', tree: 'views' },
@@ -102,7 +103,8 @@ export async function screenCatalogNotes(platform, project, environment, applica
  *
  * Neden yalnız bu yollarda: micro-op ucunda platformun kendi doğrulama duvarı zaten koşuyor
  * (`invalid-enum-value` · `unknown-prop` · `invalid-appearance`), tam şema PUT/POST'unda ise
- * koşmuyordu — aynı geçersiz değer bir yoldan 400, öbüründen 200 dönüyordu. Katalog okunamazsa
+ * koşmuyordu — aynı geçersiz değer bir yoldan 400, öbüründen 200 dönüyordu. Micro-op ucunda gateway
+ * yalnız tanınmayan prop'u önden adlandırır (`unknownPropOps`, g-21); enum ve görünüm kararı platformda kalır. Katalog okunamazsa
  * doğrulama susar ve yazma eskisi gibi geçer: bilinmeyen sözlük yüzünden geçerli bir gövdeyi
  * bloklamak, denetimi atlamaktan kötüdür.
  */
@@ -116,3 +118,107 @@ export async function assertScreenCatalog(platform, project, environment, applic
     const catalog = applyCatalogLayoutRulesFrom(components, nodes);
     return [...blockSizeNote(catalog.clamped), ...heightTypeNote(catalog.heights), ...sizeStringNote(catalog.sizes), ...droppableStatesNote(catalog.states)];
 }
+/** Düğümün `props[prop]`'unu yazan op'lar (`PageSchemaMicroOpApplier.cs` `replace_prop` · `set_binding` · `set_prop_type`). */
+const PROP_WRITING_OPS = new Set(['replace_prop', 'set_binding', 'set_prop_type']);
+function registerInstances(nodes, parent, byId) {
+    return (Array.isArray(nodes) ? nodes : []).flatMap(node => {
+        if (!node || typeof node !== 'object')
+            return [];
+        const record = node;
+        const instance = { type: typeof record.type === 'string' ? record.type : undefined, parent, children: [], removed: false };
+        instance.children = registerInstances(record.children, instance, byId);
+        if (typeof record.elementId === 'string')
+            byId.set(record.elementId, instance);
+        return [instance];
+    });
+}
+function detach(instance) {
+    if (instance.parent)
+        instance.parent.children = instance.parent.children.filter(child => child !== instance);
+}
+function markRemoved(instance) {
+    instance.removed = true;
+    instance.children.forEach(markRemoved);
+}
+function collectSavedProps(nodes, into) {
+    for (const node of Array.isArray(nodes) ? nodes : []) {
+        if (!node || typeof node !== 'object')
+            continue;
+        const record = node;
+        if (typeof record.elementId === 'string' && record.props && typeof record.props === 'object') {
+            for (const prop of Object.keys(record.props))
+                into.add(`${record.elementId}/${prop}`);
+        }
+        collectSavedProps(record.children, into);
+    }
+}
+/**
+ * g-21 (D-21, plans/defter-saha-bulgulari) — micro-op yamasında tanınmayan prop'un ön denetimi. Platform
+ * `PageSchemaValidator.cs` `ValidateProp` aynı kararı `unknown-prop` ile verir ama BÜTÜN yamayı reddeder ve hangi op
+ * olduğunu ajan hata metninden ayıklar (Defter: `app-bar`'da `ariaLabel`). Burada op'un sırası, hedefi ve
+ * komponentin en yakın üç prop adı istek gitmeden söylenir; yama yine bütün reddedilir (op'u sessizce düşürmek
+ * yazanın beklediğini değiştirirdi). Sözlük `assertScreenCatalog`'unkiyle aynıdır (`GET /components/{app}`, yalnız
+ * üst düzey prop'lar) ve aynı kuralla susar: katalog okunamazsa, hedefin tipi bilinmiyorsa ya da tip katalogda
+ * yoksa op denetlenmez. Kayıtlı ağaç yalnız prop yazan op varsa okunur. `ops` batch zarfı açılmış listedir; indeks o
+ * listeye göredir.
+ *
+ * Platformdan GENİŞ reddetmemek için iki kural (g-21 incelemesi): (1) Kayıtlı düğüm prop'u zaten taşıyorsa karar
+ * platformundur — `ValidateProp` kayıtlı ağaçta aynı değerle duran tanımsız prop'u muaf tutar (`savedProps`) ve aynı
+ * yazım `noop`'tur (`PatchPageSchemaCommand.cs`). (2) Op'lar platformun uyguladığı SIRAYLA yürünür: hedefin tipi o
+ * andaki düğümünkidir (`add_component` ekler, `remove_component` alt ağacıyla siler, `move_component` taşır) ve aynı
+ * yamada sonra silinen düğüme yazan op denetlenmez — silinen düğüm doğrulanacak son ağaçta yoktur.
+ */
+export async function unknownPropOps(platform, project, environment, applicationId, savedNodes, ops) {
+    if (!ops.some(entry => PROP_WRITING_OPS.has(String(entry.op)) && typeof entry.prop === 'string'))
+        return [];
+    const rules = catalogTypeRules(await fetchCatalogComponents(platform, project, environment, applicationId).catch(() => []));
+    if (rules.size === 0)
+        return [];
+    const nodes = await savedNodes().catch(() => []);
+    const byId = new Map();
+    const savedProps = new Set();
+    const writes = [];
+    registerInstances(nodes, undefined, byId);
+    collectSavedProps(nodes, savedProps);
+    ops.forEach((entry, index) => {
+        const target = typeof entry.target === 'string' ? entry.target : undefined;
+        if (entry.op === 'add_component') {
+            const parent = typeof entry.parent === 'string' ? byId.get(entry.parent) : undefined;
+            const added = registerInstances([entry.component], parent, byId);
+            parent?.children.push(...added);
+        }
+        else if (entry.op === 'remove_component' && target !== undefined) {
+            const instance = byId.get(target);
+            if (instance) {
+                detach(instance);
+                markRemoved(instance);
+                byId.delete(target);
+            }
+        }
+        else if (entry.op === 'move_component' && target !== undefined) {
+            const instance = byId.get(target);
+            const parent = typeof entry.parent === 'string' ? byId.get(entry.parent) : undefined;
+            if (instance) {
+                detach(instance);
+                instance.parent = parent;
+                parent?.children.push(instance);
+            }
+        }
+        else if (PROP_WRITING_OPS.has(String(entry.op)) && target !== undefined && typeof entry.prop === 'string') {
+            const instance = byId.get(target);
+            if (instance)
+                writes.push({ index, entry, target, prop: entry.prop, instance });
+        }
+    });
+    return writes.flatMap(({ index, entry, target, prop, instance }) => {
+        const type = instance.type;
+        const declared = type === undefined ? undefined : rules.get(type)?.props;
+        if (instance.removed || declared === undefined || declared.has(prop) || savedProps.has(`${target}/${prop}`))
+            return [];
+        const closest = closestNames(prop, [...declared.keys()], 3);
+        return [{
+                op: entry,
+                message: `ops[${index}] ${target}.${prop} — '${type}' komponentinin '${prop}' diye bir prop'u yok; en yakın: ${closest.join(' · ')}. Bütün liste component_get('${type}') ile okunur.`
+            }];
+    });
+}

package/dist/tools/variables.js

@@ -9,7 +9,7 @@ const variablesParam = z.array(z.object({
     key: z.string().min(1).describe("Değişken adı; sayfada state.page.<key> ile okunur"),
     value: z.unknown().describe('Herhangi bir JSON değeri; nesne verirseniz alanlarına state.page.<key>.<alan> ile erişilir'),
     storage: z.enum(['memory', ...STATE_STORAGE_KINDS]).optional()
-        .describe("Değerin yaşadığı yer (yalnız mobil uygulamada uygulanır, MOB-014). Verilmezse kayıttaki tür korunur; yeni değişkende bellektir — state her sayfa açılışında buradaki value'dan başlar. 'device': cihaz deposu (AsyncStorage karşılığı), uygulama kapanıp açılınca son yazılan değer geri gelir. 'secure': güvenli depo (expo-secure-store), token gibi gizli ve küçük değerler için. 'memory': türü kaldırır. Çıkışta ikisi de silinir.")
+        .describe("Değerin yaşadığı yer (yalnız mobil uygulamada uygulanır, MOB-014). Verilmezse kayıttaki tür korunur; yeni değişkende bellektir — state.page her sayfa açılışında buradaki value'dan başlar; mobil kabukta state.app uygulama başına tek bellek deposudur (açılan sayfanın value'su yalnız depoda olmayan anahtarı doldurur, kök ADR 0031). 'device': cihaz deposu (AsyncStorage karşılığı), uygulama kapanıp açılınca son yazılan değer geri gelir. 'secure': güvenli depo (expo-secure-store), token gibi gizli ve küçük değerler için. 'memory': türü kaldırır. Çıkışta ikisi de silinir.")
 })).min(1).describe("Değişken listesi: [{ key: 'MyTest', value: { isActive: true } }]. Gateway bunu platformun beklediği JSON string'e çevirir.");
 const replaceParam = z.boolean().optional()
     .describe('true: seti komple bunlarla değiştir (diğer değişkenler silinir). Varsayılan false — gateway mevcut setle birleştirir.');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appaflytech/zeyrek-ai-mcp",
-  "version": "0.0.52",
+  "version": "0.0.54",
   "type": "module",
   "description": "Zeyrek (NgApps) platform APIs as MCP tools — data, logic and Studio design surface in one gateway",
   "license": "UNLICENSED",

package/dist/resources/guides/mobile-flow.md

@@ -1,64 +0,0 @@
-# Mobil akış adımları rehberi
-
-Mobil uygulamada (`type:'mobile'`) akış motoru web'deki motorun aynısıdır (`platform_guide('page')`, `flow_create`).
-Bu rehber yalnız barındırıcıya — cihaza — dokunan adımların telefondaki sözleşmesini ve tariflerini anlatır.
-Ekranın kendisi, sayfa olayları (`mount` · `focus` · `destroy`) ve uzak push `platform_guide('mobile')`'dadır.
-
-## Adımlar
-
-Motorun kendi adımları (`setter`, `condition`, `microservice`, `code`, `function`, `flow-trigger`,
-`validation`) iki platformda aynıdır. Barındırıcıya dokunan adımlar:
-
-| Adım | Mobilde |
-|---|---|
-| `redirect` | yığına iter (göreli yol) ya da dışarıda açar (tam adres) |
-| `navigate` | eski mobil şemaların adı — `redirect`'in takma adıdır; gateway `redirect`'e çevirir |
-| `alert` | tipli uyarı (`success`/`error`/`info`/`warning`) toast'tur ve beklemez; düz uyarı onay bekler. `message`/`description` metin şablonudur (`"{{ t('kayit.tamam') }}"`; `platform_guide('page')` §alert). Eylem düğmeli bildirim ("Silindi · Geri al") `alert`le kurulmaz: sayfaya bir `toast` bileşeni koyun (`actions: [{ text, flow }]`, gerekirse `keepOpen`), akış setter'la `isOpen: true` yazar; basış eylemin kendi akışını koşar (`actionClick { text, index }`) |
-| `confirm` | `yes` / `no` dalları; `message`/`title`/`confirmText`/`cancelText` metin şablonudur (`{{ }}`, çeviri `t('anahtar')`) |
-| `download` | adres cihazın açma sayfasında açılır; ikili gövde (JSON değil) önbelleğe dosya olarak yazılıp paylaşım sayfasında (`expo-sharing`) açılır, Studio mobil önizlemesi dosyayı indirir (`MOB-005`, bilgi) |
-| `storage` | `args.name` `state.page.<key>` / `state.app.<key>` ise o state'i yazar (`platform_guide('mobile')` §Kalıcı state), değilse cihaz deposuna |
-| `setcookie` | güvenli cihaz deposuna (SecureStore) yazar; değer sonraki her istekte `X-Flow-Cookie` başlığıyla gider ve middleware/workflow onu web'deki gibi `cookie.<ad>` olarak okur — `Cookie` başlığıyla gitmez, çünkü iOS onu yerel çerez kavanozuyla virgülle birleştirip bozuyordu (`MOB-005`, bilgi); aynı adlı sunucu çerezi varsa o kazanır. Studio paleti mobilde de sunar |
-| `share` | RN paylaşım sayfası (metin + bağlantı; Android'de bağlantı metne eklenir, `title` iOS'ta e-posta konusu, Android'de seçici başlığı); akış `always` ile sürer — iOS'ta sayfa kapanınca, Android'de seçici açılır açılmaz (RN kapanışı bildirmez). Argümanlar `platform_guide('page')` §`share` adımı |
-| `haptic` | dokunsal geri bildirim (`expo-haptics`, izin istemez). `args.value` stil, **düz metin**: `success` · `warning` · `error` · `light` · `medium` · `heavy` · `selection`; boş → `medium`. Değer yazmaz, hep `always`. Web'de titreşim varsa kısa titreşim, yoksa hiçbir şey (paletten yalnız mobilde sunulur) |
-| `location` | cihaz konumu (`expo-location`; ilk kullanımda izin sorulur; derleme konumu taşımıyorsa sorulmaz, `error` dalı `status: 'unavailable'`). `args.value` doğruluk, düz metin: `low` · `balanced` · `high` (boş → `balanced`); `args.isRaw: true` → adres çözülmez. Sonuç `Steps.<adım>.data = { latitude, longitude, accuracy, address }`, `address = { country, region, subregion, city, district, street, postalCode }` ya da `null` (Türkiye'de il `region`, ilçe `subregion`, yoksa `city`). İzin reddi `Steps.<adım>.error = { status: 'denied', message }`, okunamayan konum `unavailable`: adımın `error` dalı bağlıysa o koşar (`always` koşmaz), yoksa akışın hata akışı, o da yoksa `always` (`data: null`). Web'de tarayıcı konumu, adres hep `null` |
-| `notification-permission` | bildirim izni ister (sorulmuşsa yeniden sormaz, kalıcı red yeniden sorulmaz). Sonuç `Steps.<adım>.data.status`: `granted` · `denied` · `undetermined`; red hata değildir, hep `always` |
-| `notification-schedule` | yerel bildirim planlar (`expo-notifications`; uzak push değil). `args.name` kimlik ve `args.title` başlık **metin şablonudur** — yalnız `{{ }}` içi çözülür (`'ilac-{{ item.id }}-0800'` kayıt başına ayrı kimlik, `"{{ t('ilac.vakti') }}"` çeviri; `{{ }}` dışındaki ifade çözülmez, FLOW-022); aynı kimlik eskisinin yerini alır. `args.message` gövde (**ifade**), `args.value` zaman (**ifade**): sonucu `'HH:mm'` → her gün, `{ weekday: 1–7, time: 'HH:mm' }` → her hafta (1 = Pazartesi), ISO tarih-saat → bir kez. `args.path` dokununca açılacak sayfanın slug'ı, düz metin — şablon çözmez (+ `args.query` ifade), boşsa uygulama açılır. İzin yoksa `error.status: 'denied'`, geçmiş ya da okunamayan zaman `invalid`: `error` dalı → hata akışı → `always`. Web'de desteklenmez (`unsupported`) — sayfa kapalıyken tarayıcı gösteremez |
-| `notification-cancel` | `args.name` kimlikli planlı bildirimi siler (planlamadaki gibi metin şablonu: `'ilac-{{ item.id }}-0800'`), `'*'` hepsini; hep `always` |
-| `permission` | bir cihaz iznine bakar ya da ister. `args.value` izin türü, **düz metin — ifade olamaz** (mağaza derlemesinin taşıyacağı izinler bu değerden, akış koşmadan hesaplanır; `FLOW-038`); `args.name` kip: `check` yalnız okur (sistem penceresi açılmaz), `request` verilmemiş ve hâlâ sorulabilen izni ister (boş → `request`). Sonuç `Steps.<adım>.data = { status, canAskAgain }`: `granted` · `denied` · `undetermined` · `unavailable` (derleme bu izni taşımıyor ya da web önizlemesi); `canAskAgain: false` → yalnız Ayarlar'dan değişir. `tracking` (iOS App Tracking Transparency) sonucu ayrıca `advertisingId` taşır: izin `granted` iken IDFA (iOS) / AAID (Android), değilse `null`; oynatıcı `tracking`'i hiç taşımaz (`unavailable`). Red hata değildir, hep `always`. Türler: `mobile_store_get { detail: ['permissions'] }` (`support: supported` satırlarının `key`'i) |
-| `open-settings` | uygulamanın sistem ayar sayfasını açar; `Steps.<adım>.data.opened`. Argüman almaz |
-| `back` | gezinme yığınında bir geri (iOS geri kaydırmasıyla aynı sonuç; kök ADR 0013). Argüman almaz (yazılan okunmaz), sonuç yazmaz, hata üretmez, hep `always`. Yığının ilk ekranında hiçbir şey yapmaz; Studio önizlemesinde runtime'ın kendi gezinmesi yoksa yine hiçbir şey, web uygulamasında tarayıcının geri'sidir. Formu kaydedip önceki ekrana dönmek için `redirect` yerine bunu kullanın: `redirect` yığına yeni ekran iter, geri kaydırması kaydedilen forma döner. 2026-10-08 öncesi runtime ve backend `back`'i tanımaz |
-| `ad-show` | tam ekran reklam (kök ADR 0012). `args.value` mağaza ayarındaki yerleşimin **adı**, düz metin (`FLOW-039`); biçimi `interstitial` · `rewarded` · `rewardedInterstitial` olmalı. Reklam yüklenip gösterilir, kullanıcı kapatınca `Steps.<adım>.data = { shown: true, reward }` ile sürer — `reward` ödüllü reklamı sonuna kadar izleyende `{ type, amount }`, değilse `null` (ödül ayrı dal değil, `condition` ile okunur). 10 sn'de reklam yoksa, SDK hata verirse, derleme reklam taşımıyorsa ya da rıza yoksa `error.status: 'unavailable'`; tanımsız ya da banner yerleşimi `invalid`: `error` dalı → hata akışı → `always`. Oynatıcı ve web önizlemesi her zaman `unavailable` — reklamsız dalı orada sınayın. Paletten yalnız mobilde |
-
-## Bildirim ve izin
-
-Bildirim adımları paletten yalnız mobil uygulamada sunulur. Tarif — S04 "her gün hatırlat": önce
-`notification-permission` (S03 düğmesi), sonra `timepicker`'ın değeriyle `notification-schedule`
-(`value: "<saat>.value"`, değer `HH:mm`) ve `error` dalında kullanıcıya mesaj. Çevrimdışı bandı adım değil
-ifadedir: `isHidden: {{ Device.isOnline }}` (`platform_guide('expressions')`).
-
-**İzin tarifi** (izin, ihtiyaç anında — düğmeye basılınca — istenir; sayfa açılışında değil): `permission`
-`check` → `condition`, **bu sırayla**: `status === 'granted'` ise işe devam; `'unavailable'` ise özelliği sunma
-(Ayarlar'da açılacak izin yoktur — `canAskAgain` burada da `false` gelir); `canAskAgain` ise `permission` `request`
-ve sonucuna göre devam; değilse nedenini söyleyip `open-settings`. `location` adımı, `map.showUser` ve dosya alanının
-kamera/galeri kaynağı izni kendileri de ister — `permission` adımı *ne zaman* sorulacağını seçmek ve sonucu
-okumak içindir. `unavailable` bir hata değil, derlemenin o izni taşımadığının haberidir
-(`platform_guide('mobile-publish')` §İzinler).
-
-## Reklam
-
-**Reklam tarifi** (kök ADR 0012): (1) `mobile_store_update { settings: { ads: { enabled: true, iosAppId, androidAppId,
-testMode: true, units: [{ name, format, ios, android }] } } }` — reklam, App ID'si olan platformun derlemesine `tracking`'i de sokar (ATT metni
-gider, kip `off` olamaz); (2) banner için sayfaya `adBanner` `unit: '<banner yerleşimi>'`; (3) geçiş/ödüllü reklam için
-düğme akışına `ad-show` `value: '<yerleşim>'`, `error` dalında reklamsız devam; (4) ödül `condition`:
-`Steps.<adım>.data?.reward` doluysa ödülü ver. Açılış reklamı adım değil ayardır (`ads.appOpenUnit`). Sıra cihazda:
-rıza formu → açılış izinleri (ATT) → SDK; iOS'ta izleme izni yoksa reklam kişiselleştirilmeden istenir. Yerleşim adının
-ayarda tanımlı olduğu sayfa/akış yazımında denetlenemez — `mobile_store_get` `settings.ads.units` ve `adsWarnings`
-(`MOB-026`); yayın ayrıntısı `platform_guide('mobile-publish')` §Reklamlar.
-
-## Konum ve harita
-
-`style`, `accuracy`, `reverseGeocode` gibi anahtarlar sözleşmede yoktur ve platform onları sessizce düşürür
-(`FLOW-029`). "Haritada aç" için adım yoktur: `map`'in `press` olayı düğüme `mapsUrl` yazar, akış
-`redirect` `isRaw: true`, `path: '<harita>.mapsUrl'` ile açar. Tarif — L05 "mevcut konumumu kullan":
-düğmenin `click`'i → `location` (`always` → setter `il.value = Steps.konum.data.address?.region`, `error` →
-setter hata metni). Uzak push (sunucudan gelen bildirim): `platform_guide('mobile')` §Uzak push.