@appaflytech/zeyrek-ai-mcp 0.0.15 → 0.0.17

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/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

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/page.md

@@ -1316,7 +1316,7 @@ budur — bir preset ya da `componentStyles` sizin değerinizi eziyorsa `styleLa
 | Değişiklik | Tool | Neden |
 |---|---|---|
 | Komponent ekle/sil/taşı, prop, binding, event | `page_schema_patch` | Doğrulama duvarı + açık Studio canvas'ına SignalR canlı yayını + eşzamanlı yazar kilidi yalnız bu yolda çalışır |
-| Ad, slug, browserTitle, `browserTitleKey`, layout, roller, middleware | `page_update` | Üstbilgi alanları micro-op sözlüğünde yok. `browserTitleKey` sekme başlığını çeviri anahtarına bağlar: verilirse başlık sözlükten çözülür, boşsa `browserTitle` kullanılır. Başlık sayfa yüklenirken çözülür ve canlı dil değişimini izlemez (`platform_guide('translation')`) |
+| Ad, slug, browserTitle, `browserTitleKey`, layout, roller, middleware | `page_update` | Üstbilgi alanları micro-op sözlüğünde yok. `browserTitleKey` sekme başlığını çeviri anahtarına bağlar: verilirse başlık sözlükten çözülür, boşsa `browserTitle` kullanılır. Başlık canlı dil değişimini izler; anahtarın o dilde değeri yoksa varsayılan dile düşer (`platform_guide('translation')`) |
 
 Platformun `PUT /pages/...` ucu **replace**'tir: gönderilmeyen `schema`/`events`/`roleIds`
 alanları silinir. Gateway bu yüzden `page_update`'te sayfayı önce okur, yalnız verdiğin

package/dist/resources/guides/translation.md

@@ -175,11 +175,10 @@ motor olmasıdır (tarayıcı JS'i ve Jint).
 verilmişse sekme başlığı çeviri sözlüğünden çözülür; anahtar boşsa `browserTitle` olduğu gibi
 kullanılır. İkisi de boşsa sayfa adı yazılır.
 
-> **Sekme başlığı SAYFA YÜKLENİRKEN çözülür, canlı dil değişimini İZLEMEZ.** Ölçüldü 2026-09-08
-> (yerel runtime): `language-selector` ile dil değiştirildiğinde sayfa içeriği ve layout başlığı
-> anında yeni dile geçiyor, sekme başlığı ise açılıştaki dilde kalıyor; aynı dille sayfa yeniden
-> yüklendiğinde başlık doğru geliyor. Sebep `Runtime.svelte`'te dilin bir `const` olarak bir kez
-> çözülmesi. Sekme başlığının dilini doğrulayacaksan **yeniden yükleyerek** doğrula.
+> **Sekme başlığı canlı dil değişimini İZLER.** `language-selector` ile dil değiştirildiğinde
+> sayfa içeriğiyle birlikte sekme başlığı da yeni dilde çözülür; yeniden yükleme gerekmez
+> (ölçüldü 2026-09-11). Anahtarın seçilen dilde değeri yoksa projenin varsayılan diline düşer.
+> 2026-09-08 ölçümündeki "açılıştaki dilde kalır" davranışı düzeltildi.
 
 ## Doğrulama mesajları: `t:` öneki
 

package/dist/resources/schema-fingerprint.json

@@ -1,10 +1,10 @@
 {
-  "hash": "05c7864d58e308973805f7becee1578ce9eddad196abcdf7eebb43b1e7677549",
-  "generatedAt": "2026-09-16T15:53:10.903Z",
+  "hash": "f37265d598ea468deb2157165891629c2e88c7fd2238e82ec60cda7f58f7de4c",
+  "generatedAt": "2026-09-18T12:57:15.416Z",
   "types": 186,
   "files": 108,
   "note": "Şemaları üreten backend kaynaklarının parmak izi. Elle düzenlemeyin: 'npm run generate-schemas' yazar, 'npm run schema:check' denetler.",
   "missing": [
-    "NgApps.Infrastructure.Models.IdNamePair`1[[System.Guid, System.Private.CoreLib, Version=10.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]"
+    "NgApps.Infrastructure.Models.IdNamePair`1[[System.Guid, System.Private.CoreLib, Version=9.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]"
   ]
 }

package/dist/resources/schemas/GlobalFunctionUpdateResultDto.json

@@ -95,6 +95,20 @@
               "$ref": "#/components/schemas/NgApps.Domain.Contexts.Shared.Dependencies.DependencyNode"
             },
             "nullable": true
+          },
+          "bindings": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/NgApps.Domain.Contexts.Shared.Dependencies.DependencyNode"
+            },
+            "nullable": true
+          },
+          "functions": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/NgApps.Domain.Contexts.Shared.Dependencies.DependencyNode"
+            },
+            "nullable": true
           }
         },
         "additionalProperties": false
