@appaflytech/zeyrek-ai-mcp 0.0.40 → 0.0.42

package/dist/tools/merges.js

@@ -11,8 +11,14 @@ const mergeDescription = z.string().trim().max(2000).optional()
     .describe("Dalda ne değişti ve neden merge edilmeli — gözden geçirene yazılan gövde. Merge bunu ASLA ezmez; opsiyoneldir ama açıklamasız istekte değişiklik listesi okunacak tek şey kalır.");
 const resolution = z.object({
     itemKey: z.string().min(1).describe("Plan kaydının anahtarı, ör. 'page:8f1c…' (merge_get çıktısındaki items[].key)"),
-    path: z.string().optional().describe("Eleman yolu, ör. 'components[elementId=btn_save].props[name=label].ref'; boş bırakılırsa o kaydın TÜM çakışmaları çözülür"),
-    choice: z.enum(['source', 'target']).describe("source = dal, target = development")
+    path: z.string().optional().describe("Eleman yolu, ör. 'components[elementId=btn_save].props[name=label].ref'; boş bırakılırsa o kaydın TÜM çakışmaları çözülür (custom'da yalnız kaydın tek çakışması varsa)"),
+    choice: z.enum(['source', 'target', 'both', 'custom']).describe("source = dal, target = development, both = iki tarafın birleşimi — yalnız combinable: true elemanda, birleşimi platform hesaplar; duplicate'te ikisini de tut demektir (slug taşıyan kopyada kapalı, combinable: false; base dolu kopyada source da kapalı). custom = value'daki değer"),
+    value: z.unknown().optional().describe("YALNIZ choice='custom' ile ve orada ZORUNLU: yazılacak değer. Türü (dizi/nesne/skaler) source ya da target ile aynı olmalı. Kök yolda kaydın gövdesidir, order-conflict'te kimlik listesidir, duplicate'te tek öğedir (kimliği development'ınki olur), tipi değişen prop'ta ('…props[id=…]') prop gövdesidir — valueType ile ref birlikte yazılır, kimliği yoldan gelir, statik listenin satırlarını (children) sunucu ref'ten kurar.")
+}).superRefine((entry, context) => {
+    if (entry.choice === 'custom' && entry.value === undefined)
+        context.addIssue({ code: 'custom', path: ['value'], message: "choice='custom' değer ister: yazılacak değeri value alanında gönderin" });
+    if (entry.choice !== 'custom' && entry.value !== undefined)
+        context.addIssue({ code: 'custom', path: ['value'], message: "value yalnız choice='custom' ile gönderilir; source / target / both değer taşımaz" });
 });
 /**
  * B-08 (2026-09-09 koşusu): `ResolveMergeConflictsCommandHandler` yanıtı
@@ -30,7 +36,7 @@ export function resolveSummary(payload, planId, requested) {
         ...(plan.status === undefined ? {} : { status: plan.status }),
         ...(plan.summary === undefined ? {} : { summary: plan.summary }),
         resolved: { requested, elements: resolvedElements },
-        note: "Yanıt ÖZETTİR — plan gövdesi kesildi. Planın kalan çakışmaları için merge_get { projectId, planId, view: 'conflicts' }; summary.unresolved 0 olduğunda merge_apply."
+        note: "Yanıt ÖZETTİR — plan gövdesi kesildi. Planın kalan çakışmaları için merge_get { projectId, planId, view: 'conflicts' }; summary.unresolved 0 olduğunda merge_apply. summary.duplicates çözümsüz olası kopyalardır: combinable: true olan kopya merge'ü engellemez (ikisi de yazılır), slug taşıyan kopya (combinable: false) ise summary.unresolved'a sayılır ve birini seçene kadar apply edilmez; merge_get { checks: true } okunmadan apply edilmez."
     };
 }
 export function registerMergeTools(server, platform) {
@@ -55,13 +61,27 @@ export function registerMergeTools(server, platform) {
     }, handle(config, ({ projectId, ...query }) => platform.org('GET', `/merges/${projectId}`, { query })));
     server.registerTool('merge_get', {
         title: 'Merge planını oku',
-        description: "Bir merge planını döner. items[] yalnız DEĞİŞEN kayıtları taşır; her kayıtta kind (add|update|delete|conflict) ve elements[] vardır. Çakışan elemanlarda base/source/target üç değeri birden gelir. dataRisk: true olan kalemde SEBEP dataRiskReasons[] içindedir: 'field-removed' (alan siliniyor), 'field-narrowed' (tip/nullable/unique daraltılıyor), 'not-null-without-default-on-populated-table' (hedefte satır varken varsayılansız NOT NULL alan ekleniyor — bu apply'ı DDL aşamasında düşürür, alanı nullable yapın ya da varsayılan verin), 'table-removed' (hedefte satırı olan tablo siliniyor). dataRisk bir UYARIDIR, apply'ı bloklamaz. items[].dependents[] ({ id, name, module }) dolu olan kalem, DALIN SİLDİĞİ ama development'ın dal açıldıktan sonra kullanmaya başladığı kayıttır: silme ÇAKIŞMAYA döner; hedef lehine çözüm kaydı ve bağımlısını korur, kaynak lehine çözüm siler (bağımlı FK ile düşebilir). Sorgunun çıktı DTO'su ve alanları aynı çakışma grubuna girer. Süreç kenarlarında (edges) iki taraf AYNI geçidin çıkışlarına dokunduysa yol 'versions[id=…].model.edges{from=<düğüm>}' olan TEK çakışma gelir; farklı geçitler kendiliğinden birleşir. Merge çevirileri (translation, adı 'key') ve microfunction'ları da taşır; microfunction hedefte TASLAK kalır, yayını kullanıcı yapar. derivedFromKey dolu olan kalem OTOMATİK ÜRETİLMİŞ bir kayıttır (varsayılan DTO); kaynağını (entity ya da query) çözdüğünüzde aynı yoldaki çakışması aynı tarafa KENDİLİĞİNDEN çözülür — ayrı ayrı ve zıt çözülemez. Uygulanmış planlarda title, description, createdBy ve appliedBy da gelir. kind=revert ise bu bir geri alma planıdır: revertsPlanId geri aldığı planı verir ve elements'te source merge ÖNCESİ, target ŞİMDİKİ değerdir. isStale: true ise plan alındığından beri DAL ya da development değişmiştir: items o değişikliği taşimaz ve merge_apply 409 döner — merge_refresh ile planı tazeleyin. elements[].isNoise: true olan eleman GÖSTERİM gürültüsüdür — kanvasın kendi durumu (workflow schema), DTO'dan türetilen şema (microservice schema.parameterScheme/returnScheme), sunucu yönetimli anahtar; merge gövdesinde KALIR ve uygulanır, yalnız okurken atlanır. Çakışan eleman asla işaretlenmez. items[].references[] o kalemin gövdesindeki guid'lerin karşılığıdır ({ id, name, module }): bir table step'in rule.entityId'si hangi tabloya, bir branch'in nextStepId'si hangi adıma, bir filtrenin fieldId'si hangi alana işaret ediyor — plan dışına çıkmadan okunur. items[].parentKey dolu olan kayıt başka bir kaydın çocuğudur (DTO çocukları, iç içe klasörler); ebeveyniyle birlikte okunur. items[].recordType kaydın modül içindeki türüdür — bir workflow kaydı 'workflow', 'automation' ya da 'middleware' olabilir ve modül üçüne de workflow der. items[].hiddenFields o kaydın GÖVDESİNDE okunmayacak anahtarlardır (aynı politika; eklenen/silinen kayıt tek eleman olarak geldiği için yolun değil anahtarın sorusudur).",
-        inputSchema: { projectId: guid, planId: guid, view: mergeView },
+        description: "Bir merge planını döner. items[] yalnız DEĞİŞEN kayıtları taşır; her kayıtta kind (add|update|delete|conflict) ve elements[] vardır. Çakışan elemanlarda base/source/target üç değeri birden gelir. dataRisk: true olan kalemde SEBEP dataRiskReasons[] içindedir: 'field-removed' (alan siliniyor), 'field-narrowed' (tip/nullable/unique daraltılıyor), 'not-null-without-default-on-populated-table' (hedefte satır varken varsayılansız NOT NULL alan ekleniyor — bu apply'ı DDL aşamasında düşürür, alanı nullable yapın ya da varsayılan verin), 'table-removed' (hedefte satırı olan tablo siliniyor). dataRisk bir UYARIDIR, apply'ı bloklamaz. items[].dependents[] ({ id, name, module }) dolu olan kalem, DALIN SİLDİĞİ ama development'ın dal açıldıktan sonra kullanmaya başladığı kayıttır: silme ÇAKIŞMAYA döner; hedef lehine çözüm kaydı ve bağımlısını korur, kaynak lehine çözüm siler (bağımlı FK ile düşebilir). Sorgunun çıktı DTO'su ve alanları aynı çakışma grubuna girer. Süreç kenarlarında (edges) iki taraf AYNI geçidin çıkışlarına dokunduysa yol 'versions[id=…].model.edges{from=<düğüm>}' olan TEK çakışma gelir; farklı geçitler kendiliğinden birleşir. Merge çevirileri (translation, adı 'key') ve microfunction'ları da taşır; microfunction hedefte TASLAK kalır, yayını kullanıcı yapar. derivedFromKey dolu olan kalem OTOMATİK ÜRETİLMİŞ bir kayıttır (varsayılan DTO); kaynağını (entity ya da query) çözdüğünüzde aynı yoldaki çakışması aynı tarafa KENDİLİĞİNDEN çözülür — ayrı ayrı ve zıt çözülemez. Uygulanmış planlarda title, description, createdBy ve appliedBy da gelir. kind=revert ise bu bir geri alma planıdır: revertsPlanId geri aldığı planı verir ve elements'te source merge ÖNCESİ, target ŞİMDİKİ değerdir. isStale: true ise plan alındığından beri DAL ya da development değişmiştir: items o değişikliği taşimaz ve merge_apply 409 döner — merge_refresh ile planı tazeleyin. elements[].isNoise: true olan eleman GÖSTERİM gürültüsüdür — kanvasın kendi durumu (workflow schema), DTO'dan türetilen şema (microservice schema.parameterScheme/returnScheme), sunucu yönetimli anahtar; merge gövdesinde KALIR ve uygulanır, yalnız okurken atlanır. Çakışan eleman asla işaretlenmez. items[].references[] o kalemin gövdesindeki guid'lerin karşılığıdır ({ id, name, module }): bir table step'in rule.entityId'si hangi tabloya, bir branch'in nextStepId'si hangi adıma, bir filtrenin fieldId'si hangi alana işaret ediyor — plan dışına çıkmadan okunur. items[].parentKey dolu olan kayıt başka bir kaydın çocuğudur (DTO çocukları, iç içe klasörler); ebeveyniyle birlikte okunur. items[].recordType kaydın modül içindeki türüdür — bir workflow kaydı 'workflow', 'automation' ya da 'middleware' olabilir ve modül üçüne de workflow der. items[].hiddenFields o kaydın GÖVDESİNDE okunmayacak anahtarlardır (aynı politika; eklenen/silinen kayıt tek eleman olarak geldiği için yolun değil anahtarın sorusudur). Bir taraf prop'un TİPİNİ (valueType: static → code) değiştirip öbür taraf da tipine ya da değerine (ref/data) dokunduysa eleman prop'un KENDİSİDİR: yol '…props[id=…]', base/source/target prop gövdesi, combinable: false — tip ile değer tek karardır. Nesne prop'unda (icon, surfaceStyle) anahtarın değeri '…ref.<anahtar>…', çizilen satırı '…children[name=<anahtar>]…' yolundadır; ikisi de çakışırsa kararı ref'e verin — satır karar istemez, unresolved'a sayılmaz; merge onu değerin birleşik hâlinden kurar. ÇÖZÜM DEĞER TAŞIR: elements[].combinable: true olan çakışma (kimliksiz ya da gruplu liste) both ile birleştirilebilir; elements[].value both/custom çözümünün yazılacak değeridir. kind='duplicate' OLASI KOPYADIR: iki taraf aynı içeriği farklı kimlikle eklemiş, twinPath development'taki ikizdir. combinable: true olan kopya ENGELLEMEZ — çözümsüzse ikisi de yazılır; kopyalar aynı slug'ı taşıyorsa (tablo alanı = kolon, sayfa = rota) combinable: false gelir, ikisi birden kalamaz: unresolved sayılır, both reddedilir, birini seçmek gerekir. Tablo alanında slug, bileşen prop'unda ad TEKİLDİR: içerik farklı olsa da aynı slug'lı alan ya da aynı adlı prop eklemesi combinable: false kopyadır; aynı ad farklı slug'lı iki alan ayrı eklenir (name-clash uyarısı). Development tabanda var olan bir alanı dalın eklediği slug'a yeniden adlandırdıysa dalın alanı yine duplicate gelir; base doludur (alanın taban hâli) ve source 400 döner — veri taşıyan alan silinmez, target ya da custom seçilir. target dalınkini düşürür, source development'ınkini çıkarır, custom tek öğe yazar; düşen kopyadan türemiş DTO alanı da düşer. summary.duplicates çözümsüz kopya sayısıdır. items[].derivedFromPath dolu olan DTO alanı tablo alanına bağlıdır (fields[id=…]); tablo alanı kararı ona kendiliğinden geçer. checks: true merge öncesi doğrulamayı da ekler: unresolved (error) · duplicate-open · name-clash (aynı adla iki kardeş) · dangling-reference (merge'ün düşürdüğü kimliğe kalan başvuru) — uyarılar engellemez, merge_apply'dan önce okunur.",
+        inputSchema: {
+            projectId: guid,
+            planId: guid,
+            view: mergeView,
+            checks: z.boolean().optional().describe("true ise planın merge öncesi doğrulaması (checks[]) yanıta eklenir; plan planned değilse boş gelir")
+        },
         annotations: readOnly
-    }, handle(config, ({ projectId, planId, view }) => platform.org('GET', `/merges/${projectId}/${planId}?view=${view ?? 'conflicts'}`)));
+    }, handle(config, async ({ projectId, planId, view, checks }) => {
+        const payload = await platform.org('GET', `/merges/${projectId}/${planId}?view=${view ?? 'conflicts'}`);
+        if (!checks)
+            return payload;
+        const checkPayload = await platform.org('GET', `/merges/${projectId}/${planId}/checks`);
+        return {
+            ...(payload && typeof payload === 'object' ? payload : { data: payload }),
+            checks: checkPayload?.data?.checks ?? []
+        };
+    }));
     server.registerTool('merge_resolve', {
         title: 'Merge çakışmalarını çöz',
-        description: "Çakışan elemanlar için dal (source) ya da development (target) seçimini plana yazar. Yalnız status=planned iken çalışır. path boş bırakılırsa o kaydın tüm çakışmaları aynı tarafa çözülür. YANIT ÖZETTİR: { planId, status, summary, resolved } — platform planın tamamını döner ama gateway onu kesip yalnız sayaçları verir (orta boy planda tam gövde 68-121 KB'a çıkıyor ve yanıt sınırını aşıyordu; çağrı hata gibi görünürken çözüm UYGULANMIŞ oluyordu). Planın kendisini görmek için merge_get { planId, view:'conflicts' } çağırın; kalan çakışma sayısı summary.unresolved'dadır.",
+        description: "Çakışan elemanlar ve olası kopyalar için kararı plana yazar: source (dal), target (development), both (iki tarafın birleşimi — yalnız combinable: true elemanda; kopyada ikisini de tut) ya da custom (value'daki değer). Yalnız status=planned iken çalışır. path boş bırakılırsa o kaydın tüm çakışmaları aynı karara çözülür. Türetilmiş kaydı (varsayılan DTO) kaynağına zıt çözmek 400 döner. YANIT ÖZETTİR: { planId, status, summary, resolved } — platform planın tamamını döner ama gateway onu kesip yalnız sayaçları verir (orta boy planda tam gövde 68-121 KB'a çıkıyor ve yanıt sınırını aşıyordu; çağrı hata gibi görünürken çözüm UYGULANMIŞ oluyordu). Planın kendisini görmek için merge_get { planId, view:'conflicts' } çağırın; kalan çakışma sayısı summary.unresolved'dadır.",
         inputSchema: { projectId: guid, planId: guid, resolutions: z.array(resolution).min(1) },
         annotations: updates
     }, handle(config, async ({ projectId, planId, resolutions }) => {
@@ -82,14 +102,14 @@ export function registerMergeTools(server, platform) {
     }));
     server.registerTool('merge_refresh', {
         title: 'Merge planını tazele',
-        description: "Açık bir planı dalın ve development'ın ŞU ANKİ hâline göre yeniden hesaplatır. İstek yerinde kalır: id'si, başlığı, açıklaması ve geçmişi korunur — yalnız değişiklik listesi yenilenir. KAYDEDİLMİŞ ÇAKIŞMA SEÇİMLERİ DÜŞER: yeni plan yeni elemanlar üretir, çözümler baştan verilir. Yalnız status=planned bir planda çalışır ve dal ready olmalıdır. Bayat bir planı (merge_get → isStale: true, ya da merge_apply 409) düzeltmenin yolu budur; merge_discard + merge_plan istemez. Asenkron: yanıt 202, plan planning durumundadır — merge_get ile planned bekleyin.",
+        description: "Açık bir planı dalın ve development'ın ŞU ANKİ hâline göre yeniden hesaplatır. İstek yerinde kalır: id'si, başlığı, açıklaması ve geçmişi korunur — yalnız değişiklik listesi yenilenir. DEĞİŞMEYEN ELEMANIN KARARI KORUNUR: aynı kalem, aynı yol ve üç tarafı (base/source/target) aynı kalan elemanın kararı ve değeri yeni plana taşınır; değişenler yeniden sorulur (etkinlikte merge.resolutions_carried { carried, dropped }). Yalnız status=planned bir planda çalışır ve dal ready olmalıdır. Bayat bir planı (merge_get → isStale: true, ya da merge_apply 409) düzeltmenin yolu budur; merge_discard + merge_plan istemez. Asenkron: yanıt 202, plan planning durumundadır — merge_get ile planned bekleyin.",
         inputSchema: { projectId: guid, planId: guid },
         annotations: writes
     }, handle(config, async ({ projectId, planId }) => {
         const payload = await platform.org('POST', `/merges/${projectId}/${planId}/refresh`);
         return {
             ...(payload && typeof payload === 'object' ? payload : { data: payload }),
-            note: "plan yeniden hesaplanıyor; merge_get ile status=planned bekleyin — çakışma çözümleri baştan verilir"
+            note: "plan yeniden hesaplanıyor; merge_get ile status=planned bekleyin — değişmeyen elemanların kararları korunur, yalnız değişenler yeniden sorulur"
         };
     }));
     server.registerTool('merge_revert', {

package/dist/tools/mobile.js

@@ -49,6 +49,7 @@ export function buildMobileAppPlan(input) {
     ];
 }
 /** Kabuk ağacı örnek dosyasından okunur — örnek ile aracın kurduğu layout tek kaynaktır. */
