@appaflytech/zeyrek-ai-mcp 0.0.20 → 0.0.21

package/dist/platform/strictArguments.js

@@ -1,4 +1,15 @@
 import { z } from 'zod';
+import { diagnosticsParam, runWithDiagnostics } from './diagnostics.js';
+/**
+ * `writes`/`updates` açıklamalı ama KAYIT yazmayan tool'lar: çalıştırma, önizleme, dışa aktarma, indirme,
+ * bağlantı testi. Yanıtlarında yazma tanılaması (silentlyDropped) yoktur; parametre yalnız tool listesini
+ * büyütür. Yeni böyle bir tool eklenirse buraya yazılır — `test/diagnostics.test.ts` listeyi kilitler.
+ */
+const NON_WRITING_TOOLS = new Set([
+    'microservice_execute', 'microservice_preview', 'microservice_debug', 'query_preview', 'workflow_preview',
+    'automation_preview', 'automation_trigger', 'row_export', 'file_download', 'microfunction_invoke',
+    'microfunction_runtime_test_connection'
+]);
 function isRawShape(value) {
     if (!value || typeof value !== 'object' || '_def' in value)
         return false;
@@ -19,14 +30,23 @@ export function rejectUnknownArguments(server) {
     server.registerTool = ((name, config, callback) => {
         if (!isRawShape(config.inputSchema))
             return registerTool(name, config, callback);
-        const shape = config.inputSchema;
+        // Yazma tool'ları tanılama kipini alır; parametre handler'a ULAŞMAZ (gövdeyi `...rest` ile
+        // platforma geçiren tool'larda sızardı), yalnız toolResult'ın okuduğu bağlama konur.
+        const writesDiagnostics = config.annotations?.readOnlyHint === false && config.annotations.destructiveHint !== true && !NON_WRITING_TOOLS.has(name);
+        const shape = writesDiagnostics ? { ...config.inputSchema, diagnostics: diagnosticsParam } : config.inputSchema;
+        const run = writesDiagnostics
+            ? ((args, extra) => {
+                const { diagnostics, ...rest } = args ?? {};
+                return runWithDiagnostics(diagnostics === 'full' ? 'full' : 'compact', () => callback(rest, extra));
+            })
+            : callback;
         const accepted = Object.keys(shape).join(', ');
         const inputSchema = z.object(shape, {
             errorMap: (issue, context) => issue.code === 'unrecognized_keys'
                 ? { message: `${name} şu üst düzey argümanları tanımıyor: ${issue.keys.map(key => `'${key}'`).join(', ')}. Tanınmayan alan sessizce yok sayılmaz — çağrı hiç gönderilmedi. Bu tool'un okuduğu alanlar: ${accepted}.` }
                 : { message: context.defaultError }
         }).strict();
-        return registerTool(name, { ...config, inputSchema }, callback);
+        return registerTool(name, { ...config, inputSchema }, run);
     });
     return server;
 }

package/dist/platform/writeDiff.js

@@ -1,15 +1,17 @@
 import { PROP_VALUE_TYPES } from '../knowledge/normalize.js';
 import { logStep } from '../observability/trace.js';
 const maxDrops = 20;
+const maxCollected = 1000;
 const maxDepth = 12;
 const missing = Symbol('missing');
 /**
  * Platformun kendi doldurduğu alanlar. Yalnız gönderilen tarafta da varsalar (patch yolunda gövde
  * okunup geri yazılır) fark üretirlerdi ve bu fark hep gürültüdür: `audit.updatedAt` her yazmada
- * değişir. 09-05 koşusunda `microservice_patch` yanıtındaki iki satırdan biri buydu.
+ * değişir. 09-05 koşusunda `microservice_patch` yanıtındaki iki satırdan biri buydu. `version` iyimser
+ * eşzamanlılık sayacıdır: okunan belge geri yazılınca platform onu artırır, fark her zaman gürültüdür.
  */
 const serverManagedKeys = new Set([
-    'audit', 'createdAt', 'updatedAt', 'createdUserId', 'createdUserName', 'updatedUserId', 'updatedUserName'
+    'audit', 'createdAt', 'updatedAt', 'createdUserId', 'createdUserName', 'updatedUserId', 'updatedUserName', 'version'
 ]);
 /**
  * Platformun KENDİ ürettiği kimlik. Gönderilen id kaydedilenden farklıysa bu bir kayıp değildir:
@@ -50,6 +52,29 @@ export const unstoredKeys = new Set(['fieldSlug']);
 const canonicalValues = {
     type: [['string', 'text']]
 };
+export function emptyWriteDiff() {
+    return { dropped: [], normalized: [], droppedCount: 0, droppedCountCapped: false, notes: [] };
+}
+function addDrop(sink, line) {
+    if (sink.droppedCount >= maxCollected) {
+        sink.droppedCountCapped = true;
+        return;
+    }
+    sink.dropped.push(line);
+    sink.droppedCount++;
+}
+/** Listeyi `maxDrops` satırda keser; sayı ve tavan bilgisi notlara yazılır. */
+function finishReport(sink) {
+    if (sink.dropped.length > maxDrops) {
+        const total = sink.droppedCountCapped ? `en az ${sink.droppedCount}` : `toplam ${sink.droppedCount}`;
+        sink.dropped = sink.dropped.slice(0, maxDrops);
+        sink.notes.push(`ilk ${maxDrops} fark listelendi, ${total} — gövdeyi *_get ile okuyup karşılaştırın.`);
+    }
+    else if (sink.droppedCountCapped) {
+        sink.notes.push(`sayım en az ${sink.droppedCount} farkta durdu.`);
+    }
+    return sink;
+}
 /**
  * Yolun son alan adı; `tags[0]` ya da `fields[fieldId=x]` gibi indeks/anahtar ekini atar.
  */
@@ -81,11 +106,11 @@ function lookup(saved, key) {
     return Object.hasOwn(record, key) ? record[key] : missing;
 }
 function compare(sent, saved, path, sink, depth) {
-    if (sink.dropped.length >= maxDrops || depth > maxDepth)
+    if (sink.droppedCountCapped || depth > maxDepth)
         return;
     if (Array.isArray(sent)) {
         if (saved === missing) {
-            sink.dropped.push(`${path}: gönderilen ${render(sent)} ↔ kaydedilen yok`);
+            addDrop(sink, `${path}: gönderilen ${render(sent)} ↔ kaydedilen yok`);
             return;
         }
         const key = Array.isArray(saved) ? identityKeyFor(sent) : undefined;
@@ -103,18 +128,18 @@ function compare(sent, saved, path, sink, depth) {
             }
             return;
         }
-        const before = sink.dropped.length;
+        const before = sink.droppedCount;
         sent.forEach((entry, index) => compare(entry, lookup(saved, index), `${path}[${index}]`, sink, depth + 1));
         // Sıra tabanlı karşılaştırmada "değişmiş" görünen öğe aslında yer değiştirmiş olabilir. Tek
         // elemanlı dizide sıra farkı imkânsız olduğu için not düşülmez (2026-09-06 · S-1).
-        if (Array.isArray(saved) && sent.length > 1 && saved.length > 1 && sink.dropped.length > before) {
-            sink.dropped.splice(before, 0, `${path}: (sıra tabanlı karşılaştırma — anahtar yok) aşağıdaki farklar platform diziyi başka sırada sakladıysa yanıltıcıdır`);
+        if (Array.isArray(saved) && sent.length > 1 && saved.length > 1 && sink.droppedCount > before) {
+            sink.notes.push(`${path}: (sıra tabanlı karşılaştırma — anahtar yok) aşağıdaki farklar platform diziyi başka sırada sakladıysa yanıltıcıdır`);
         }
         return;
     }
     if (sent && typeof sent === 'object') {
         if (saved === missing) {
-            sink.dropped.push(`${path}: gönderilen ${render(sent)} ↔ kaydedilen yok`);
+            addDrop(sink, `${path}: gönderilen ${render(sent)} ↔ kaydedilen yok`);
             return;
         }
         for (const [key, entry] of Object.entries(sent)) {
@@ -130,7 +155,7 @@ function compare(sent, saved, path, sink, depth) {
     if (unstoredKeys.has(field) && (saved === missing || saved === null))
         return;
     if (saved === missing) {
-        sink.dropped.push(`${path}: gönderilen ${render(sent)} ↔ kaydedilen yok`);
+        addDrop(sink, `${path}: gönderilen ${render(sent)} ↔ kaydedilen yok`);
         return;
     }
     if (sent === saved)
@@ -141,7 +166,7 @@ function compare(sent, saved, path, sink, depth) {
         sink.normalized.push(`${path}: gönderilen ${render(sent)} platformun kanonik adıyla ${render(saved)} olarak saklandı — eşdeğer, kayıp değil`);
         return;
     }
-    sink.dropped.push(`${path}: gönderilen ${render(sent)} ↔ kaydedilen ${render(saved)}`);
+    addDrop(sink, `${path}: gönderilen ${render(sent)} ↔ kaydedilen ${render(saved)}`);
 }
 /**
  * Sol taraf platforma GİDEN gövdedir (gateway normalizasyonu uygulandıktan sonrası), sağ taraf
@@ -152,8 +177,8 @@ function compare(sent, saved, path, sink, depth) {
  * İki liste döner: `dropped` gerçekten kaybolan alanlar, `normalized` platformun kanonik adıyla
  * sakladığı eşdeğerler. İkincisi `gatewayNormalized`a gider, uyarıya değil.
  */
-export function writeDiff(sent, saved, aliases = {}) {
-    const sink = { dropped: [], normalized: [] };
+export function writeDiff(sent, saved, aliases = {}, finish = true) {
+    const sink = emptyWriteDiff();
     if (!sent || typeof sent !== 'object')
         return sink;
     const wrapper = saved && typeof saved === 'object' && !Array.isArray(saved)
@@ -171,19 +196,16 @@ export function writeDiff(sent, saved, aliases = {}) {
     if (keys.length > 0 && shared.length === 0)
         return sink;
     compare(comparable, root, '', sink, 0);
-    if (sink.dropped.length >= maxDrops) {
-        sink.dropped.push(`… ilk ${maxDrops} fark listelendi, daha fazla fark var — gövdeyi *_get ile okuyup karşılaştırın.`);
-    }
-    return sink;
+    return finish ? finishReport(sink) : sink;
 }
 export function silentlyDropped(sent, saved, aliases = {}) {
     return writeDiff(sent, saved, aliases).dropped;
 }
 export function withWriteDiff(payload, diff) {
-    const drops = Array.isArray(diff) ? diff : diff.dropped;
-    const normalized = Array.isArray(diff) ? [] : diff.normalized;
+    const drops = diff.dropped;
+    const normalized = diff.normalized ?? [];
     if (drops.length > 0) {
-        logStep('sessiz düşme ⚠', `${drops.length} alan gönderildi ama kayda geçmedi — platform hata vermeden yok saydı, yanıta silentlyDropped olarak eklenir`, drops);
+        logStep('sessiz düşme ⚠', `${diff.droppedCount}${diff.droppedCountCapped ? '+' : ''} alan gönderildi ama kayda geçmedi — platform hata vermeden yok saydı, yanıta silentlyDropped olarak eklenir`, [...drops, ...diff.notes]);
     }
     if (normalized.length > 0) {
         logStep('düzeltme', `platform ${normalized.length} alanı kanonik adıyla sakladı — eşdeğer, yanıta gatewayNormalized olarak eklenir`, normalized);
@@ -195,7 +217,9 @@ export function withWriteDiff(payload, diff) {
     const existing = payload.gatewayNormalized;
     return {
         ...payload,
-        ...(drops.length > 0 ? { silentlyDropped: drops } : {}),
+        ...(drops.length > 0 ? { silentlyDropped: drops, droppedCount: diff.droppedCount } : {}),
+        ...(drops.length > 0 && diff.droppedCountCapped ? { droppedCountCapped: true } : {}),
+        ...(drops.length > 0 && diff.notes.length > 0 ? { silentlyDroppedNotes: diff.notes } : {}),
         ...(normalized.length > 0
             ? { gatewayNormalized: [...(Array.isArray(existing) ? existing : []), ...normalized] }
             : {})
@@ -247,9 +271,9 @@ function findByElementId(nodes, elementId) {
  * yanıt yalnız `appliedPatch` olduğu için karşılaştırma yamadan SONRA okunan şemaya dayanır.
  */
 export function schemaOpDrops(schema, ops) {
+    const drops = { dropped: [], droppedCount: 0, droppedCountCapped: false, notes: [] };
     if (!Array.isArray(ops))
-        return [];
-    const drops = [];
+        return drops;
     for (const op of ops) {
         if (op.op === 'add_component') {
             const component = (op.component ?? {});
@@ -258,12 +282,10 @@ export function schemaOpDrops(schema, ops) {
             if (!elementId)
                 continue;
             if (!saved) {
-                drops.push(`add_component '${elementId}': komponent şemada bulunamadı — yama 200 döndü ama düğüm kaydedilmemiş.`);
+                addDrop(drops, `add_component '${elementId}': komponent şemada bulunamadı — yama 200 döndü ama düğüm kaydedilmemiş.`);
                 continue;
             }
-            for (const entry of silentlyDropped(unwrapProps(component), unwrapProps(saved))) {
-                drops.push(`add_component '${elementId}' → ${entry}`);
-            }
+            mergeNested(drops, writeDiff(unwrapProps(component), unwrapProps(saved), {}, false), `add_component '${elementId}' → `);
             continue;
         }
         if (op.op === 'replace_prop' && typeof op.target === 'string' && typeof op.prop === 'string') {
@@ -272,13 +294,18 @@ export function schemaOpDrops(schema, ops) {
                 continue;
             const props = (saved.props ?? {});
             if (!Object.hasOwn(props, op.prop)) {
-                drops.push(`replace_prop '${op.target}.${op.prop}': prop şemada yok — değer kaydedilmemiş.`);
+                addDrop(drops, `replace_prop '${op.target}.${op.prop}': prop şemada yok — değer kaydedilmemiş.`);
                 continue;
             }
-            for (const entry of silentlyDropped({ [op.prop]: unwrapProps(op.value) }, { [op.prop]: unwrapProps(props[op.prop]) })) {
-                drops.push(`replace_prop '${op.target}' → ${entry}`);
-            }
+            mergeNested(drops, writeDiff({ [op.prop]: unwrapProps(op.value) }, { [op.prop]: unwrapProps(props[op.prop]) }, {}, false), `replace_prop '${op.target}' → `);
         }
     }
-    return drops.slice(0, maxDrops);
+    return finishReport(drops);
+}
+/** İç karşılaştırmanın satırlarını, sayısını ve notlarını dış rapora önekle taşır; kesme en dışta yapılır. */
+function mergeNested(target, nested, prefix) {
+    for (const line of nested.dropped)
+        addDrop(target, `${prefix}${line}`);
+    target.droppedCountCapped = target.droppedCountCapped || nested.droppedCountCapped;
+    target.notes.push(...nested.notes.map(note => `${prefix}${note}`));
 }

package/dist/platform/writeView.js

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+export const recordWriteViewParam = z.enum(['outline', 'full']).optional().describe("Yanıttaki kaydın biçimi. outline (VARSAYILAN): data yalnız kimlik alanlarını taşır (id, name, slug, version ve türüne göre url/httpMethod/source/type) — gönderdiğiniz gövdenin yankısı bağlama tekrar girmez; 'kaydedildi mi' kanıtı silentlyDropped/droppedCount'tadır. full: platformun döndürdüğü gövde aynen gelir.");
+/**
+ * Create/update yanıtı platformun kaydettiği tanımın TAMAMINI döner; ajan aynı turda o gövdeyi
+ * kendisi göndermiştir. Kırpma yalnız bağımsız doğrulama yolu olan yerde yapılır: bu tool'larda
+ * `writeDiff` tam yanıt üzerinden ÖNCE hesaplanır, projeksiyon ondan sonra uygulanır.
+ */
+export function outlineWrite(payload, view, keys) {
+    if (view === 'full' || !payload || typeof payload !== 'object' || Array.isArray(payload))
+        return payload;
+    const record = payload;
+    const data = record.data;
+    if (!data || typeof data !== 'object' || Array.isArray(data))
+        return payload;
+    const source = data;
+    return { ...record, data: Object.fromEntries(['id', 'name', 'slug', 'version', ...keys].filter(key => Object.hasOwn(source, key)).map(key => [key, source[key]])) };
+}

package/dist/resources/guides/component.md

@@ -3,11 +3,6 @@
 Sayfaya konan her şeyin ortak kuralları. Kuruluş sırası ve şema gövdesi için
 `platform_guide('page')`; HTML kaçış kapısının derin sözleşmesi için `platform_guide('html')`.
 
-> **Mobil uygulamada** katalog ayrıdır: `component_list`/`component_get` mobil satırları okur,
-> `component_get` `mobileKnowledge` (bileşenin mobil farkları) ve `mobileNotes` ekler; katalogda
-> olmayan tip `MOB-003` alır. Stil CSS değil React Native'dir — `page_runtime_get(resolveStyles)`
-> `nativeStyle` döner (`platform_guide('mobile')`).
-
 ## Keşif: iki tool, üç bilgi katmanı
 
 ```
@@ -34,6 +29,14 @@ component_get   → tek tipin TAM sözleşmesi, üç katman birleşik:
 - **Boyut:** `blocks[].size` katalogdaki `maxSize`'ı aşamaz; yükseklikte
   `appearance.heightType: 'auto'` tercih edilir. Katalog varsayılanı bazı tiplerde kendi
   sınırını aşar — körü körüne kopyalama, gateway kırpar ve bildirir.
+- **Çocuk tarafı flex sözleşmesi — `mode: 'flex'` (2026-09-18):** flex kapta kalan alanı alan
+  öğe komponent değil onu taşıyan düğüm sarmalayıcısıdır ve sarmalayıcının `flex`i ortak
+  katmanda yazılır. `mode` prop'u `'flex'` olan bir çocuk (bugün yalnız `spacer`) kabın ANA
+  ekseninde kalanı ister: sütunda kalan yükseklik, satırda kalan genişlik, sıfır taban (wrap
+  açıkken satırdan düşmez). `appearance.widthType`/`heightType`'tan bağımsızdır ve ana
+  eksende onları yener; kabın ölçüsü o eksende belirli olmalıdır (auto/hug sütunda kalan
+  alan yoktur). Komponentin kendi `style`'ından istenemez — `style`'a `flex` yazma tablosuna
+  bkz. aşağıda.
 
 ### Arayüz metni ve biçimler uygulama dilini izler
 
@@ -105,7 +108,7 @@ Her şema düğümünde iki sözlük vardır; ikisi de ortak render katmanında
 
 | `states` | Anlamı |
 |---|---|
-| `isDroppable` | İçine komponent alır (container/form/repeater true). **Değer kataloğun kararıdır** (`component_list` `droppable` sütunu): Studio kanvası bırakma hedefini bu alandan çözer, bu yüzden gateway yazdığı düğümlerde alanı katalogdan doldurur ve `gatewayNormalized` ile bildirir (PAGE-034). `false` yazılmış bir kabın içine kanvasta bırakma yapılamaz — bilerek kapatmak için `resize_component`/`set_states` |
+| `isDroppable` | İçine komponent alır (container/form/repeater true) |
 | `isScrollable` | İçeriği kendi alanında kaydırır (sabit yükseklikte `overflow-y: auto`) |
 | `isWrapper` | Sayfanın/layout'un/widget'ın ANA kabı — salt düzen elemanı: `height:100%` + **`min-height:80vh`**, kap başlığı ÇİZİLMEZ. **Yalnız sayfa boyu kaplaması gereken tek kap için kullan:** iç içe kutuya verirsen 720px'lik pencerede o kutu 36px içerikle bile 576px çizilir (ölçüldü, `platform_guide('page')` Kural 1f). Çerçeve/başlık gizlemek için wrapper değil `style` (`border:'none'`) kullan. Kurulmuş bir düğümün bayrağını `resize_component` micro-op'unun `states` alanı değiştirir — düğümü yeniden kurmak gerekmez |
 | `isSticky` | Kaydırmada yerinde kalır (header/sidebar; z-index'i otomatik) |

package/dist/resources/guides/functions.md

@@ -105,14 +105,16 @@ globalThis["toplamHesapla"] = function (fiyat, adet) {       // studio: Function
   "name": "toplamHesapla", "description": "fiyat × adet; adet verilmezse 1",
   "parameters": [ { "name": "fiyat", "type": "number", "required": true },
                   { "name": "adet",  "type": "number", "defaultValue": 1 } ],
-  "body": "return fiyat * adet;" }
+  "body": "// fiyat × adet; adet verilmezse 1 sayılır
+return fiyat * adet;" }
 
 // tarayıcı
 { "source": "studio", "applicationId": "<app id>", "scope": "application",
   "name": "toplamHesapla", "description": "fiyat × adet; adet verilmezse 1",
   "isAsync": false,
   "parameters": [ … aynı liste … ],
-  "body": "return fiyat * adet;" }
+  "body": "// fiyat × adet; adet verilmezse 1 sayılır
+return fiyat * adet;" }
 ```
 
 Gövde **düz deyimlerdir** — `function (…) { }` sarmalı ya da arrow yazılmaz; `return` serbesttir,
@@ -128,6 +130,33 @@ sözdizimi hatası `422 GlobalFunctionBodyInvalid` ile ve ayrıştırıcı mesaj
 | FN-004 | `source:'workflow'` + `isAsync:true` | **block** — motor senkron, 422 `GlobalFunctionAsyncNotAllowed` |
 | FN-004 | studio: `isAsync:true` ama `await` yok · `isAsync:false` ama `await` var | warn — ilki gereksiz async (inline `[object Promise]`), ikincisi **derlenmeyen gövde**: fonksiyon atlanır |
 | FN-005 | Kaynak/kapsam tutarsız: workflow'a `applicationId`/`scope`/`pageId`; studio'ya `applicationId` ya da `scope` yok; `page` kapsamına `pageId` yok; `application` kapsamına `pageId` var | **block** — platform 422 |
+| FN-006 | 5+ dolu satırlı gövdede hiç yorum yok | warn — baş yorumu ekleyin (§Gövdede yorum) |
+
+### Gövdede yorum (FN-006)
+
+Gövdeyi okuyan bir sonraki kişi (insan ya da ajan) fonksiyonu Studio'nun Functions drawer'ında
+açar; yorumlar orada **yeşil italik** çizilir ve koddan ayrı okunur. Bu yüzden her gövde yorum taşır:
+
+- **Baş yorumu** — ilk satırlar: fonksiyon ne yapar, parametrelerin anlamı ve birimi, ne döner.
+  Tek satırlık `return` gövdesinde bile bir satır yeterlidir.
+- **Adım yorumu** — yalnız açık olmayan adımların üstüne: iş kuralı, sınır durumu, neden bu yol.
+  Kodu tekrar eden yorum yazılmaz (`// toplamı döndür` + `return toplam` gürültüdür).
+- `//` kullanın; `/* */` çok satırlı açıklama için serbest. Gövde kendi satırına sarıldığı için
+  son satırdaki `//` kapanış parantezini yutmaz.
+
+```js
+// KDV dahil sepet toplamı. satirlar: [{ fiyat, adet }], oran: 0.2 gibi ondalık.
+// Boş sepette 0 döner; tutar kuruş hassasiyetinde yuvarlanır.
+const araToplam = satirlar.reduce((toplam, satir) => toplam + satir.fiyat * satir.adet, 0)
+
+// İndirim KDV'den ÖNCE uygulanır (muhasebe kuralı)
+const indirimli = araToplam * (1 - (indirim ?? 0))
+
+return Math.round(indirimli * (1 + oran) * 100) / 100
+```
+
+5 ya da daha fazla dolu satırlı ve hiç yorumu olmayan gövde **FN-006** uyarısı alır; kayıt yine
+yapılır.
 
 Studio kaydı sonrası bağlı sayfaların çalışma paketi `Pages.Updated` ile yeniden kurulur (B-11):
 `/dev` yolu yeni gövdeyi hemen, `/view` yolu önbellek tazelenince gösterir. Workflow kaydı önbellek
@@ -244,7 +273,7 @@ toplamHesapla(row.fiyat, row.adet) > 1000
   serbesttir — sunucuda o ad alanı yok.
 - **Önekli hata:** gövde hatası `Functions.<ad>: <mesaj>` (studio) ya da `<ad>: <mesaj>` (workflow)
   olarak gelir; `Steps.<adım>.error.message` ya da `runtimeErrors`'ta bu öneki ara.
-- **Mobil uygulama:** mobil runtime (`@ng-apps/ui-native`) `appFunctions`/`pageFunctions`'ı `Functions`'a geçirir, çağrı web'deki gibi çalışır.
+- **Mobil yok** (K11): `apps/mobile` runtime'ı `Functions`'ı boş nesne kurar.
 - **Önbellek:** `/view` yolu eski gövdeyi birkaç saniye gösterebilir; `/dev` yolu anlıktır.
 - **Parametre konumsal:** `parameters` sırasını değiştirmek mevcut çağrıların anlamını değiştirir;
   `function` adımları ada göre eşlendiği için etkilenmez.

package/dist/resources/guides/getting-started.md

@@ -153,6 +153,21 @@ koda baktığını gizlemek yerine raporlamak.
   (GW-005). Bir argüman kabul edildiyse gateway onu okuyor demektir.
 
 
+## Aynı çağrıyı iki kez yapmak kopya açmaz: `ifExists`
+
+Platform aynı adla ikinci kaydı hata vermeden `"<ad> (1)"` olarak açar. `flow_create`,
+`microservice_create`, `workflow_create` ve `page_create` bu yüzden yazmadan önce aynı ad ya da
+slug'ı (harf duyarsız) arar:
+
+| `ifExists` | Kayıt zaten varsa |
+|---|---|
+| `error` (varsayılan) | Yazmaz; hata mevcut id'yi ve varsa `(n)` sayaçlı kopyaları söyler |
+| `update` | Mevcut kaydı günceller, yanıtta `outcome: 'updated'`. `page_create`'te yalnız verilen alanlar yazılır, şema korunur. `workflow_create`'te mevcut kaydın `type`'ı farklıysa (middleware ↔ automation) yazmaz — tür değişirdi |
+| `duplicate` | Platform davranışı: ikinci kayıt açılır. Platformun eklediği sayaç (ad `' (1)'`, slug `-1`; akışta ikisi de `' (1)'`) kayıp değildir, yanıtta `renamedByPlatform`'dadır |
+
+Betiği yeniden koşturacaksan `ifExists: 'update'` ver; kopyaları elle ayıklayan yardımcı kod
+yazma. Mevcut liste okunamazsa çağrı yazmadan düşer — tekrar dene.
+
 ## Yazdıktan sonra `silentlyDropped` alanına bak
 
 Platformun bir alanı **hatasız yutması** bu depodaki en pahalı hata sınıfı: çağrı 200 döner,
@@ -169,6 +184,26 @@ Gateway yazma tool'larında gönderdiğin gövdeyi kaydedilenle karşılaştır
 ]
 ```
 
+Yazma yanıtında bu liste ve `gatewayNormalized` **kısaltılmış** gelir: aynı yolun düşmeleri tek
+satırda sayıyla toplanır (`selectFields[*].path · kaydedilmedi: 25 öğe — ör. …`). Kayıp sayısı
+`droppedCount`'tadır; sayım 1000 farkta durursa `droppedCountCapped: true` gelir ve sayı "en az"
+demektir. Liste dışı bilgiler (20 satır kesmesi, sıra tabanlı karşılaştırma uyarısı)
+`silentlyDroppedNotes`'tadır ve sayıya girmez. Tam liste gerekiyorsa yazmayı tekrarlama — kaydı `*_get` ile oku,
+sonraki yazmalarda `diagnostics: 'full'` ver. `microservice_*` ve `workflow_*` create/update
+yanıtında `data` yalnız kimlik alanlarını taşır; gövdenin tamamı için `view: 'full'`.
+
+**Betikten toplu yazarken yanıtı olduğu gibi basma.** Otuz yazmanın tam yanıtı çıktı sınırını aşar
+ve dosyaya düşer. Her çağrı için tek satır bas; ayrıntıyı yalnız sorunlu çağrıda bas:
+
+```js
+const r = JSON.parse(result.content[0].text)
+if (result.isError || r.droppedCount > 0) console.log(JSON.stringify({ slug, error: result.isError ? r : undefined, droppedCount: r.droppedCount, silentlyDropped: r.silentlyDropped }))
+else console.log(JSON.stringify({ slug, id: r.data?.id, outcome: r.outcome }))
+```
+
+Yalnız `isError`'a bakma: platform alanı hatasız yutunca çağrı başarılıdır ve kayıp yalnız
+`droppedCount`'ta görünür.
+
 Diff dizi öğelerini indeksle değil KİMLİKLE eşler (`stepId`, `elementId`, `name`, `id`), çünkü
 platform diziyi kendi sırasında geri döndürür. Diff üretilemeyen tek durum, yanıtın kayıt değil
 kabul gövdesi olmasıdır; o zaman alan hiç görünmez ve doğrulamayı `*_get` ile kendin yaparsın.

package/dist/resources/guides/layout.md

@@ -4,10 +4,6 @@ Sayfaların paylaştığı kabuk: yan menü, üst şerit, kullanıcı menüsü v
 gireceği delik. Şema gövdesi ve koordinat modeli için `platform_guide('page')` (Kural 1,
 1d, 1f); komponent sözleşmeleri için `platform_guide('component')`.
 
-> **Mobil uygulamada** kabuk `app-bar` + tek `slot`'tur; sekmeler uygulama ayarı
-> (`properties.mobile.tabs`), çekmece `drawer` widget'ıdır. Web kabuk bileşenleri (`navigations`,
-> `sidebar`, `header`) `MOB-004` alır — `platform_guide('mobile')` §Gezinme.
-
 ## Karar kuralları
 
 **1. Layout, tek `slot` içeren SIRADAN bir komponent ağacıdır.** Ayrı bir dil yoktur:
@@ -65,7 +61,7 @@ yapılan eski numaraya artık gerek yok.
 NEREDE durduğunu değil, BİÇİMİNİ söyler (dikey kolon / yatay şerit / dolgu yüzeyi). Hem
 runtime hem Studio tuvali bölgeleri 12 kolonluk ızgarayla yerleştirir.
 
-**7. Dar ekranda flex YIĞILMAZ.** Runtime'ın dar ekran kuralı yalnız ızgara özelliklerini ezer.
+**7. Mobilde flex YIĞILMAZ.** Runtime'ın mobil kuralı yalnız ızgara özelliklerini ezer.
 Telefonda alt alta düşmesi gereken satırı `layout:'grid'` ile kur; `layout:'flex'` +
 `direction:'row'` telefonda da yan yana kalır (375px'te ölçüldü: ızgara çocukları 375/375px
 alt alta, flex çocukları 49/310px yan yana). Not: `wrap` varsayılanı artık açık (2026-09-01) —
@@ -144,8 +140,8 @@ bağlantı nesnesi ya da tam yol).
              "direction": { "type": "static", "data": "row" } },
   "blocks": [{ "breakpoint": 1024, "size": { "w": 12, "h": 80 }, "position": { "x": 0, "y": 0 } }] }
 
-// KÖTÜ — telefonda 49px'lik yan menü: row flex dar ekranda yığılmaz (Kural 7)
-// Dar ekranda alt alta düşmesi gerekiyorsa kökü layout:'grid' kur — bedeli, fill'in
+// KÖTÜ — telefonda 49px'lik yan menü: row flex mobilde yığılmaz (Kural 7)
+// Mobilde alt alta düşmesi gerekiyorsa kökü layout:'grid' kur — bedeli, fill'in
 // flex anlamının devreye girmemesi.
 ```
 
@@ -183,9 +179,9 @@ bunlardan biri olabilir:
 |---|---|
 | ~~`heightType` yalnız `auto` \| `fixed`~~ | **28 Ağustos'ta kapandı:** üçüncü değer `fill` (Kural 5b) |
 | ~~Kök kap viewport'a kilitlenmez~~ | **28 Ağustos'ta kapandı:** `fill` verilmiş kök 100vh (Kural 5b) |
-| Flex dar ekranda yığılmaz | Kural 7 — kabuk bugün bir MASAÜSTÜ kabuğudur |
-| Kırılıma duyarlı prop yok | `direction`/`gap` masaüstü ve dar ekranda AYNI; yalnız `blocks` ve `appearance.hideOn` kırılım bilir |
-| Dar ekranda çekmece (overlay) yok | Telefon genişliğinde içeriğin üstüne binen panel kurulamaz (mobil UYGULAMADA çekmece `drawer` widget'ıdır — `platform_guide('mobile')`) |
+| Flex mobilde yığılmaz | Kural 7 — kabuk bugün bir MASAÜSTÜ kabuğudur |
+| Kırılıma duyarlı prop yok | `direction`/`gap` masaüstü ve mobilde AYNI; yalnız `blocks` ve `appearance.hideOn` kırılım bilir |
+| Mobil çekmece (overlay) yok | Telefonda içeriğin üstüne binen panel kurulamaz |
 
 ---
 
@@ -193,7 +189,7 @@ bunlardan biri olabilir:
 (`injectPageSchemaIntoSlots`, `getResolvedLayoutViews`), `apps/studio/src/features/page/api/page.mappers.ts`
 (`mapPageLayoutToPreview`), `packages/ng-apps-ui/src/shared/render/render.functions.ts`
 (`resolveNodeBoxStyle` — slot'un `y / auto` satırı, flex çocuk genişliği),
-`packages/ng-apps-ui/src/shared/render/RenderComponent.svelte` (dar ekran media kuralı),
+`packages/ng-apps-ui/src/shared/render/RenderComponent.svelte` (mobil media kuralı),
 `packages/ng-apps-screen-builder/src/flex-layout.ts` (`getFlexChildStyle` — `widthType`
 fill/fixed/auto dalları, `normalizeCssSize` kabul kuralı; tuval ve runtime aynı fonksiyonu okur),
 `apps/studio/src/features/page/components/appearance/appearance-size.functions.ts` (panelin