@@ -189,6 +203,10 @@
           },
           "stepKind": {
             "$ref": "#/components/schemas/NgApps.Domain.Contexts.Studio.Flows.StepKind"
+          },
+          "propertyName": {
+            "type": "string",
+            "nullable": true
           }
         },
         "additionalProperties": false

package/dist/tools/designSchemaPatch.js

@@ -3,7 +3,7 @@ import { opsParam, writeViewParam, outlineWriteResponse, unknownEventOps, collec
 import { guid, projectParam, environmentParam, updates, microOps } from './common.js';
 import { fetchHost, hostPath } from './screens.js';
 import { assertScreenWriteGuards, screenCatalogNotes } from './screenWrite.js';
-import { schemaOpDrops, withWriteDiff } from '../platform/writeDiff.js';
+import { emptyWriteDiff, schemaOpDrops, withWriteDiff } from '../platform/writeDiff.js';
 import { fetchComponentEventNames } from './components.js';
 import { PlatformApiError } from '../platform/errors.js';
 import { handle } from '../platform/responses.js';
@@ -136,14 +136,14 @@ export function registerDesignSchemaPatchTool(server, platform, host) {
         if (layoutWarnings.length > 0)
             response.layoutWarnings = layoutWarnings;
         const contentOps = opRecords.filter(entry => entry.op === 'add_component' || entry.op === 'replace_prop');
-        let opDrops = [];
+        let opDrops = emptyWriteDiff();
         if (contentOps.length > 0) {
             try {
                 const saved = await fetchHost(platform, host, project, environment, applicationId, id);
                 opDrops = schemaOpDrops(saved[spec.tree], contentOps);
             }
             catch {
-                opDrops = [];
+                opDrops = emptyWriteDiff();
             }
         }
         return withWriteDiff(withNormalization(response, [

package/dist/tools/flows.js

@@ -5,12 +5,13 @@ import { flowBindings, normalizeFlowSteps, targetlessSetterWarnings, unknownSett
 import { flowBodyWarnings } from '../knowledge/coverage.js';
 import { PlatformApiError } from '../platform/errors.js';
 import { handle } from '../platform/responses.js';
-import { writeDiff, withWriteDiff } from '../platform/writeDiff.js';
+import { emptyWriteDiff, writeDiff, withWriteDiff } from '../platform/writeDiff.js';
 import { resolvePatchOperations } from '../knowledge/outlines.js';
 import { patchResult, baseVersionOf } from '../platform/patch.js';
 import fastJsonPatch from 'fast-json-patch';
 import { policyRules, flowExpressionSites } from '../knowledge/rules.js';
 import { functionCallRefs } from '../knowledge/functionGuards.js';
+import { existingMatch, ifExistsParam, platformRename, withRename } from '../platform/ifExists.js';
 import { randomUUID } from 'node:crypto';
 import { z } from 'zod';
 /**
@@ -19,14 +20,18 @@ import { z } from 'zod';
  * `flow_create` 200 döndü, `flow_get` adımı gösterdi ama `args` içinde kodu taşıyan alan yoktu —
  * teşhis ~10 dakika sürdü ve tek belirti filtrenin hiçbir şey yapmamasıydı. Okuma başarısız
  * olursa yazma yine başarılıdır: diff bir teşhis eklentisidir, yazmanın sonucu değil.
+ *
+ * Okunan kayıt da döner: `ifExists:'duplicate'` yazmasında platform ada/slug'a ' (1)' ekler ve yanıtın
+ * gönderilen adı değil KAYDEDİLEN adı göstermesi gerekir (flow-upsert-ve-baglar S-10).
  */
-async function flowWriteDrops(platform, host, project, environment, applicationId, hostId, flowId, sent) {
+async function flowWriteDrops(platform, host, project, environment, applicationId, hostId, flowId, sent, allowRename = false) {
     try {
         const saved = unwrap(await platform.tenant('GET', project, flowPath(host, applicationId, hostId, flowId), { environment }));
-        return writeDiff(sent, saved);
+        const rename = allowRename ? platformRename(sent, saved, 'paren') : { sent };
+        return { ...writeDiff(rename.sent, saved), saved, ...(rename.renamed ? { renamed: rename.renamed } : {}) };
     }
     catch {
-        return { dropped: [], normalized: [] };
+        return emptyWriteDiff();
     }
 }
 const stepsParam = z.array(z.record(z.unknown())).describe("Adım listesi (StepManagementSchema: { stepId, name, type, kind, args, branches }). DİKKAT: branches[].nextStepId bir GUID değil, hedef adımın stepId STRING'idir; dal ADI motorun anahtarıdır ve start/setter/code/function adımlarında 'always' olmak zorundadır. Tam şablon: ngapps://examples/flow-load-table (ya da flow_get çıktısı); adım tipleri ve setter/parameters şekli platform_guide('page') Kural 1c. Kullanıcı fonksiyonu çağırmak için 'function' adımı: { type:'function', args:{ functionId:'<function_list id>', functionName:'<ad>', parameters:[{ name:'<bildirimdeki ad>', value:{ type:'static'|'property'|'storage'|'state'|'code', ref } }] } } → çıktı Steps.<adımAdı>.data (ngapps://examples/flow-call-function, platform_guide('functions')).");
@@ -69,8 +74,7 @@ function flowListResult(flows, record) {
         ...(danglingBindings.length > 0 ? { danglingBindings } : {})
     };
 }
-const ifExistsParam = z.enum(['error', 'update', 'duplicate']).default('error').describe("Barındırıcıda aynı ad ya da slug'da (büyük/küçük harf duyarsız) akış varsa ne olacağı. 'error' (varsayılan): yazmaz, mevcut akışın id'sini döner. 'update': mevcut akışı bu gövdeyle günceller (id'si ve olay bağları korunur). 'duplicate': platformun ürün davranışı — ikinci kayıt açılır, platform ada/slug'a ' (1)' sayacını ekler (Studio'daki 'New Flow (1)' ile aynı kural).");
-const upper = (value) => String(value ?? '').toUpperCase();
+const flowIfExistsParam = ifExistsParam('akış', 'mevcut akışı bu gövdeyle günceller (id\'si ve olay bağları korunur)');
 /**
  * Barındırıcının akışları, önbelleksiz liste ucundan (`GET /pages|layouts/{id}/flows`). Layout ve
  * sayfa tasarım kaydı önbellekten gelir ve zarfsız akış yazmasından sonra akışı hemen taşımaz;
@@ -103,36 +107,21 @@ async function listHostFlows(platform, host, project, environment, applicationId
  * tam da zaman aşımında kopya üretirdi.
  */
 async function existingFlowMatch(platform, host, project, environment, applicationId, hostId, hostRecord, name, slug, flowId, ifExists) {
-    if (ifExists === 'duplicate')
-        return undefined;
-    let flows;
-    try {
-        flows = await listHostFlows(platform, host, project, environment, applicationId, hostId, async () => hostRecord);
-    }
-    catch (error) {
-        throw new PlatformApiError(`FLOW-026: barındırıcının mevcut akışları okunamadı, akış YAZILMADI (${error instanceof Error ? error.message : String(error)}). Liste okunmadan yazmak aynı adla ikinci akış açabilir; flow_list ile tekrar deneyin ya da bilerek ikinci akış istiyorsanız ifExists:'duplicate' verin.`);
-    }
-    const matches = flows.filter(flow => upper(flow.name) === upper(name) || upper(flow.slug) === upper(slug));
-    const [match] = matches;
-    if (match === undefined)
-        return undefined;
-    const describe = (flow) => `${String(flow.id)} ('${String(flow.name)}', slug '${String(flow.slug)}')`;
-    const copyPattern = new RegExp(`^${name.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')} \\(\\d+\\)$`, 'i');
-    const copies = flows.filter(flow => copyPattern.test(String(flow.name ?? '')));
-    const copyNote = copies.length > 0
-        ? ` Barındırıcıda bu adın sayaçlı eşleri de var: ${copies.map(describe).join(' · ')} — bağı olup olmadığını flow_list (bindings) ile kontrol edip gerekirse silin.`
-        : '';
-    if (ifExists === 'error') {
-        const where = host === 'page' ? 'sayfada' : host === 'layout' ? "layout'ta" : "widget'ta";
-        throw new PlatformApiError(`FLOW-026: bu ${where} aynı ad ya da slug'da akış zaten var: ${matches.map(describe).join(' · ')}. İstek gönderilmedi — gönderilseydi platform ürün kuralı gereği ikinci bir akış açardı (çakışan ad ya da slug'a ' (1)' sayacı eklenerek; yalnız harf farkı varsa sayaçsız). Mevcut akışı güncellemek için aynı çağrıyı ifExists:'update' ile tekrarlayın; bilerek ikinci akış istiyorsanız ifExists:'duplicate'.${copyNote}`, 409);
-    }
-    if (matches.length > 1) {
-        throw new PlatformApiError(`FLOW-026: ad ve slug farklı akışlara çıkıyor (${matches.map(describe).join(' · ')}); hangisinin güncelleneceği belirsiz, istek gönderilmedi. flowId ile flow_update kullanın.${copyNote}`, 409);
-    }
-    if (flowId !== undefined && flowId.toLowerCase() !== String(match.id).toLowerCase()) {
-        throw new PlatformApiError(`FLOW-026: verilen flowId (${flowId}) aynı adlı mevcut akışla (${describe(match)}) çelişiyor; istek gönderilmedi. Mevcut akışı güncellemek için flowId'yi vermeyin ya da ${String(match.id)} verin.`, 409);
-    }
-    return match;
+    return await existingMatch({
+        code: 'FLOW-026',
+        noun: 'akış',
+        where: host === 'page' ? 'bu sayfada' : host === 'layout' ? "bu layout'ta" : "bu widget'ta",
+        name,
+        slug,
+        id: flowId,
+        idParam: 'flowId',
+        ifExists,
+        list: () => listHostFlows(platform, host, project, environment, applicationId, hostId, async () => hostRecord),
+        listTool: 'flow_list',
+        copyCheck: 'bağı olup olmadığını flow_list (bindings) ile kontrol edip gerekirse silin',
+        updateTool: 'flowId ile flow_update',
+        slugSuffix: 'paren'
+    });
 }
 async function requiredParameterWarnings(platform, project, environment, applicationId, steps) {
     const warnings = [];
@@ -356,7 +345,7 @@ export function registerFlowTools(server, platform) {
             steps: stepsParam,
             errorSteps: stepsParam.optional(),
             flowId: guid.optional().describe('Verilmezse platform üretir; şemaya önceden bağlamak için kendiniz üretebilirsiniz'),
-            ifExists: ifExistsParam,
+            ifExists: flowIfExistsParam,
             policyOverride: policyOverrideParam
         },
         annotations: writes
@@ -392,15 +381,20 @@ export function registerFlowTools(server, platform) {
         }
         // Diff YALNIZ çağıranın yazdığı alanları kapsar; `id` ve barındırıcı bağı (`pageId` vb.)
         // gövdeye gateway koyar, kullanıcının düzeltebileceği bir şey değildir.
-        const drops = await flowWriteDrops(platform, host, project, environment, applicationId, hostId, writtenFlowId, { name: flow.name, slug: flow.slug, steps: flow.steps, errorSteps: flow.errorSteps });
-        return attachFindings(withWriteDiff(withNormalization({
+        const drops = await flowWriteDrops(platform, host, project, environment, applicationId, hostId, writtenFlowId, { name: flow.name, slug: flow.slug, steps: flow.steps, errorSteps: flow.errorSteps }, ifExists === 'duplicate');
+        return attachFindings(withWriteDiff(withRename(withNormalization({
             host,
             hostId,
             outcome: existing === undefined ? 'created' : 'updated',
-            flow: { id: writtenFlowId, name, slug, steps: steps.length },
+            flow: {
+                id: writtenFlowId,
+                name: typeof drops.saved?.name === 'string' ? drops.saved.name : name,
+                slug: typeof drops.saved?.slug === 'string' ? drops.saved.slug : slug,
+                steps: steps.length
+            },
             ...(parameterWarnings.length > 0 ? { parameterWarnings } : {}),
             hint: "Akışı bir olaya bağlamak için: page_schema_patch (layout'ta layout_schema_patch, widget'ta component_schema_patch) ops:[{op:'set_event', target:<elementId>, event:'<component_get events listesindeki ad>', eventValue:<flow id>}]; olayda zaten akış bağlıysa ikinciyi add_event ile ekleyin (set_event bağlı akışı değiştirir, PAGE-034). Olay adları komponente özeldir ve 'on' ÖNEKİ ALMAZ (button → 'click', form → 'submit', table → 'mount'/'select'/'sort'…); uydurma ad 200 döner ama bağ sessizce ölü kalır — gateway PAGE-008 ile yakalar."
-        }, normalized), drops), findings);
+        }, normalized), drops.renamed), drops), findings);
     }));
     server.registerTool('flow_update', {
         title: 'Akış güncelle',

package/dist/tools/functions.js

@@ -16,7 +16,7 @@ import { z } from 'zod';
 const sourceParam = z.enum(['workflow', 'studio']).describe("Nerede çalışır: 'workflow' → SUNUCU (workflow/middleware/automation ifadeleri, Jint), tenant geneli, çıplak adla çağrılır (toplamHesapla(1, 2)), applicationId/scope/pageId VERİLMEZ, isAsync olamaz. 'studio' → TARAYICI ({{ }} bağlaması, UI flow code/function adımı), uygulamaya ait, Functions.toplamHesapla(1, 2) ile çağrılır, applicationId + scope zorunlu. Kaynak sonradan DEĞİŞMEZ");
 const scopeParam = z.enum(['application', 'page']).describe("Yalnız source:'studio'. application: uygulamanın her sayfasında görünür. page: yalnız o sayfanın tarayıcı bağlamında, pageId zorunlu (K2). Ad uygulama içinde kapsamlar arası benzersizdir (K3)");
 const nameParam = z.string().min(1).describe("Fonksiyon adı; studio'da Functions.<ad>(…), workflow'da <ad>(…) ile çağrılır. JS tanımlayıcısı olmalı, ayrılmış sözcük olamaz; studio'da 'Functions', workflow'da motor global adları (system, input, Now…) yasaktır (FN-001, istek gitmeden). Aynı ad iki kaynakta yan yana yaşayabilir (ayrı ad alanları); aynı kaynak içinde tekrarı platform 422 ile reddeder");
-const bodyParam = z.string().min(1).max(65536).describe("Fonksiyon GÖVDESİ, iki kaynakta aynı biçim: düz JavaScript deyimleri, 'return' içerebilir — 'function' sarmalı ya da arrow YAZILMAZ ('return fiyat * adet'). Gövde çağrıldığı yerin bağlamını kapanış olarak görür: tarayıcıda Page/state/Steps/komponent adları, sunucuda input/adım çıktıları/system.* (K7). Parametre adları gövdede doğrudan kullanılır. Platform kaydetmeden önce SÖZDİZİMİNİ denetler (422 GlobalFunctionBodyInvalid, ayrıştırıcı mesajıyla). En çok 64 KB");
+const bodyParam = z.string().min(1).max(65536).describe("Fonksiyon GÖVDESİ, iki kaynakta aynı biçim: düz JavaScript deyimleri, 'return' içerebilir — 'function' sarmalı ya da arrow YAZILMAZ ('return fiyat * adet'). Gövde çağrıldığı yerin bağlamını kapanış olarak görür: tarayıcıda Page/state/Steps/komponent adları, sunucuda input/adım çıktıları/system.* (K7). Parametre adları gövdede doğrudan kullanılır. Gövde YORUMLU yazılır: başta ne yaptığını/parametreleri/dönüşü söyleyen // baş yorumu, açık olmayan adımlarda kısa satır yorumu; 5+ dolu satırlı yorumsuz gövde FN-006 uyarısı alır (Studio yorumu yeşil çizer). Platform kaydetmeden önce SÖZDİZİMİNİ denetler (422 GlobalFunctionBodyInvalid, ayrıştırıcı mesajıyla). En çok 64 KB");
 const parameterParam = z.object({
     name: z.string().min(1).describe('Parametre adı — JS tanımlayıcısı, fonksiyon içinde benzersiz; gövdede bu adla okunur'),
     type: z.enum(['text', 'number', 'boolean', 'date', 'object', 'array', 'any']).optional()
@@ -64,7 +64,10 @@ export function describeSignatureChange(current, next) {
     };
 }
 function signatureWarning(name, source, change, dependents) {
-    const callers = [dependents.flows.length ? `flows: ${dependents.flows.join(', ')}` : '', dependents.workflows.length ? `workflows: ${dependents.workflows.join(', ')}` : ''].filter(Boolean).join('; ');
+    const callers = ['flows', 'workflows', 'bindings', 'functions']
+        .map(bucket => (dependents[bucket].length ? `${bucket}: ${dependents[bucket].join(', ')}` : ''))
+        .filter(Boolean)
+        .join('; ');
     const what = [
         change.name ? `ad '${change.name[0]}' → '${change.name[1]}'` : '',
         change.parameters ? `parametreler [${change.parameters[0].join(', ')}] → [${change.parameters[1].join(', ')}]` : ''
@@ -75,11 +78,12 @@ function signatureWarning(name, source, change, dependents) {
     return `İmza değişti (${what}) ve fonksiyonu ${dependents.total} kayıt kullanıyor (${callers}): ${effect}. Güncelleme yapıldı; çağıran ifadeleri gözden geçirin — dependency_graph(module:'global-function').`;
 }
 /**
- * `GET global-functions/{id}/dependencies` KOVALI grafiği döner (`{ flows, workflows }`); düz dizi
+ * `GET global-functions/{id}/dependencies` KOVALI grafiği döner (`{ flows, workflows, bindings, functions }`); düz dizi
  * şekli de düzleştirilir — yapısal (`args.functionId`) ve metinsel (`Functions.<ad>(` / çıplak `<ad>(`)
  * bağımlılıklar aynı listede gelir. Etiket Studio rozetleriyle aynıdır: komponent olayı `Sahip › Komponent · olay`,
  * sayfa/layout olayı `Sahip · olay`, bağı olmayan akış `Sahip › akış adı` (sahip sayfa/layout/widget; eski yanıtta
- * sahipsiz); automation düğümü `ad (automation)`.
+ * sahipsiz); automation düğümü `ad (automation)`. Kod tipli prop bağlaması `Sahip › Komponent · prop`, gövdesinde
+ * çağıran fonksiyon adıyla yazılır.
  */
 export function summarizeDependents(payload) {
     const data = (() => {
@@ -94,7 +98,7 @@ export function summarizeDependents(payload) {
         const name = String(entry.name ?? entry.slug ?? entry.id ?? '?');
         const host = text(entry.hostName);
         const component = text(entry.componentName);
-        const event = text(entry.eventTitle) ?? text(entry.eventName);
+        const event = text(entry.eventTitle) ?? text(entry.eventName) ?? text(entry.propertyName);
         const label = component
             ? [host, [component, event].filter(Boolean).join(' · ')].filter(Boolean).join(' › ')
             : event
@@ -106,14 +110,20 @@ export function summarizeDependents(payload) {
         const entries = data.filter(isRecord);
         const moduleOf = (entry) => String(entry.module ?? entry.type ?? entry.kind ?? '').toLowerCase();
         const isWorkflow = (entry) => moduleOf(entry).includes('workflow') || moduleOf(entry) === 'automation';
+        const isFunction = (entry) => moduleOf(entry) === 'global-function';
+        const isBinding = (entry) => text(entry.propertyName) !== undefined;
         const workflows = names(entries.filter(isWorkflow));
-        const flows = names(entries.filter(entry => !isWorkflow(entry)));
-        return { flows, workflows, total: flows.length + workflows.length };
+        const functions = names(entries.filter(isFunction));
+        const bindings = names(entries.filter(entry => !isWorkflow(entry) && !isFunction(entry) && isBinding(entry)));
+        const flows = names(entries.filter(entry => !isWorkflow(entry) && !isFunction(entry) && !isBinding(entry)));
+        return { flows, workflows, bindings, functions, total: flows.length + workflows.length + bindings.length + functions.length };
     }
     const record = isRecord(data) ? data : {};
     const flows = names(record.flows);
     const workflows = names(record.workflows);
-    return { flows, workflows, total: flows.length + workflows.length };
+    const bindings = names(record.bindings);
+    const functions = names(record.functions);
+    return { flows, workflows, bindings, functions, total: flows.length + workflows.length + bindings.length + functions.length };
 }
 function usageHint(name, source, scope) {
     if (source === 'workflow') {
@@ -268,7 +278,7 @@ export function registerFunctionTools(server, platform) {
             data: saved,
             signature: functionSignature(saved.name ? saved : definition),
             signatureChange,
-            dependents: dependents ?? { flows: [], workflows: [], total: 0 },
+            dependents: dependents ?? { flows: [], workflows: [], bindings: [], functions: [], total: 0 },
             ...(dependents === undefined ? { dependentsNote: 'Bağımlılık ucu okunamadı; çağıran akış olup olmadığı bilinmiyor.' } : {}),
             ...(renamedReferences !== undefined ? { renamedReferences } : {}),
             ...(dependents !== undefined && dependents.total > 0 && callersBreak
@@ -321,7 +331,7 @@ export function registerFunctionTools(server, platform) {
         return {
             deleted: id,
             source,
-            dependents: dependents ?? { flows: [], workflows: [], total: 0 },
+            dependents: dependents ?? { flows: [], workflows: [], bindings: [], functions: [], total: 0 },
             ...(dependents === undefined ? { dependentsNote: 'Bağımlılık ucu okunamadı; çağıran akış olup olmadığı bilinmiyor.' } : {}),
             ...(dependents !== undefined && dependents.total > 0
                 ? { note: `${dependents.total} çağıran kırıldı (acknowledgeDependents): ${[...dependents.flows, ...dependents.workflows].join(', ')} — ifadeleri düzeltin ya da fonksiyonu aynı adla yeniden tanımlayın.` }

package/dist/tools/microservices.js

@@ -10,11 +10,15 @@ import { policyRules } from '../knowledge/rules.js';
 import { writeDiff, withWriteDiff } from '../platform/writeDiff.js';
 import { identityHeaders } from '../platform/tokenVault.js';
 import { PlatformApiError } from '../platform/errors.js';
+import { existingMatch, ifExistsParam, listAll, platformRename, withOutcome, withRename } from '../platform/ifExists.js';
+import { outlineWrite, recordWriteViewParam } from '../platform/writeView.js';
 import { handle } from '../platform/responses.js';
 import fastJsonPatch from 'fast-json-patch';
 import { z } from 'zod';
 import { constraintSummary } from '../knowledge/backendConstraints.js';
 import { unmappedMembers, introducedUnmappedMembers, withUnmappedMembers } from '../knowledge/schemaGuard.js';
+const MICROSERVICE_OUTLINE_KEYS = ['url', 'httpMethod', 'source', 'type'];
+const microserviceIfExistsParam = ifExistsParam('uç', 'mevcut ucu bu tanımla tam gövde günceller (id\'si korunur; microservice_update ile aynı yazma)');
 const policyOverrideParam = z.boolean().optional()
     .describe('true: politika block bulgularını warn\'a indirir (bilinçli istisna; yanıtta işaretlenir)');
 /**
@@ -287,28 +291,52 @@ export function registerMicroserviceTools(server, platform) {
     }));
     server.registerTool('microservice_create', {
         title: 'Microservice oluştur',
-        description: "Yeni microservice tanımlar (definition = CreateMicroserviceCommand). İlk kullanımdan önce platform_guide('microservice') okuyun: kaynak seçimi (table > query) ve selectFields disiplini. 'description' ZORUNLUDUR (MS-014, block): çağıranın bu uçtan ne elde ettiğini yazın. Auth/oturum gerektiren uçlarda definition.middlewareIds ile middleware bağlayın; kimlik kapsaması filtrede source:'expression' + value:'user.id' ile yapılır (platform_guide('middleware')). BU YALNIZ source:'table' UÇLARDA VAR: query kaynaklı ucun parametreleri ÇAĞRIDAN gelir (body → query-string → header) ve middleware'in kurduğu user o yola girmez — kapsamı gövdeye bırakan uç sahtelenebilir (ölçüldü 2026-09-07). Kapsanmış agregasyon ucu sorguyu bir workflow query adımından çağırır: platform_guide('microservice') §'Kimlik kapsaması × uç kaynağı'. Ucun gerçek bir tuzağı varsa (auth istemiyor, sayfalama yok, atomik değil) 'caution' alanına yazın — OPSİYONELDİR, tuzak yoksa boş bırakın. Gövde politika kontrolünden geçer. " + constraintSummary('CreateMicroserviceCommand'),
-        inputSchema: { project: projectParam, environment: environmentParam, applicationId: appRef, definition: definitionParam, policyOverride: policyOverrideParam },
+        description: "Yeni microservice tanımlar (definition = CreateMicroserviceCommand). Aynı ad ya da slug'da uç varsa varsayılan olarak YAZMAZ ve mevcut ucun id'sini döner (MS-023 — gönderilseydi platform '<ad> (1)' adıyla ikinci bir uç açardı); tekrar çalıştırılabilir yazma için ifExists:'update' verin, yanıttaki outcome 'created' | 'updated' olur. Mevcut uçlar okunamazsa da yazmaz. İlk kullanımdan önce platform_guide('microservice') okuyun: kaynak seçimi (table > query) ve selectFields disiplini. 'description' ZORUNLUDUR (MS-014, block): çağıranın bu uçtan ne elde ettiğini yazın. Auth/oturum gerektiren uçlarda definition.middlewareIds ile middleware bağlayın; kimlik kapsaması filtrede source:'expression' + value:'user.id' ile yapılır (platform_guide('middleware')). BU YALNIZ source:'table' UÇLARDA VAR: query kaynaklı ucun parametreleri ÇAĞRIDAN gelir (body → query-string → header) ve middleware'in kurduğu user o yola girmez — kapsamı gövdeye bırakan uç sahtelenebilir (ölçüldü 2026-09-07). Kapsanmış agregasyon ucu sorguyu bir workflow query adımından çağırır: platform_guide('microservice') §'Kimlik kapsaması × uç kaynağı'. Ucun gerçek bir tuzağı varsa (auth istemiyor, sayfalama yok, atomik değil) 'caution' alanına yazın — OPSİYONELDİR, tuzak yoksa boş bırakın. Gövde politika kontrolünden geçer. " + constraintSummary('CreateMicroserviceCommand'),
+        inputSchema: { project: projectParam, environment: environmentParam, applicationId: appRef, definition: definitionParam, ifExists: microserviceIfExistsParam, view: recordWriteViewParam, policyOverride: policyOverrideParam },
         annotations: writes
-    }, handle(config, async ({ project, environment, applicationId, definition, policyOverride }) => {
+    }, handle(config, async ({ project, environment, applicationId, definition, ifExists, view, policyOverride }) => {
         const resolver = new RefResolver(platform, project, environment);
         const resolvedApplicationId = await resolver.applicationId(applicationId);
         const hydrated = await hydrateMicroserviceRefs(definition, resolver);
         const normalized = normalizeMicroserviceDefinition(definition);
+        // Politika ÖNCE koşar: block alan istek platforma hiç gitmez, var-mı listesi de okunmaz.
+        const createFindings = enforcePolicy(evaluatePolicy(config, policyRules, 'microservice', definition, { operation: 'create' }, policyOverride));
+        const scopeFindings = await queryScopeFindings(platform, project, environment, definition);
+        const existing = await existingMatch({
+            code: 'MS-023',
+            noun: 'uç',
+            where: 'bu uygulamada',
+            name: typeof definition.name === 'string' ? definition.name : undefined,
+            slug: typeof definition.slug === 'string' ? definition.slug : undefined,
+            id: typeof definition.id === 'string' ? definition.id : undefined,
+            idParam: 'definition.id',
+            ifExists,
+            list: () => listAll(platform, project, environment, `/microservices/${resolvedApplicationId}`),
+            listTool: 'microservice_list',
+            copyCheck: 'kullanılıp kullanılmadığını dependency_graph ile kontrol edip gerekirse silin',
+            updateTool: 'id ile microservice_update'
+        });
+        // Kayıt bulunduysa yazma bir UPDATE'tir: gövde kuralları microservice_update ile aynı kipte (R-1).
         const findings = [
-            ...enforcePolicy(evaluatePolicy(config, policyRules, 'microservice', definition, { operation: 'create' }, policyOverride)),
-            ...await queryScopeFindings(platform, project, environment, definition)
+            ...(existing === undefined
+                ? createFindings
+                : enforcePolicy(evaluatePolicy(config, policyRules, 'microservice', definition, { operation: 'update' }, policyOverride))),
+            ...scopeFindings
         ];
-        const drift = unmappedMembers('CreateMicroserviceCommand', definition);
-        const payload = await platform.tenant('POST', project, `/microservices/${resolvedApplicationId}`, { environment, body: definition });
-        return attachFindings(withUnmappedMembers(withWriteDiff(withResolved(withNormalization(payload, normalized), [...resolver.resolved, ...hydrated]), writeDiff(definition, payload)), drift), findings);
+        const drift = unmappedMembers(existing === undefined ? 'CreateMicroserviceCommand' : 'UpdateMicroserviceCommand', definition);
+        const payload = existing === undefined
+            ? await platform.tenant('POST', project, `/microservices/${resolvedApplicationId}`, { environment, body: definition })
+            : await platform.tenant('PUT', project, `/microservices/${resolvedApplicationId}/${String(existing.id)}`, { environment, body: definition });
+        const saved = payload?.data;
+        const rename = ifExists === 'duplicate' ? platformRename(definition, saved, 'dash') : { sent: definition };
+        return attachFindings(withUnmappedMembers(withWriteDiff(withResolved(withRename(withNormalization(withOutcome(outlineWrite(payload, view, MICROSERVICE_OUTLINE_KEYS), existing), normalized), rename.renamed), [...resolver.resolved, ...hydrated]), writeDiff(rename.sent, payload)), drift), findings);
     }));
     server.registerTool('microservice_update', {
         title: 'Microservice güncelle',
         description: 'Microservice tanımını günceller (tam gövde). Hedefli değişiklik için microservice_patch tercih edin. \'description\' ZORUNLUDUR (MS-014, block). Ucun gerçek bir tuzağı varsa (auth istemiyor, sayfalama yok, atomik değil) \'caution\' alanına yazın — OPSİYONELDİR, tuzak yoksa boş bırakın. Gövde politika kontrolünden geçer. ' + constraintSummary('UpdateMicroserviceCommand'),
-        inputSchema: { project: projectParam, environment: environmentParam, applicationId: appRef, id: guid, definition: definitionParam, policyOverride: policyOverrideParam },
+        inputSchema: { project: projectParam, environment: environmentParam, applicationId: appRef, id: guid, definition: definitionParam, view: recordWriteViewParam, policyOverride: policyOverrideParam },
         annotations: updates
-    }, handle(config, async ({ project, environment, applicationId, id, definition, policyOverride }) => {
+    }, handle(config, async ({ project, environment, applicationId, id, definition, view, policyOverride }) => {
         const resolver = new RefResolver(platform, project, environment);
         const resolvedApplicationId = await resolver.applicationId(applicationId);
         const hydrated = await hydrateMicroserviceRefs(definition, resolver);
@@ -319,7 +347,7 @@ export function registerMicroserviceTools(server, platform) {
         ];
         const drift = unmappedMembers('UpdateMicroserviceCommand', definition);
         const payload = await platform.tenant('PUT', project, `/microservices/${resolvedApplicationId}/${id}`, { environment, body: definition });
-        return attachFindings(withUnmappedMembers(withWriteDiff(withResolved(withNormalization(payload, normalized), [...resolver.resolved, ...hydrated]), writeDiff(definition, payload)), drift), findings);
+        return attachFindings(withUnmappedMembers(withWriteDiff(withResolved(withNormalization(outlineWrite(payload, view, MICROSERVICE_OUTLINE_KEYS), normalized), [...resolver.resolved, ...hydrated]), writeDiff(definition, payload)), drift), findings);
     }));
     server.registerTool('microservice_patch', {
         title: 'Microservice\'e patch uygula',