@appaflytech/zeyrek-ai-mcp 0.0.1 → 0.0.3

package/README.md

@@ -1,4 +1,4 @@
-# ngapps-mcp-gateway
+# zeyrek-ai-mcp
 
 NgApps platformunu MCP tool'ları olarak sunan bağımsız gateway — veri/mantık tarafı (project,
 application, datasource, entity, row, microservice, query, workflow, automation, dto, view) ve
@@ -96,7 +96,7 @@ claude mcp add ngapps --transport http http://localhost:5100/mcp
 stdio alternatifi (port gerekmez, sunucuyu istemci başlatır):
 
 ```bash
-claude mcp add ngapps -- npx tsx <repo>/zeyrek-mcp/src/index.ts --stdio
+claude mcp add zeyrek-ai -- npx tsx <repo>/zeyrek-mcp/src/index.ts --stdio
 ```
 
 İlk doğrulama: oturumda `platform_whoami` tool'unu çağırtın — kimlik ve org çözümü tek seferde
@@ -110,7 +110,7 @@ Repoyu klonlamadan, yayınlanmış paketle. Tüm ayarlar `.mcp.json`'ın `env` b
 ```json
 {
   "mcpServers": {
-    "ngapps": {
+    "zeyrek-ai": {
       "type": "stdio",
       "command": "npx",
       "args": ["-y", "@appaflytech/zeyrek-ai-mcp@latest", "--stdio"],

package/dist/config.js

@@ -20,6 +20,7 @@ export const moduleNames = [
     'folder',
     'file',
     'access',
+    'translation',
     'template',
     'organization',
     'dependency',
@@ -27,7 +28,7 @@ export const moduleNames = [
 ];
 export const modulePresets = {
     core: ['platform', 'project', 'application', 'datasource', 'entity', 'row', 'microservice', 'query', 'workflow', 'automation', 'dto', 'view', 'dependency'],
-    studio: ['platform', 'page', 'component', 'flow', 'layout', 'variable', 'folder', 'file', 'access'],
+    studio: ['platform', 'page', 'component', 'flow', 'layout', 'variable', 'folder', 'file', 'access', 'translation'],
     admin: ['platform', 'template', 'organization', 'deployment']
 };
 function expandModuleNames(entries) {

package/dist/knowledge/componentCatalog.js

@@ -328,7 +328,8 @@ export const componentKnowledge = {
         behavior: [
             "change olayında runtime machine.setLanguage(value) çağırır: seçim localStorage'a (zeyrek:{appSlug}:lang) yazılır ve çeviri bağlı bütün prop'lar SAYFA YENİLENMEDEN yeniden çözülür.",
             'Projede dil tanımlı değilse liste boş çizilir — önce proje dillerini (Translations paneli) kur.'
-        ]
+        ],
+        guide: 'translation'
     },
     otpinput: {
         summary: 'Tek haneli kutulardan oluşan tek kullanımlık kod girişi (2–12 hane); yapıştırma kutulara dağılır.',

package/dist/knowledge/componentEvents.js

@@ -71,7 +71,10 @@ export const componentEventContracts = {
     // — 2026-08-25 eşleme turu: ng-apps-ui'da olay YAYAN ama burada kaydı olmayan komponentler.
     // Yükler kaynaktaki dispatch('emit', { name, data }) / machine.onEmit(id, { event, data })
     // çağrılarından birebir çıkarıldı. Olay yaymayan komponentler (badge · breadcrumb · jsonviewer ·
-    // notification · progress · qrcode · slot · tags · text) bilinçli olarak kayıtsızdır.
+    // progress · qrcode · slot · tags · text) bilinçli olarak kayıtsızdır. `notification` bu listede
+    // YANLIŞLIKLA yer almıştı — Notification.svelte hem timeout'ta hem kapatma tıklamasında
+    // dispatch('emit', { name:'toggled', data:{isHidden:true}, setter:true }) çağırıyor (düzeltme
+    // 2026-08-25c, `docs/20-komponent-bilgi-katmani.md` §9).
     autocomplete: {
         mount: NO_DATA,
         change: valueChange('string (YAZILAN metin — option değeri değil)'),
@@ -107,6 +110,7 @@ export const componentEventContracts = {
     emptystate: { actionClick: { payload: { text: 'string (aksiyonun metni)', index: 'number' }, reads: "aksiyonun kendi flow'u zaten doğrudan çalışır" } },
     iframe: { mount: NO_DATA },
     'language-selector': { change: { payload: { value: 'string (dil kodu)' }, reads: 'runtime ayrıca machine.setLanguage(value) çağırır' } },
+    notification: { toggled: { payload: { isHidden: 'boolean' } } },
     otpinput: {
         mount: NO_DATA,
         change: valueChange('string (birleşik kod)'),

package/dist/knowledge/outlines.js

@@ -64,10 +64,11 @@ export function entityOutline(definition) {
             dbType: field.dbType,
             nullable: field.nullable,
             relationType: field.relationType ?? 'none',
-            relationId: field.relationId ?? null
+            relationId: field.relationId ?? null,
+            isLocalized: Boolean(field.isLocalized)
         })),
         view: 'outline',
-        hint: "Bir alanın tam gövdesi için view:'part', part:'fields[slug=<slug>]'; değişiklik için entity_patch."
+        hint: "Bir alanın tam gövdesi için view:'part', part:'fields[slug=<slug>]'; değişiklik için entity_patch. isLocalized alanlar için platform_guide('entity') §'Çoklu dilli alan'."
     };
 }
 const segmentPattern = /^(\w+)(?:\[(?:(\d+)|(\w+)=([^\]]+))\])?$/;

package/dist/resources/guides/entity.md

@@ -186,7 +186,39 @@ Girdi sınırları (`IncrementalCodeInput.TryParse`; ihlal edilirse nesne geçer
 - `datasource_list.dataTypes` çıktısında bu tipi ayrı bir grup olarak görürsün; listede
   görmezsen yine de geçerlidir (rehberdeki "dataTypes'a güvenme" uyarısı burada da geçerli).
 
-## Primary key
+## Çoklu dilli alan (`isLocalized`)
+
+Bir alanı çoklu dilli yapmak için `dbType`/`commonType` değişmez — alan tanımına `"isLocalized":
+true` eklenir (`FieldDto.IsLocalized`, generic `definition` içinde geçer, gateway'de ayrı bir
+parametre YOKTUR). Kısıt (`FieldDtoValidator`): `isLocalized: true` iken `primaryKey` · `identity`
+· `unique` `false` olmalı ve `relationType: 'none'` olmalı — bunlardan biri doluysa platform
+reddeder.
+
+**Platform bunun için ayrı bir uç açmaz.** Bir entity'de `isLocalized` alanı olduğunda (create ya
+da update'te) platform otomatik olarak `{entity_slug}_localization` adlı **companion bir entity**
+kurar/genişletir:
+
+```
+id                                    Guid, PK, identity
+{entity_slug}_{parent_pk_slug}        RELATION (one-to-many → ana entity, otomatik FK)
+language                              Text
+...isLocalized:true olan alanlar      (ana tanımdan BİREBİR taşınır)
+```
+
+artı `(relation, language)` üzerinde unique index. Yani bir satırın Türkçe/İngilizce değerleri
+**ayrı satırlardır**, ana tabloda değil bu companion entity'de yaşar.
+
+**Kullanım (tamamı mevcut genel araçlarla, yeni tool GEREKMEZ):**
+
+```
+1. entity_get (ana entity, view:'outline')   → isLocalized alanları görürsün
+2. entity_list (aynı datasource)             → "{slug}_localization" entity'sini bul, id'sini al
+3. row_create/row_update (companion entity)  → { "<fk_slug>": "<ana satır id>", "language": "tr", "<alan_slug>": "..." }
+4. row_list (companion entity, filtre yok — selectedFields ile daralt) → dile göre satırları oku
+```
+
+`{fk_slug}` companion entity'nin `entity_get`'inde görünen ilişki alanının slug'ıdır (ana entity
+adından türetilir); satırı elle kurmadan önce mutlaka `entity_get` ile doğrula, tahmin etme.
 
 ```jsonc
 // GUID anahtar

