@appaflytech/zeyrek-ai-mcp 0.0.55 → 0.0.57

package/dist/config.js

@@ -32,6 +32,7 @@ export const moduleNames = [
     "dependency",
     "deployment",
     "environment",
+    "customDomain",
     "merge",
     "activity",
     "revision",
@@ -70,6 +71,7 @@ export const modulePresets = {
         "access",
         "dependency",
         "environment",
+        "customDomain",
         "merge",
         "activity",
         "revision",
@@ -106,7 +108,7 @@ export const modulePresets = {
         "mobile",
         "assistant",
     ],
-    admin: ["platform", "template", "organization", "deployment", "environment", "merge", "activity"],
+    admin: ["platform", "template", "organization", "deployment", "environment", "customDomain", "merge", "activity"],
 };
 function expandModuleNames(entries) {
     const modules = [];

package/dist/knowledge/backendConstraints.js

@@ -822,6 +822,18 @@ export const backendRules = [
         guide: 'ngapps://guides/entity',
         check: body => entityTransferFindings(body)
     },
+    {
+        id: 'ENT-019',
+        module: 'entity',
+        commands: { create: 'CreateEntityCommand', update: 'UpdateEntityCommand' },
+        status: 400,
+        summary: "roles tablosunda recordTransferSkipExisting açılamaz",
+        sourceRef: 'RecordTransferValidator.ValidateAsync: requestedSkipExisting && entity.Id == Defaults.RoleEntityGuid ⇒ RecordTransferSkipExistingNotAvailableForRolesException (ADR 0072, K-4)',
+        guide: 'ngapps://guides/deployment',
+        check: body => String(body.slug ?? '').toLowerCase() === 'roles' && body.recordTransferSkipExisting === true
+            ? ["recordTransferSkipExisting: Keeping existing rows isn't available for 'roles' — roller kendi taşıyıcılarıyla (Module.Role) aktarılır, satır parçasıyla değil; ayar orada uygulanamadığı için platform 400 döner. Ayarı kapalı bırakın."]
+            : []
+    },
     {
         id: 'MS-017',
         module: 'microservice',

package/dist/knowledge/customDomain.js

@@ -0,0 +1,76 @@
+import { isIP } from 'node:net';
+import { domainToASCII } from 'node:url';
+import { getDomain } from 'tldts-icann';
+const wildcardPrefix = '*.';
+const hostPattern = /^(?=.{4,253}$)([a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?\.)+[a-z]([a-z0-9-]{0,61}[a-z0-9])$/;
+const pendingStates = new Set(['pending_dns', 'verifying']);
+export function normalizeHost(host) {
+    const trimmed = host.trim().replace(/\.$/, '').toLowerCase();
+    const isWildcard = trimmed.startsWith(wildcardPrefix);
+    const name = isWildcard ? trimmed.slice(wildcardPrefix.length) : trimmed;
+    const ascii = domainToASCII(name) || name;
+    return isWildcard ? `${wildcardPrefix}${ascii}` : ascii;
+}
+export const isPattern = (host) => host.startsWith(wildcardPrefix);
+// Studio'nun kuralıyla aynı (`apps/studio/src/features/custom-domain/custom-domain.functions.ts` `isApex`): kök public
+// suffix listesinden gelir (kök `docs/adr/0027`), `firma.com.tr` apex'tir. Yalnız DNS yönergesinin kayıt tipini seçer, reddetmez.
+export const isApex = (host) => {
+    const name = isPattern(host) ? host.slice(wildcardPrefix.length) : host;
+    return (getDomain(name) ?? name) === host;
+};
+/** Backend'in reddedeceği bir host için ne · neden · ne yapılacak; geçen host için null. */
+export function hostProblem(host, kind, platformBaseDomains) {
+    const normalized = normalizeHost(host);
+    const name = isPattern(normalized) ? normalized.slice(wildcardPrefix.length) : normalized;
+    if (isPattern(normalized) && kind !== 'pattern') {
+        return `'${host}' bir dal kalıbı (joker '*.'): joker yalnız custom_domain_pattern_create ile açılır, bu araçta kullanılmaz.`;
+    }
+    if (!isPattern(normalized) && kind === 'pattern') {
+        return `'${host}' kalıp değil: dal kalıbı '*.' ile başlar (ör. *.ornek.com). Tek bir adres için custom_domain_create kullanın.`;
+    }
+    if (!name.includes('.') || isIP(name) !== 0 || platformBaseDomains.some(base => name === base || name.endsWith(`.${base}`))) {
+        return `'${host}': platform alan adı altına kayıt açılamaz — platform adresi (${platformBaseDomains.join(', ')}), noktasız ad ve IP özel alan adı olamaz. Müşterinin kendi alan adını verin; platform adresi uygulamayı zaten sunar.`;
+    }
+    if (!hostPattern.test(name)) {
+        return `'${host}' geçerli bir alan adı değil: harf/rakam/tire etiketleri, en az bir nokta, 4-253 karakter, son etiket harfle başlar.`;
+    }
+    return null;
+}
+/** Müşterinin DNS sağlayıcısına gireceği kayıtlar; hedef her zaman backend'in verdiği `cnameTarget`'tır. */
+export function dnsRecords(domain) {
+    const records = [];
+    if (domain.cnameTarget) {
+        records.push({ type: isApex(domain.host) ? 'ALIAS / CNAME flattening' : 'CNAME', name: domain.host, value: domain.cnameTarget });
+    }
+    if (domain.ownershipTxtName && domain.ownershipTxtValue) {
+        records.push({ type: 'TXT', name: domain.ownershipTxtName, value: domain.ownershipTxtValue });
+    }
+    return records;
+}
+export const dnsTable = (records) => records.map(record => `${record.type}  ${record.name}  ${record.value}`).join('\n');
+export const isPending = (state) => pendingStates.has(String(state));
+// Yanıt bütçesi (41 §5): DNS yönergesi yalnız müşterinin hâlâ kayıt girmesi gereken satırda taşınır.
+const needsRecords = (state) => isPending(state) || state === 'error';
+export const withDns = (row) => needsRecords(row.state) ? { ...row, dns: dnsRecords(row) } : row;
+/** Tek kayıt dönen yazma yanıtı: satır + DNS yönergesi (düz metin tablo da, ajan kullanıcıya iletebilsin) + sonraki adım. */
+export function domainResponse(payload, note) {
+    const envelope = payload && typeof payload === 'object' ? payload : {};
+    const row = envelope.data;
+    if (!row || typeof row !== 'object')
+        return { ...envelope, note };
+    const records = dnsRecords(row);
+    return { ...envelope, data: { ...row, dns: records }, dnsTable: dnsTable(records), note };
+}
+export function listResponse(payload) {
+    const envelope = payload && typeof payload === 'object' ? payload : {};
+    const rows = Array.isArray(envelope.data) ? envelope.data : [];
+    return { ...envelope, data: rows.map(withDns), note: noteFor(rows) };
+}
+/** Listede ajanın bir sonraki adımı; bekleyen ve bağsız satır yoksa not yok. */
+export function noteFor(rows) {
+    const notes = [
+        rows.some(row => isPending(row.state)) ? 'doğrulama sürüyor; 60 sn sonra custom_domain_list ile yeniden çağır, state active olunca adres yayında' : '',
+        rows.some(row => row.state === 'unbound') ? 'ortam silinmiş; custom_domain_bind ile bağla' : ''
+    ].filter(Boolean);
+    return notes.length > 0 ? notes.join(' · ') : undefined;
+}

package/dist/platform/errors.js

@@ -111,6 +111,30 @@ function templateSubscriptionHint(code) {
         return '';
     return ' Bu proje şablon güncellemelerini alıyor; dal açma, dal silme ve merge planının hiçbir adımı bu projede yapılamaz. Değişikliği şablonun kaynak projesinde yapın, template_create ile yeni sürüm yayımlayın, bu projede template_check_updates → template_receive_updates ile alın. Aynı çağrıyı tekrarlamak sonucu değiştirmez.';
 }
+/**
+ * Özel alan adı retlerinin her biri başka bir araca ya da başka bir id'ye gönderir; kod olmadan
+ * "400" diye okunur ve ajan aynı host'u tekrar dener. Kodlar: backend `CustomDomainExceptions.cs`,
+ * durumlar `ExceptionStatusMap.cs` (HostTaken 409, Provider 502, kalanı 400).
+ */
+function customDomainHint(code) {
+    if (code === 'CustomDomainHostTakenException')
+        return " Bu host başka bir kayıtta (bu ya da başka bir kuruluşta). custom_domain_list ile bakın: aynı projedeyse var olan kaydı custom_domain_bind ile istediğiniz ortama bağlayın, yeni kayıt açmayın.";
+    if (code === 'PlatformHostCantBeCustomDomainException')
+        return ' Platformun kendi alan adı ve altı, noktasız ad ve IP özel alan adı olamaz. Müşterinin kendi alan adını verin; platform adresi uygulamayı zaten sunar.';
+    if (code === 'InvalidCustomDomainHostException')
+        return " Host biçimi geçersiz: harf/rakam/tire etiketleri, en az bir nokta. Joker (*.) yalnız custom_domain_pattern_create'te; kalıp da yalnız jokerle açılır.";
+    if (code === 'CustomDomainBindingOutsideProjectException')
+        return " applicationId / environmentId / hedef bu projenin değil. application_list ve environment_list ile bu projenin id'lerini alın.";
+    if (code === 'CustomDomainRedirectTargetInvalidException')
+        return " Yönlendirme hedefi aynı projede, yayında (state active), kind primary bir kayıt olmalı. custom_domain_list'ten o satırın id'sini verin.";
+    if (code === 'InvalidCustomDomainStateException')
+        return " Kaydın durumu bu işlemi almıyor: removing kayıt bağlanmaz ve denetlenmez, unbound kayıt önce custom_domain_bind ister, kalıbın çocuğu ve yönlendirme bağlanmaz. custom_domain_list ile state ve kind'a bakın.";
+    if (code === 'InvalidCustomDomainBindingException')
+        return ' Bağlama türle uyuşmuyor: birincil uygulama + ortam ister, kalıp yalnız uygulama, yönlendirme yalnız hedef alan adı.';
+    if (code === 'CustomDomainProviderException')
+        return ' Sertifika sağlayıcısı isteği reddetti ya da ulaşılamadı; kayıt değişmedi. Bir dakika sonra custom_domain_verify ile yeniden deneyin; tekrarlarsa platform_gap_report.';
+    return '';
+}
 /**
  * İçe aktarma zinciri dört çağrıdır ve her hata farklı bir adıma geri gönderir: plan süresi
  * dolduysa analizden, anahtar benzersiz değilse plan gövdesinden, hata oranı yüksekse dosyanın
@@ -401,7 +425,7 @@ export function mapPlatformError(status, payload, context) {
         if (validationMessages.length > 0) {
             return new PlatformApiError(`Doğrulama hatası (${location}): ${validationMessages.join(' ; ')}. Gövde şeması için ilgili ngapps://schemas kaynağına ya da mevcut bir kaydın *_get çıktısına bakın.`, status, code);
         }
-        return new PlatformApiError(`Geçersiz istek (${location}): ${apiMessage ?? 'API gövdeyi reddetti.'}${mergeRevertHint(code)}${templateSubscriptionHint(code)}${importHint(code, context.path)}${accessHint(code, apiMessage)}`, status, code);
+        return new PlatformApiError(`Geçersiz istek (${location}): ${apiMessage ?? 'API gövdeyi reddetti.'}${mergeRevertHint(code)}${templateSubscriptionHint(code)}${importHint(code, context.path)}${accessHint(code, apiMessage)}${customDomainHint(code)}`, status, code);
     }
     if (status === 401) {
         // Uygulama oturumu 401'i gateway kimliğinin değil uygulama kullanıcısının sorunudur; USERNAME/PASSWORD
@@ -467,7 +491,7 @@ export function mapPlatformError(status, payload, context) {
             : '';
         const validationMessages = collectValidationMessages(body);
         const detail = validationMessages.length > 0 ? ` → ${validationMessages.join(' ; ')}` : '';
-        const rejected = new PlatformApiError(`İş kuralı reddetti (${location}): ${apiMessage ?? 'çakışma'}${code ? ` [${code}]` : ''}${detail}${projectConflictHint}${pageSchemaHint(code, context.path)}${processHint(code, context.path)}${bulkRowHint(code)}${importHint(code, context.path)}${versionConflictHint(code, context.path)}${mergeHint(context.path)}${accessHint(code, apiMessage)}${microfunctionArchiveHint(code)}`, status, code);
+        const rejected = new PlatformApiError(`İş kuralı reddetti (${location}): ${apiMessage ?? 'çakışma'}${code ? ` [${code}]` : ''}${detail}${projectConflictHint}${pageSchemaHint(code, context.path)}${processHint(code, context.path)}${bulkRowHint(code)}${importHint(code, context.path)}${versionConflictHint(code, context.path)}${mergeHint(context.path)}${accessHint(code, apiMessage)}${microfunctionArchiveHint(code)}${customDomainHint(code)}`, status, code);
         if (typeof body.rowIndex === 'number')
             rejected.rowIndex = body.rowIndex;
         return rejected;
@@ -476,7 +500,7 @@ export function mapPlatformError(status, payload, context) {
     const fallbackDetail = fallbackValidationMessages.length > 0 ? ` → ${fallbackValidationMessages.join(' ; ')}` : '';
     const errorBody = status >= 500 ? describeErrorBody(body, { code, message: apiMessage }) : [];
     const errorBodyDetail = errorBody.length > 0 ? ` — ${errorBody.join(' · ')}` : '';
-    return new PlatformApiError(`Platform hatası ${status} (${location}): ${apiMessage ?? 'beklenmeyen hata'}${code ? ` [${code}]` : ''}${errorBodyDetail}${fallbackDetail}${diagnoseKnownFailure(status, apiMessage ?? '', code, context)}`, status, code);
+    return new PlatformApiError(`Platform hatası ${status} (${location}): ${apiMessage ?? 'beklenmeyen hata'}${code ? ` [${code}]` : ''}${errorBodyDetail}${fallbackDetail}${diagnoseKnownFailure(status, apiMessage ?? '', code, context)}${customDomainHint(code)}`, status, code);
 }
 const CONNECTION_RESET_CODES = new Set(['ECONNRESET', 'UND_ERR_SOCKET', 'EPIPE', 'ECONNABORTED']);
 /**

package/dist/resources/guides/custom-domain.md

@@ -0,0 +1,56 @@
+# Özel Alan Adı Rehberi
+
+Bir uygulamanın bir ortamını müşterinin kendi alan adında (`demo.ornek.com`) yayımlamak. Kayıt platformun
+çekirdek tablosundadır; ortamın verisine dokunmaz. Studio'da proje › Ayarlar › **Alan adları** ekranının
+yaptığı her şey `custom_domain_*` araçlarıyla yapılır.
+
+## Dört kural (değişmez)
+
+1. **Platform alan adı yasak.** Platformun kendi tabanı (kurulumda `zeyrek.app`, lokalde `zeyrek.local`) ve
+   altı, noktasız ad ve IP özel alan adı olamaz. Platform adresi uygulamayı zaten sunar; özel alan adı onun
+   **yanına** gelir, yerine geçmez.
+2. **Apex ALIAS ister.** Kökün kendisi (`ornek.com`, `firma.com.tr`; kök public suffix listesinden bulunur) çoğu DNS
+   sağlayıcısında CNAME alamaz: ALIAS /
+   ANAME / CNAME flattening kullanılır. Sağlayıcı bunu bilmiyorsa `www.ornek.com`'u birincil açıp `ornek.com`'u
+   ona yönlendirme (`custom_domain_redirect_create`) olarak açın.
+3. **Dal kalıbı kotadan düşer.** `*.onizleme.ornek.com` her açık dal için `<dal-slug>.onizleme.ornek.com`
+   çocuğunu kendisi açar ve dal silinince düşürür; her çocuk sağlayıcıda ayrı hostname'dir ve kurulumun
+   ücretsiz kotasından (100) düşer. 31 karakteri aşan ya da `www` / `zeyrek-check` olan dal slug'ı çocuk almaz.
+4. **Şablon abonesi serbest, alan adı şablon içeriği değil.** Şablondan kurulup güncelleme alan proje kendi
+   alan adını ekler, bağlar, kaldırır; şablon güncellemesi alan adını taşımaz ve bozmaz. Şablonun kaynak
+   projesindeki alan adı abonelere kopyalanmaz.
+
+## Sıra
+
+1. `application_list` + `environment_list` → uygulamanın ve ortamın id'si (production kabul edilir).
+2. `custom_domain_create { projectId, host, applicationId, environmentId }` → kayıt `pending_dns`; yanıt
+   `dns` satırlarını ve `dnsTable` düz metnini taşır. Bu kayıtları **müşteri** kendi DNS sağlayıcısına girer;
+   ajan DNS'e yazamaz.
+3. `custom_domain_list` ile 60 sn arayla okuyun: `pending_dns → verifying → active`. `active` olunca adres
+   yayındadır. Beklemeyi kısaltmak için `custom_domain_verify`.
+4. Başka ortama taşımak: `custom_domain_bind { id, applicationId, environmentId }` — host ve DNS değişmez.
+5. Kaldırmak: `custom_domain_delete` → `removing` → listeden çıkar. Müşterinin DNS kaydı kalır.
+
+## Durumlar
+
+| state | Anlamı | Sonraki adım |
+|---|---|---|
+| `pending_dns` | DNS kaydı henüz platformu göstermiyor | Müşteri `dnsTable`'ı girer; bekle |
+| `verifying` | DNS doğru, sertifika alınıyor | Bekle |
+| `active` | Yayında | — |
+| `error` | 72 saatte DNS gelmedi ya da sağlayıcı reddetti; `error` alanı sebebi söyler | Sebebi gider, `custom_domain_verify` (baştan başlar) |
+| `unbound` | Bağlı ortam silindi ya da uygulama kaldırıldı; host ve DNS korunur | `custom_domain_bind` |
+| `removing` | Sağlayıcıdan düşürülüyor | Bekle; bu kayıtta başka işlem yok |
+
+## Yönlendirme ve kalıp
+
+- `custom_domain_redirect_create { host, targetDomainId }`: 301, yol ve sorgu korunur. Hedef aynı projede
+  `active` bir **birincil** kayıttır; hedef silinince yönlendirme de silinir.
+- `custom_domain_pattern_create { host: '*.…', applicationId }`: dallar içindir; ortam seçilmez. Çocuklar
+  `custom_domain_list`'te `parentDomainId` ile görünür ve elle bağlanmaz.
+
+## Tuzaklar
+
+- Özel alan adı kapalı kurulumda (`CustomDomains:Enabled=false`) uçlar 404 döner; araç değil kurulum ayarıdır.
+- Bağlama ya da kaldırma adresin sunduğu ortamı en geç 30 sn içinde değiştirir (çözüm önbelleği).
+- Aynı host ikinci kez açılamaz (409); aynı projedeyse var olan kaydı `custom_domain_bind` ile taşıyın.

package/dist/resources/guides/deployment.md

@@ -57,11 +57,17 @@ Satırlar **tablo başına** açılan kayıt taşıma ayarıyla gider. Ayar enti
   satırları ana tabloyla **otomatik** gider; onlara ayrıca ayar açılmaz. Junction satırı yalnız iki
   tarafı da taşınıyorsa gider (dosya tarafı her zaman geçer).
 - **Kimlikler 1:1 korunur:** satır production'a aynı birincil anahtarla yazılır, identity sayacı
-  taşınan id'lerin ötesine ilerletilir. Production'da aynı id'li satır varsa üzerine yazılır.
+  taşınan id'lerin ötesine ilerletilir. Production'da aynı id'li satır varsa üzerine yazılır (ayar kapalıyken).
 - **`'all'` = ayna (DEP-005, backend ADR 0011):** promote'ta production o tabloda development'ın
   aynasıdır. Kaynakta olmayan satır, çevirisi ve junction satırı production'da **silinir** —
   production'a doğrudan girilmiş satırlar dahil. Kaynak tablo boşsa hedef tablo boşalır. Platformun
   kendi tabloları (`users`, `roles`, `permissions`) taşımaya açılabilir ama aynalanmaz.
+- **Hedefte varsa elleme (`recordTransferSkipExisting: true`, backend ADR 0072):** hedefte aynı birincil anahtarlı
+  ya da başka bir unique anahtarı çakışan satır **güncellenmez**, yalnız eksik satır eklenir; tablo **aynalanmaz**
+  (hedefin kendi eklediği satır silinmez). Şablon güncellemesinde de geçerlidir; dal açılışı ve merge yok sayar.
+  `roles`'ta açılamaz (ENT-019). Identity anahtarlı tabloya iki taraf da satır eklerse kimlikler çakışır ve kaynağın
+  satırı gelmez — iki tarafın satır eklediği tabloda `uuid` anahtar kullanın. Studio: tablo paneli → **"Hedefte zaten olan
+  kayıtları güncelleme"**.
 - **`'specific'` silmez:** yalnız upsert yapar. Seçili satırın FK ile gösterdiği satırlar zincirleme
   gelir (bir satır seçmek birkaçını taşıyabilir); seçilmemiş bir satıra giden çoka-çok bağı düşer.
 - **İlişki sırası:** `'all'` açılan tablonun ilişki hedefinde de taşıma açık olmalıdır, yoksa kayıt
@@ -122,4 +128,5 @@ yeni bir deploy.
 | Çeviriler eksik, satırlar var | ana tablonun ayarı | çeviri tablosu ana tabloyla gider; ana tabloda ayar açık olmalı |
 | Görsel production'da 404 | `page_schema_get` → prop düz URL mi, `{ type:'file', ref }` mi | prop'u `ref` ile bağlayın ya da dosyayı taşınan satırın dosya sütunundan okuyun |
 | Satırın dosyası 404, satır var | satır taşınıyor mu (`recordTransferMode`) | dosya yalnız taşınan satırla gider |
-| Production'da silinmiş satırlar | tablo `'all'` mı | ayna kuralı (DEP-005); production'a girilen veri bu tabloda tutulmaz |
+| Production'da silinmiş satırlar | tablo `'all'` mı | ayna kuralı (DEP-005); production'a girilen veri bu tabloda tutulmaz — tutulsun isteniyorsa `recordTransferSkipExisting: true` |
+| Production / abone değeri deploy ya da şablon güncellemesiyle ezildi | `entity_get` → `recordTransferSkipExisting` | `true` yapın: var olan satır güncellenmez |

package/dist/resources/guides/expressions.md

@@ -31,7 +31,7 @@ tetikleyen satır `row` / `previousRow` / `user`.
 
 | Çağrı | Ne yapar | Gerçek örnek (qm) |
 |---|---|---|
-| `system.getPageUrl(path)` | Sayfanın environment'a göre doğru serve URL'ini üretir — e-posta/redirect linki için TEK doğru yol, sabit URL yazma | `system.getPageUrl(`/web/dif-kayit?id=${row.finding_record}`)` |
+| `system.getPageUrl(path)` | Sayfanın environment'a göre doğru serve URL'ini üretir — e-posta/redirect linki için TEK doğru yol, sabit URL yazma. İstek uygulamanın özel alan adından geldiyse adres o alan adında döner (`https://demo.firma.com/dif-kayit?id=…`); istek yokken (zamanlanmış iş, kuyruk) sayfayı gösteren aktif alan adı varsa yine o, yoksa platform adresi | `system.getPageUrl(`/web/dif-kayit?id=${row.finding_record}`)` |
 | `system.generateToken({claims})` | Org secret'ıyla JWT üretir — sign-in ucunun kalbi | `{ access_token: system.generateToken({ userId: user.data.id, email: user.data.email }) }` |
 | `system.validateToken(token)` | Org secret'ıyla doğrular; dönüş `{ isValid, claims }` — **claim'ler bir seviye içeride** ve anahtarları `generateToken`'a verdiğin sözlüğün anahtarları (`r.claims.userId`); `r.id` YOK | `const r = system.validateToken(cookie.APP_Token)` → condition: `token.data.isValid && token.data.claims.userId` |
 | `file.readAsBase64(fileId)` | Drive dosyasını `data:<mime>;base64,…` döner | şablon okuma |

package/dist/resources/schema-fingerprint.json

@@ -1,6 +1,6 @@
 {
-  "hash": "162e8c2d14c5a0737d023b55790bab139812a00ec8e2e6335ed51981bb27e548",
-  "generatedAt": "2026-11-02T08:52:07.624Z",
+  "hash": "0598b6dcd46ea1951cf067de1e0f3f38b12eaaddc2669205451097bb2a089f90",
+  "generatedAt": "2026-11-02T13:49:36.654Z",
   "types": 377,
   "files": 196,
   "note": "Şemaları üreten backend kaynaklarının parmak izi. Elle düzenlemeyin: 'npm run generate-schemas' yazar, 'npm run schema:check' denetler.",

package/dist/resources/schemas/CreateEntityCommand.json

@@ -65,6 +65,9 @@
           "type": "string"
         },
         "nullable": true
+      },
+      "recordTransferSkipExisting": {
+        "type": "boolean"
       }
     },
     "additionalProperties": false

package/dist/resources/schemas/CreateWorkflowCommand.json

@@ -726,6 +726,9 @@
             },
             "nullable": true
           },
+          "recordTransferSkipExisting": {
+            "type": "boolean"
+          },
           "automationCount": {
             "type": "integer",
             "format": "int32"

package/dist/resources/schemas/UpdateEntityCommand.json

@@ -59,6 +59,9 @@
           "type": "string"
         },
         "nullable": true
+      },
+      "recordTransferSkipExisting": {
+        "type": "boolean"
       }
     },
     "additionalProperties": false

package/dist/resources/schemas/UpdateWorkflowCommand.json

@@ -726,6 +726,9 @@
             },
             "nullable": true
           },
+          "recordTransferSkipExisting": {
+            "type": "boolean"
+          },
           "automationCount": {
             "type": "integer",
             "format": "int32"

package/dist/server.js

@@ -36,6 +36,7 @@ import { registerFileTools } from "./tools/files.js";
 import { registerRowTools } from "./tools/rows.js";
 import { registerImportTools } from "./tools/imports.js";
 import { registerEnvironmentTools } from "./tools/environments.js";
+import { registerCustomDomainTools } from "./tools/customDomains.js";
 import { registerMergeTools } from "./tools/merges.js";
 import { registerRevisionTools } from "./tools/revisions.js";
 import { registerActivityTools } from "./tools/activities.js";
@@ -95,6 +96,7 @@ const moduleRegistrations = {
     dependency: registerDependencyTools,
     deployment: registerDeploymentTools,
     environment: registerEnvironmentTools,
+    customDomain: registerCustomDomainTools,
     merge: registerMergeTools,
     activity: registerActivityTools,
     revision: registerRevisionTools,

package/dist/tools/customDomains.js

@@ -0,0 +1,73 @@
+import { destructive, guid, readOnly, updates, writes } from './common.js';
+import { domainResponse, hostProblem, listResponse, normalizeHost } from '../knowledge/customDomain.js';
+import { PlatformApiError } from '../platform/errors.js';
+import { handle } from '../platform/responses.js';
+import { z } from 'zod';
+const host = z.string().min(1).max(253)
+    .describe("Müşterinin alan adı (ör. demo.ornek.com). Gateway kırpar, küçültür, IDN'yi punycode'a çevirir; platformun kendi alan adı ve altı reddedilir.");
+const pendingNote = 'DNS kayıtları (dnsTable) müşterinin DNS sağlayıcısına girilir; doğrulama asenkron — custom_domain_list ile 60 sn arayla okuyun, state active olunca adres yayında.';
+// Platform tabanı kuruluşa göre değişir; yalnız backend bilir (`CustomDomains:BaseDomains`), uç `mounts` onu yayımlar.
+async function assertHost(platform, tool, value, kind) {
+    const mounts = await platform.org('GET', '/custom-domains/mounts');
+    const problem = hostProblem(value, kind, mounts?.platformBaseDomains ?? []);
+    if (problem)
+        throw new PlatformApiError(`${tool}: ${problem}`, 400);
+    return normalizeHost(value);
+}
+export function registerCustomDomainTools(server, platform) {
+    const config = platform.config;
+    server.registerTool('custom_domain_list', {
+        title: 'Özel alan adları',
+        description: "Projenin özel alan adlarını döner (birincil · yönlendirme · dal kalıbı ve kalıbın çocukları, parentDomainId ile). Her satırda state: pending_dns | verifying | active | error | unbound | removing; yalnız active yayındadır. DNS'i bekleyen ya da hatalı satır dns yönergesini taşır. Bekleyen satır varsa note '60 sn sonra yeniden çağır' der; unbound satır ortamı silinmiş ya da uygulaması kaldırılmış kayıttır, custom_domain_bind ile bağlanır. Özel alan adı kapalı kurulumda uç 404 döner.",
+        inputSchema: { projectId: guid },
+        annotations: readOnly
+    }, handle(config, async ({ projectId }) => listResponse(await platform.org('GET', `/custom-domains/${projectId}`))));
+    server.registerTool('custom_domain_create', {
+        title: 'Özel alan adı ekle',
+        description: "Bir uygulamanın bir ortamını müşterinin alan adında yayımlar (definition = CreateCustomDomainCommand: { host, applicationId, environmentId }). Kayıt pending_dns doğar; yanıt müşterinin gireceği DNS kayıtlarını dns satırlarında ve dnsTable düz metninde verir. production ortamı kabul edilir: kayıt CORE tablosuna yazılır, ortamın verisine dokunmaz. Joker (*.) host bu araçta reddedilir — dal kalıbı custom_domain_pattern_create'tir; tek adresi başka adrese yönlendirmek custom_domain_redirect_create'tir. Şablon abonesi proje de alan adını kendisi yönetir (alan adı şablon içeriği değildir).",
+        inputSchema: { projectId: guid, host, applicationId: guid, environmentId: guid },
+        annotations: writes
+    }, handle(config, async ({ projectId, host: value, applicationId, environmentId }) => {
+        const normalized = await assertHost(platform, 'custom_domain_create', value, 'primary');
+        return domainResponse(await platform.org('POST', `/custom-domains/${projectId}`, { body: { host: normalized, applicationId, environmentId } }), pendingNote);
+    }));
+    server.registerTool('custom_domain_pattern_create', {
+        title: 'Dal kalıbı ekle',
+        description: "Bir uygulamanın dallarını tek kalıpla yayımlar: '*.onizleme.ornek.com' her açık dal için '<dal-slug>.onizleme.ornek.com' çocuğunu kendiliğinden açar, dal silinince düşürür (definition = CreateCustomDomainPatternCommand: { host, applicationId }). Müşteri tek joker CNAME girer. Her çocuk sağlayıcıda ayrı hostname'dir ve kotadan düşer; 31 karakteri aşan ya da 'www'/'zeyrek-check' olan dal slug'ı çocuk almaz. Kalıp joker olmayan host'u reddeder.",
+        inputSchema: { projectId: guid, host: host.describe("Joker host: '*.' ile başlar (ör. *.onizleme.ornek.com)."), applicationId: guid },
+        annotations: writes
+    }, handle(config, async ({ projectId, host: value, applicationId }) => {
+        const normalized = await assertHost(platform, 'custom_domain_pattern_create', value, 'pattern');
+        return domainResponse(await platform.org('POST', `/custom-domains/${projectId}/pattern`, { body: { host: normalized, applicationId } }), pendingNote);
+    }));
+    server.registerTool('custom_domain_redirect_create', {
+        title: 'Yönlendirme ekle',
+        description: "Bir alan adını aynı projedeki yayında (active) birincil alan adına 301 ile yönlendirir (ör. www.ornek.com → ornek.com; definition = CreateCustomDomainRedirectCommand: { host, targetDomainId }). Yol ve sorgu korunur. Hedef silinince yönlendirme de silinir. Hedef id'si custom_domain_list'te kind: 'primary', state: 'active' satırıdır.",
+        inputSchema: { projectId: guid, host, targetDomainId: guid.describe('Yönlendirmenin hedefi: aynı projede active, kind primary bir kaydın id\'si') },
+        annotations: writes
+    }, handle(config, async ({ projectId, host: value, targetDomainId }) => {
+        const normalized = await assertHost(platform, 'custom_domain_redirect_create', value, 'redirect');
+        return domainResponse(await platform.org('POST', `/custom-domains/${projectId}/redirect`, { body: { host: normalized, targetDomainId } }), pendingNote);
+    }));
+    server.registerTool('custom_domain_verify', {
+        title: 'Alan adını şimdi denetle',
+        description: "DNS'i ve sertifikayı sıradaki tur beklenmeden şimdi denetler; error durumundaki kayıt baştan başlar. Arka plan zaten dakikada bir denetler, bu yalnız beklemeyi kısaltır. unbound ve removing kayıt denetlenmez (400).",
+        inputSchema: { id: guid.describe('Alan adı kaydının id\'si (custom_domain_list)') },
+        annotations: updates
+    }, handle(config, async ({ id }) => domainResponse(await platform.org('POST', `/custom-domains/${id}/verify`), pendingNote)));
+    server.registerTool('custom_domain_bind', {
+        title: 'Alan adını başka ortama bağla',
+        description: "Birincil alan adını aynı projede başka bir uygulama ortamına bağlar (definition = BindCustomDomainCommand: { applicationId, environmentId }); unbound kayıt böyle yeniden yayına girer. Host değişmez, DNS'e dokunulmaz. Yalnız kind primary; kalıbın çocukları ve yönlendirmeler bağlanmaz.",
+        inputSchema: { id: guid.describe('Alan adı kaydının id\'si (custom_domain_list)'), applicationId: guid, environmentId: guid },
+        annotations: updates
+    }, handle(config, async ({ id, applicationId, environmentId }) => domainResponse(await platform.org('PUT', `/custom-domains/${id}/environment`, { body: { applicationId, environmentId } }), 'Bağlama kalıcıdır; adres en geç 30 sn içinde yeni ortamı sunar.')));
+    server.registerTool('custom_domain_delete', {
+        title: 'Alan adını kaldır',
+        description: "Alan adını kaldırır: kayıt removing olur, sağlayıcıdaki hostname arka planda düşürülür ve kayıt listeden çıkar. Kalıp silinirse çocukları, birincil silinirse ona yönlendiren kayıtlar da silinir. Müşterinin DNS kayıtlarına dokunulmaz.",
+        inputSchema: { id: guid.describe('Alan adı kaydının id\'si (custom_domain_list)') },
+        annotations: destructive
+    }, handle(config, async ({ id }) => ({
+        ...await platform.org('DELETE', `/custom-domains/${id}`),
+        note: 'kayıt removing; custom_domain_list ile listeden çıkmasını bekleyin'
+    })));
+}

package/dist/tools/deployments.js

@@ -27,7 +27,7 @@ export function registerDeploymentTools(server, platform) {
     const config = platform.config;
     server.registerTool('deployment_start', {
         title: 'Deployment başlat',
-        description: 'Projeyi kaynak environment\'tan hedef environment\'a deploy eder. Asenkron bir saga\'dır: sonuç bu yanıtta bitmez, deployment_status ile izleyin. Environment id\'lerini project_get çıktısından alın. BPM: süreç tanımları ve iş takvimleri taşınır — hedefte farklı aktif model yeni sürüm olarak yayınlanır (production\'da gelişte aktif), hedefin uyarlaması korunur; uyarlama, örnek, görev ve defter taşınmaz; kaynakta olmayan tanım silinir, açık örneği varsa emekliye ayrılır. KAYNAK YALNIZ DEVELOPMENT\'TIR: dal ya da production kaynak verilirse 400 (CantDeployFromBranchException) — dalı önce development\'a merge edin. ÖN DENETİM: deploy başlamadan production verisi denetlenir; veriyi bozacak ya da silecek her değişiklik 400 (DeploymentDataRiskException) ile listelenir ve deploy BAŞLAMAZ — biçim \'tablo.alan: tür (satır)\', türler not-null | unique | field-removed | table-removed | localization-move. YALNIZ TANIM TAŞINIR: tablo satırları ancak tabloda recordTransferMode (\'all\' | \'specific\' + transferRowIds) açıksa gider, çeviri ve junction satırları ana tabloyla birlikte. Kayıt taşıması \'all\' olan tabloda production development\'ın AYNASIDIR (kaynakta olmayan satır ve çevirisi silinir). DOSYA yalnız id referansıyla gider (file tipli prop { type:\'file\', ref:<fileId> } ya da taşınan satırın dosya sütunu); sayfaya düz yazılan /d/ serve URL\'si /p/\'ye çevrilir ama dosya kopyalanmaz, production\'da 404 döner — platform_guide(\'deployment\'). Microfunction\'ın yalnız YAYINLANMIŞ kodu taşınır ve hedefte yayınlanır; hiç yayınlanmamış olan hedefte taslak kalır. Zamanlanmış işin duraklatma durumu taşınır. YAYINLANMAMIŞ TASLAK TAŞINMAZ: kaynakta taslağı olan süreçler yanıtta unpublishedDrafts ({ slug, name, draftVersionNumber, activeVersionNumber }) ve note ile listelenir; hedefte aktif sürüm kalır. Taşımak için taslağı kaynakta yayınlayın (requireGreenScenarios açıksa önce senaryoları taslak üzerinde koşun), sonra yeniden deploy edin. DELTA (varsayılan): yalnız içerik özeti production\'dakinden farklı tanımlar taşınır, kaynakta olmayan tanım silinir; entity, rol, erişim politikası, bileşen, dosya, süreç tanımı, organizasyon yapısı ve tablo satırları her deploy\'da tam taşınır; klasör silme taşınmaz. Kaynağın ya da production\'ın özeti güvenilir değilse (son tamamlanmış özet denetimi güncel biçimde bir fill ya da farksız bir check değilse) deploy kendiliğinden tam koşar; fullMode:true her tanımı taşır. Hangi kipte koştuğu ve modül başına sayılar deployment_status yanıtında (mode, counters).',
+        description: 'Projeyi kaynak environment\'tan hedef environment\'a deploy eder. Asenkron bir saga\'dır: sonuç bu yanıtta bitmez, deployment_status ile izleyin. Environment id\'lerini project_get çıktısından alın. BPM: süreç tanımları ve iş takvimleri taşınır — hedefte farklı aktif model yeni sürüm olarak yayınlanır (production\'da gelişte aktif), hedefin uyarlaması korunur; uyarlama, örnek, görev ve defter taşınmaz; kaynakta olmayan tanım silinir, açık örneği varsa emekliye ayrılır. KAYNAK YALNIZ DEVELOPMENT\'TIR: dal ya da production kaynak verilirse 400 (CantDeployFromBranchException) — dalı önce development\'a merge edin. ÖN DENETİM: deploy başlamadan production verisi denetlenir; veriyi bozacak ya da silecek her değişiklik 400 (DeploymentDataRiskException) ile listelenir ve deploy BAŞLAMAZ — biçim \'tablo.alan: tür (satır)\', türler not-null | unique | field-removed | table-removed | localization-move. YALNIZ TANIM TAŞINIR: tablo satırları ancak tabloda recordTransferMode (\'all\' | \'specific\' + transferRowIds) açıksa gider, çeviri ve junction satırları ana tabloyla birlikte. Kayıt taşıması \'all\' olan tabloda production development\'ın AYNASIDIR (kaynakta olmayan satır ve çevirisi silinir) — tabloda recordTransferSkipExisting açıksa ayna yoktur, production\'da var olan satır güncellenmez, yalnız eksik satır eklenir. DOSYA yalnız id referansıyla gider (file tipli prop { type:\'file\', ref:<fileId> } ya da taşınan satırın dosya sütunu); sayfaya düz yazılan /d/ serve URL\'si /p/\'ye çevrilir ama dosya kopyalanmaz, production\'da 404 döner — platform_guide(\'deployment\'). Microfunction\'ın yalnız YAYINLANMIŞ kodu taşınır ve hedefte yayınlanır; hiç yayınlanmamış olan hedefte taslak kalır. Zamanlanmış işin duraklatma durumu taşınır. YAYINLANMAMIŞ TASLAK TAŞINMAZ: kaynakta taslağı olan süreçler yanıtta unpublishedDrafts ({ slug, name, draftVersionNumber, activeVersionNumber }) ve note ile listelenir; hedefte aktif sürüm kalır. Taşımak için taslağı kaynakta yayınlayın (requireGreenScenarios açıksa önce senaryoları taslak üzerinde koşun), sonra yeniden deploy edin. DELTA (varsayılan): yalnız içerik özeti production\'dakinden farklı tanımlar taşınır, kaynakta olmayan tanım silinir; entity, rol, erişim politikası, bileşen, dosya, süreç tanımı, organizasyon yapısı ve tablo satırları her deploy\'da tam taşınır; klasör silme taşınmaz. Kaynağın ya da production\'ın özeti güvenilir değilse (son tamamlanmış özet denetimi güncel biçimde bir fill ya da farksız bir check değilse) deploy kendiliğinden tam koşar; fullMode:true her tanımı taşır. Hangi kipte koştuğu ve modül başına sayılar deployment_status yanıtında (mode, counters).',
         inputSchema: {
             projectId: guid,
             sourceEnvironmentId: guid,

package/dist/tools/platformInfo.js

@@ -81,6 +81,7 @@ const guideRouting = {
     translation: 'sayfa/içerik çevirileri (çoklu dil)',
     access: 'kompleks proje yetkisi: organizasyon ağacı, izin kataloğu, kapsam, grant/atama, alan koruması (maske · şifre · türetilmiş alan)',
     merge: "dal aç, dalda çalış, development'a merge et; çakışma çözümü ve apply kapıları",
+    'custom-domain': 'uygulamayı müşterinin alan adında yayımlama: DNS yönergesi, durumlar, yönlendirme, dal kalıbı, dört kural',
     deployment: "development → production deploy'u neyi taşır: yalnız tanım; tablo satırları recordTransferMode ile, dosyalar yalnız id referansıyla; production'da eksik satır/dosya teşhisi",
     bpm: 'süreç motoru: tanım modeli, düğümler, atama sözlüğü, bölge olayları, kutu ve görev eylemleri, bağlayıcı/belge/imza/kanallar (süreç ≠ workflow)',
     decision: 'DMN karar tabloları: model, isabet politikaları, FEEL alt kümesi, DRD, süreçte decision düğümü, DMN XML'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appaflytech/zeyrek-ai-mcp",
-  "version": "0.0.55",
+  "version": "0.0.57",
   "type": "module",
   "description": "Zeyrek (NgApps) platform APIs as MCP tools — data, logic and Studio design surface in one gateway",
   "license": "UNLICENSED",
@@ -50,6 +50,7 @@
     "fast-json-patch": "^3.1.1",
     "pino": "^9.5.0",
     "playwright-core": "^1.49.0",
+    "tldts-icann": "^7.4.18",
     "undici": "^7.3.0",
     "zod": "^3.24.1"
   },