+const drawerButtonId = (pageSlug) => `menu_${pageSlug.replace(/[^A-Za-z0-9]+/g, '_')}`;
 function shellViews(input) {
     const example = JSON.parse(readKnowledgeFile('examples', input.drawer ? 'mobile-app-shell-drawer.json' : 'mobile-app-shell-stack.json'));
     const views = structuredClone(example.layoutCreate.views);
@@ -57,6 +58,19 @@ function shellViews(input) {
     const appBar = findAppBar(views);
     if (appBar && input.title)
         appBar.props.title = { type: 'static', ref: null, data: input.title };
+    // 37 S-9 / g-24: örneğin düğmeleri ŞABLONDUR; çekmece uygulamanın kendi sayfalarından birer düğme taşır.
+    const drawer = views.find(node => node.type === 'drawer');
+    const template = drawer?.children?.find(node => node.type === 'button');
+    if (drawer && template) {
+        drawer.children = input.pages.map(page => {
+            const elementId = drawerButtonId(page.pageSlug);
+            const button = structuredClone(template);
+            button.elementId = elementId;
+            button.name = elementId;
+            button.props = { ...button.props, text: { type: 'static', ref: null, data: page.pageName } };
+            return button;
+        });
+    }
     return views;
 }
 const SHELL_TYPES = ['app-bar', 'slot'];
@@ -274,7 +288,7 @@ export function registerMobileTools(server, platform) {
             ...(tabs ? { tabs: tabs.map(tab => tab.pageSlug) } : {}),
             completed,
             ...(warnings.length > 0 ? { warnings } : {}),
-            next: "Ekranları page_schema_patch ile doldurun; doğrulama page_screenshot (mobilde varsayılan device: 'phone'). platform_guide('mobile')."
+            next: `Ekranları page_schema_patch ile doldurun; doğrulama page_screenshot (mobilde varsayılan device: 'phone'). ${input.drawer ? `Çekmece düğmeleri sayfalardan türedi (${pages.map(page => drawerButtonId(page.pageSlug)).join(', ')}): her birine flow_create (host: 'layout', redirect) + layout_schema_patch set_event { event: 'click' } bağlayın. ` : ''}platform_guide('mobile').`
         };
     }));
 }