package/dist/resources/guides/page.md

@@ -74,6 +74,10 @@ mümkündür ama doğrulama duvarı ve canlı canvas yalnız `page_schema_patch`
   `Data = RedirectPage.Slug`). Sabit `'/hastalar'` yazarsan sayfa slug'ı değişince bağlantı
   sessizce kırılır; `pageId` referansı değişiklikten etkilenmez. Aynısı `flow` prop'u için
   `type: 'flow'` + `ref: <flowId>`, dosya için `type: 'file'` + `ref: <fileId>`.
+- **Çoklu dilli metin için `type: 'translation'` + `ref: <çeviri anahtarı>`.** Runtime `data`'yı
+  her turda çözümlenmiş metinle EZER — anahtar yalnız `ref`'te yaşar, `data`'ya yazıp
+  güvenme (`code` prop'uyla aynı davranış). Tam şekil, fallback zinciri ve `translation_*`
+  tool'ları için `platform_guide('translation')`.
 - **`blocks[].size`, komponentin `component_get`'teki `maxSize`'ını aşamaz.** Dikkat: katalog
   varsayılanı aşabiliyor (`page-header` default `h:8`, `maxSize` `h:4`) — varsayılanı körü körüne
   kopyalama, doğrulayıcı `"Height of 'page-header' must be between 1 and 4."` ile reddeder.
@@ -1339,7 +1343,7 @@ bağlanır, filtre `source:'expression'` + `value:'user.id'` olur.
 | Kart görünümü | `card` — **kapsayıcı DEĞİLDİR**, çocuk kabul etmez (`not-droppable`) ve yüksekliği 10-50 aralığındadır. Kutu içinde serbest içerik için `container` kullan. |
 | Katman | `modal` · `drawer` (şema kökünde — Kural 1d) |
 | Geri bildirim | `notification` (sayfa içi kutu) · `toast` (geçici bildirim; isOpen yükselen kenarı) · `form-validation-errors` · `confirm-bar` · `result` (işlem sonucu ekranı) · `emptystate` (boş liste; ikon YA DA görsel + aksiyon düğmeleri) |
-| Gezinme / başlık | `breadcrumb` · `breadcrumb-title` (başlık + daralan iz) · `page-header` · `header` · `sidebar` · `auth-layout` · `language-selector` (dil değiştirici) |
+| Gezinme / başlık | `breadcrumb` · `breadcrumb-title` (başlık + daralan iz) · `page-header` · `header` · `sidebar` · `auth-layout` · `language-selector` (dil değiştirici — çoklu dil kurulumu `platform_guide('translation')`) |
 | Sunum | `text` · `html` · `image` · `video` · `icon` · `qrcode` · `tags` · `avatar` · `badge` (sayaç “99+” / nokta / durum metni) · `carousel` · `iframe` (sandbox’lı gömme) · `jsonviewer` (katlanabilir JSON; JSON METNİNİ de parse eder) · `audit-basic` · `audit-history` |
 
 > **`chart` komponenti VAR (2026-08-25 ölçümü) — bu satır düzeltildi.** Rehberin önceki hâli

package/dist/resources/guides/translation.md

@@ -0,0 +1,80 @@
+# Çoklu Dil Rehberi (page/content translations)
+
+Sayfa içeriğini (metin, buton etiketi, placeholder…) çoklu dilli yapan özellik. Studio panelinin
+kendi arayüz dili (`i18n.md`, yalnız frontend'i ilgilendirir) ile **karıştırma** — bu rehber
+**son kullanıcının gördüğü sayfa metnini** kapsar. Kaynak: `TranslationsController.cs`
+(`zeyrek-backend/src/NgApps.Tenant.API/Controllers/`) + `zeyrek-frontend/docs/features/page-translations.md`.
+
+## Model
+
+- Çeviri kaydı **application başına** tutulur (`(applicationId, language, key)` başına bir satır);
+  aynı application'daki tüm sayfalar aynı anahtar kümesini paylaşır.
+- Bir kayıt isteğe bağlı bir **`componentId`**'ye bağlanabilir — o komponent silinince kaydı da
+  kademeli silinir. Salt organizasyon amaçlıdır; runtime çözümlemeyi etkilemez (çözümleme yalnız
+  `key`'e bakar).
+- Proje **dilleri** ve **varsayılan dil** application değil **proje** düzeyinde ayardır
+  (`project_get`/`project_update` `languages`/`defaultLanguage`) ve tam **ISO 639-1** kod
+  kümesinden seçilir (`ProjectConstants.SupportedLanguages`, ~184 kod). `translation_update`'e
+  proje dillerinde olmayan bir kod verirsen platform isteği reddeder — önce `project_update` ile
+  dili ekle.
+
+## Araçlar
+
+| Tool | Ne yapar |
+|---|---|
+| `translation_list` | Application'ın tüm `(language, key, value)` kayıtlarını düz liste döner |
+| `translation_update` | `keys` (ekle/güncelle, `componentId` opsiyonel) ve/veya `deletedKeys` (sil) — ikisi de aynı çağrıda verilebilir, en az biri dolu olmalı |
+| `project_update` | `languages`/`defaultLanguage` — proje dillerini kurar/değiştirir |
+
+```jsonc
+// yeni anahtar aç / var olanı güncelle
+{ "applicationId": "<app id>", "keys": [
+  { "key": "home.welcome", "values": { "tr": "Hoş geldiniz", "en": "Welcome" } }
+] }
+
+// bir anahtarı sil, bir başkasını aynı çağrıda güncelle
+{ "applicationId": "<app id>",
+  "keys": [{ "key": "home.title", "values": { "tr": "Ana sayfa" } }],
+  "deletedKeys": ["home.old_banner"] }
+```
+
+## Bir prop'u çeviriye bağlamak
+
+Sayfa şemasında (`platform_guide('page')` Kural 1) çeviriye bağlı bir prop **Prop nesnesinin**
+`type:'translation'` varyantıdır — `PropValueType.Translation` (`DesignComponentProperty.cs`)
+backend'de zaten tanımlı, Studio'nun "Translate" aksiyonunun ürettiği şekil budur:
+
+```jsonc
+{ "op": "replace_prop", "target": "welcome_text", "prop": "text",
+  "value": { "type": "translation", "ref": "home.welcome", "data": "Hoş geldiniz" } }
+```
+
+- **Anahtar `ref`'tedir, `data` DEĞİL.** Runtime her `getNodeProps` turunda `data`'yı
+  `resolveTranslation(...)` sonucuyla EZER (`code` prop'larıyla aynı davranış — `page.md` Kural 1c
+  bunun `code` karşılığını anlatır). `ref`'i okumadan/yazmadan `data`'ya güvenme; `data` yalnız
+  Studio'nun sakladığı önceki statik değerdir (fallback/geri dönüş amaçlı, çözümlemeyi ETKİLEMEZ).
+- **Fallback zinciri:** aktif dil → projenin varsayılan dili → anahtarın kendisi. Boş string de
+  "eksik" sayılır ve zincirde bir alt basamağa düşer — bir anahtar hiçbir zaman boş render olmaz.
+- Hangi prop'lar çeviriye bağlanabilir platformca kısıtlanmaz (Studio'da yalnız `text`/`long-text`
+  tipli prop'larda "Translate" aksiyonu gösterilir, ama şema düzeyinde her static prop aynı Prop
+  şeklini kabul eder).
+
+## Dil değiştirme: `language-selector`
+
+Son kullanıcı dili `language-selector` komponentiyle değiştirir (`platform_guide('component')`
++ `componentCatalog` içindeki `language-selector` kaydı): `change` olayı `machine.setLanguage(value)`
+çağırır, seçim `localStorage`'a (`zeyrek:{appSlug}:lang`) yazılır ve çeviriye bağlı **bütün**
+prop'lar sayfa yenilenmeden yeniden çözülür — ayrı bir akış kurmana gerek yok, komponenti sayfaya
+eklemen yeterli. Projede dil tanımlı değilse (`languages` boşsa) liste boş çizilir.
+
+## Bilinen sınırlar
+
+- **Flow adımlarında Translation kaynağı YOK.** `value.type` sözlüğünde (`platform_guide('page')`
+  Kural 1c sonundaki tablo) `translation` yoktur — bir flow adımının **değerini** doğrudan bir
+  çeviri anahtarına bağlayamazsın, yalnız sayfa şemasındaki statik prop'lar bağlanabilir. İfadeden
+  okumak gerekiyorsa `t('anahtar')` Jexl fonksiyonu kullanılır (`platform_guide('expressions')`).
+- **Runtime sayfa yanıtı sunucu tarafında önbelleklidir** (Postgres `caches` tablosu). Bir
+  `translation_update`/`project_update(languages)` çağrısından hemen sonra `page_runtime_get`
+  eski değerleri gösterebilir — önbellek süresi dolana kadar. Acil doğrulama gerekiyorsa
+  `translation_list` ile yazma tarafını, `page_runtime_get` ile okuma tarafını AYRI doğrula.
+- Mobil runtime (`apps/mobile`) bu özelliği henüz beslemiyor — yalnız web.

package/dist/server.js

@@ -11,6 +11,7 @@ import { registerTemplateTools } from './tools/templates.js';
 import { registerWorkflowTools } from './tools/workflows.js';
 import { registerLayoutTools } from './tools/layouts.js';
 import { registerAccessTools } from './tools/access.js';
+import { registerTranslationTools } from './tools/translations.js';
 import { registerFlowTools } from './tools/flows.js';
 import { registerKnowledgeResources } from './resources/knowledge.js';
 import { registerSchemaResources } from './resources/schemas.js';
@@ -47,6 +48,7 @@ const moduleRegistrations = {
     folder: registerFolderTools,
     file: registerFileTools,
     access: registerAccessTools,
+    translation: registerTranslationTools,
     template: registerTemplateTools,
     organization: registerOrganizationTools,
     dependency: registerDependencyTools,

package/dist/tools/platformInfo.js

@@ -13,7 +13,7 @@ export function registerPlatformTools(server, platform) {
     }, handle(config, () => platform.org('GET', '/connect/userinfo')));
     server.registerTool('platform_guide', {
         title: 'Platform rehberi oku',
-        description: "Modülün iş kuralları rehberini döner (workflow, microservice, entity, page, component, html, middleware, view, expressions, getting-started, modify-existing). Bir modülde İLK yazma işleminden önce ilgili rehberi okuyun; sayfa/layout/flow işleri için page, komponent modeli/olay sözleşmeleri için component, hazır komponentler yetmediğinde HTML kaçış kapısı (Mustache, fireEvent, script kuralları) için html, auth/oturum/yetki için middleware, tam metin arama indeksi için view, ifade yazarken kullanılabilir fonksiyon/bağlam sözlüğü (system.*, file.*, Page.*, state.*, Steps…) için expressions rehberi. Örnek gövdeler için ngapps://examples kaynaklarına bakın.",
+        description: "Modülün iş kuralları rehberini döner (workflow, microservice, entity, page, component, html, middleware, view, expressions, translation, getting-started, modify-existing). Bir modülde İLK yazma işleminden önce ilgili rehberi okuyun; sayfa/layout/flow işleri için page, komponent modeli/olay sözleşmeleri için component, hazır komponentler yetmediğinde HTML kaçış kapısı (Mustache, fireEvent, script kuralları) için html, auth/oturum/yetki için middleware, tam metin arama indeksi için view, ifade yazarken kullanılabilir fonksiyon/bağlam sözlüğü (system.*, file.*, Page.*, state.*, Steps…) için expressions, sayfa/içerik çevirileri (çoklu dil) için translation rehberi. Örnek gövdeler için ngapps://examples kaynaklarına bakın.",
         inputSchema: {
             guide: z.string().describe('Rehber adı; bilinmeyen ad verilirse mevcut rehberler listelenir')
         },

package/dist/tools/projects.js

@@ -79,12 +79,14 @@ export function registerProjectTools(server, platform) {
     }));
     server.registerTool('project_update', {
         title: 'Proje güncelle',
-        description: 'Proje adını, slug\'ını ve temasını günceller. LoaderImage bu tool\'da desteklenmez.',
+        description: 'Proje adını, slug\'ını, temasını ve dil ayarlarını günceller. languages/defaultLanguage verilmezse mevcut değerlerine dokunulmaz. LoaderImage bu tool\'da desteklenmez.',
         inputSchema: {
             id: guid,
             name: z.string().min(1),
             slug: z.string().optional(),
-            theme: z.string().optional()
+            theme: z.string().optional(),
+            languages: z.array(z.string().min(1)).min(1).optional().describe('ISO 639-1 kod listesi (proje dilleri); sayfa çevirileri bu kodlarla doğrulanır'),
+            defaultLanguage: z.string().min(1).optional().describe("languages içinde olmalı — proje dilleri hiç kurulmadıysa (ilk kurulumda) tek başına verilebilir")
         },
         annotations: updates
     }, handle(config, args => {
@@ -93,6 +95,9 @@ export function registerProjectTools(server, platform) {
             form.set('Slug', args.slug);
         if (args.theme)
             form.set('Theme', args.theme);
+        args.languages?.forEach(language => form.append('Languages', language));
+        if (args.defaultLanguage)
+            form.set('DefaultLanguage', args.defaultLanguage);
         return platform.org('PUT', `/projects/${args.id}`, { form });
     }));
     server.registerTool('project_delete', {

package/dist/tools/translations.js

@@ -0,0 +1,37 @@
+import { guid, projectParam, environmentParam, readOnly, updates } from './common.js';
+import { handle } from '../platform/responses.js';
+import { z } from 'zod';
+const translationKeyInput = z.object({
+    key: z.string().min(1),
+    values: z.record(z.string()).describe("Dil kodu (ISO 639-1) → çeviri metni; kodlar projenin languages listesinde (project_get/project_update) tanımlı olmalı"),
+    componentId: guid.optional().describe("Çeviriyi belirli bir komponente bağlar; o komponent silinince kaydı da silinir")
+});
+export function registerTranslationTools(server, platform) {
+    const config = platform.config;
+    server.registerTool('translation_list', {
+        title: 'Çevirileri listele',
+        description: "Application'ın tüm çeviri kayıtlarını (dil × anahtar × değer) düz liste olarak döner. Proje dilleri/varsayılan dil için project_get; sayfada bir prop'u çeviriye bağlamak için platform_guide('translation').",
+        inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid },
+        annotations: readOnly
+    }, handle(config, ({ project, environment, applicationId }) => platform.tenant('GET', project, `/translations/${applicationId}`, { environment })));
+    server.registerTool('translation_update', {
+        title: 'Çevirileri güncelle',
+        description: "Bir ya da daha çok çeviri anahtarını toplu ekler/günceller (keys) ve/veya siler (deletedKeys) — tek çağrıda ikisi de verilebilir. 'keys' üzerinden yeni bir anahtar da açılabilir (upsert). 'values'taki dil kodları projenin languages listesinde tanımlı olmalı, aksi hâlde platform reddeder.",
+        inputSchema: {
+            project: projectParam,
+            environment: environmentParam,
+            applicationId: guid,
+            keys: z.array(translationKeyInput).optional().describe('Eklenecek/güncellenecek anahtarlar'),
+            deletedKeys: z.array(z.string().min(1)).optional().describe('Silinecek anahtar adları')
+        },
+        annotations: updates
+    }, handle(config, ({ project, environment, applicationId, keys, deletedKeys }) => {
+        if (!keys?.length && !deletedKeys?.length) {
+            throw new Error("'keys' ya da 'deletedKeys' parametrelerinden en az biri dolu olmalı.");
+        }
+        return platform.tenant('PUT', project, `/translations/${applicationId}`, {
+            environment,
+            body: { keys: keys ?? [], deletedKeys: deletedKeys ?? [] }
+        });
+    }));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appaflytech/zeyrek-ai-mcp",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "type": "module",
   "description": "MCP gateway exposing the NgApps platform APIs as tools",
   "license": "UNLICENSED",