@appaflytech/zeyrek-ai-mcp 0.0.43 → 0.0.45

package/dist/tools/layouts.js

@@ -11,6 +11,8 @@ import { PlatformApiError } from '../platform/errors.js';
 import { handle } from '../platform/responses.js';
 import { applicationTypeField, resolveProfile } from '../knowledge/platform/resolve.js';
 import { screenProfileWarnings } from './profileWrite.js';
+import { enforceTextHooks, textHookOverrideParam } from './textHookGuard.js';
+import { attachFindings } from '../knowledge/policy.js';
 import { jsonArray } from '../platform/jsonArray.js';
 import { z } from 'zod';
 const patchOperationsParam = jsonArray(z.array(z.record(z.unknown())).min(1))
@@ -111,14 +113,16 @@ export function registerLayoutTools(server, platform) {
             name: z.string().min(1),
             views: viewsParam.optional(),
             events: eventsParam.optional(),
-            parameters: z.record(z.unknown()).optional()
+            parameters: z.record(z.unknown()).optional(),
+            policyOverride: textHookOverrideParam
         },
         annotations: writes
-    }, handle(config, async ({ project, environment, applicationId, name, views, events, parameters }) => {
+    }, handle(config, async ({ project, environment, applicationId, name, views, events, parameters, policyOverride }) => {
         const resolved = await resolveProfile(platform, applicationId);
         const named = fillComponentNames(views);
         assertScreenWriteGuards('layout', { schema: views, events }, resolved.profile.platform);
         assertNoRetiredNodes(views);
+        const textFindings = await enforceTextHooks(config, { platform, project, environment, applicationId, after: views ?? [], where: `layout '${name}'` }, policyOverride);
         const fixed = normalizeComponentDefaults(views);
         const catalogNotes = await assertScreenCatalog(platform, project, environment, applicationId, views, 'layout_create');
         const gaps = [
@@ -135,10 +139,10 @@ export function registerLayoutTools(server, platform) {
         const normalized = withWriteDiff(withNormalization(response, [...componentNameNote(named), ...componentDefaultsNote(fixed), ...catalogNotes, ...slotWarning(views)]), drops);
         const typeField = applicationTypeField(resolved);
         if (!normalized || typeof normalized !== 'object')
-            return normalized;
+            return attachFindings(normalized, textFindings);
         if (gaps.length === 0)
-            return Object.keys(typeField).length === 0 ? normalized : { ...normalized, ...typeField };
-        return { ...normalized, ...typeField, layoutWarnings: gaps };
+            return attachFindings(Object.keys(typeField).length === 0 ? normalized : { ...normalized, ...typeField }, textFindings);
+        return attachFindings({ ...normalized, ...typeField, layoutWarnings: gaps }, textFindings);
     }));
     server.registerTool('layout_update', {
         title: 'Layout güncelle',
@@ -151,15 +155,24 @@ export function registerLayoutTools(server, platform) {
             name: z.string().min(1).optional(),
             views: viewsParam.optional(),
             events: eventsParam.optional(),
-            parameters: z.record(z.unknown()).optional()
+            parameters: z.record(z.unknown()).optional(),
+            policyOverride: textHookOverrideParam
         },
         annotations: updates
-    }, handle(config, async ({ project, environment, applicationId, id, ...changes }) => {
+    }, handle(config, async ({ project, environment, applicationId, id, policyOverride, ...changes }) => {
         const overrides = Object.fromEntries(Object.entries(changes).filter(([, value]) => value !== undefined));
         const resolved = overrides.views === undefined ? undefined : await resolveProfile(platform, applicationId);
         const named = fillComponentNames(overrides.views);
         assertScreenWriteGuards('layout', { schema: overrides.views, events: overrides.events }, resolved?.profile.platform);
         const current = await fetchHost(platform, 'layout', project, environment, applicationId, id);
+        const textFindings = overrides.views === undefined
+            ? []
+            : await enforceTextHooks(config, {
+                platform, project, environment, applicationId,
+                after: overrides.views,
+                before: async () => current.views,
+                where: `layout '${String(current.name ?? id)}'`
+            }, policyOverride);
         const fixed = normalizeComponentDefaults(overrides.views);
         const catalogNotes = await assertScreenCatalog(platform, project, environment, applicationId, overrides.views, 'layout_update');
         const body = layoutUpdateBody({ ...current, applicationId }, overrides);
@@ -175,7 +188,7 @@ export function registerLayoutTools(server, platform) {
         const summary = { id, changed: Object.keys(overrides), preserved: { viewNodes: body.views.length } };
         if (gaps.length > 0)
             summary.layoutWarnings = gaps;
-        return withNormalization(summary, [...componentNameNote(named), ...componentDefaultsNote(fixed), ...catalogNotes, ...slotWarning(body.views)]);
+        return attachFindings(withNormalization(summary, [...componentNameNote(named), ...componentDefaultsNote(fixed), ...catalogNotes, ...slotWarning(body.views)]), textFindings);
     }));
     server.registerTool('layout_patch', {
         title: "Layout'a patch uygula",
@@ -187,10 +200,11 @@ export function registerLayoutTools(server, platform) {
             id: guid,
             operations: patchOperationsParam.optional(),
             ops: patchOperationsParam.optional().describe("'operations' ile aynı alan (eşanlamlı); JSON Patch işlemleriyle set_prop_type micro-op'ları KARIŞIK verilebilir"),
-            expectedUpdatedAt: z.string().optional().describe("layout_schema_get çıktısındaki updatedAt; eşleşmezse patch uygulanmaz (araya giren yazmayı ezmeyi engeller)")
+            expectedUpdatedAt: z.string().optional().describe("layout_schema_get çıktısındaki updatedAt; eşleşmezse patch uygulanmaz (araya giren yazmayı ezmeyi engeller)"),
+            policyOverride: textHookOverrideParam
         },
         annotations: updates
-    }, handle(config, async ({ project, environment, applicationId, id, operations: givenOperations, ops, expectedUpdatedAt }) => {
+    }, handle(config, async ({ project, environment, applicationId, id, operations: givenOperations, ops, expectedUpdatedAt, policyOverride }) => {
         const operations = microOps('layout_patch', ops, givenOperations);
         const current = await fetchHost(platform, 'layout', project, environment, applicationId, id);
         const audit = current.audit;
@@ -235,6 +249,12 @@ export function registerLayoutTools(server, platform) {
         const fixed = normalizeComponentDefaults(overrides.views);
         const catalogNotes = await assertScreenCatalog(platform, project, environment, applicationId, overrides.views, 'layout_patch');
         const body = layoutUpdateBody({ ...current, applicationId }, overrides);
+        const textFindings = await enforceTextHooks(config, {
+            platform, project, environment, applicationId,
+            after: body.views,
+            before: async () => original.views,
+            where: `layout '${String(current.name ?? id)}'`
+        }, policyOverride);
         // Gövde değil FARK gönderilir: gateway normalizasyonları (komponent varsayılanları, katalog
         // kuralları, value'suz olayların elenmesi) son hâle işlendikten sonra net diff hesaplanır.
         const finalDocument = { ...patched, name: body.name, parameters: body.parameters, views: body.views, events: body.events };
@@ -261,13 +281,13 @@ export function registerLayoutTools(server, platform) {
             summary.propTypes = propTypes.applied;
         if (gaps.length > 0)
             summary.layoutWarnings = gaps;
-        return withNormalization(summary, [
+        return attachFindings(withNormalization(summary, [
             ...componentNameNote(named),
             ...componentDefaultsNote(fixed),
             ...catalogNotes,
             ...slotWarning(body.views),
             ...resolved.notes.map(note => `patch yolu seçiciden indekse çözüldü: ${note}`)
-        ]);
+        ]), textFindings);
     }));
     server.registerTool('layout_delete', {
         title: 'Layout sil',

package/dist/tools/merges.js

@@ -1,4 +1,4 @@
-import { destructive, guid, pagingParams, readOnly, updates, writes } from './common.js';
+import { destructive, guid, pagingParams, readOnly, templateSubscriptionLock, updates, writes } from './common.js';
 import { handle } from '../platform/responses.js';
 import { z } from 'zod';
 const mergeView = z.enum(['summary', 'conflicts', 'full']).optional()
@@ -43,7 +43,7 @@ export function registerMergeTools(server, platform) {
     const config = platform.config;
     server.registerTool('merge_plan', {
         title: 'Merge planı oluştur',
-        description: "Bir dalı ebeveynine (development) merge etmek için üç yönlü diff planı ister. Hedef her zaman dalın ebeveynidir — production'a merge eden bir yol YOKTUR. title ZORUNLUDUR: isteğin adıdır ve geçmişte o adla durur. Asenkron: yanıt 202 döner, plan hemen dolu değildir. Projede açık bir plan varsa 400 döner; önce onu uygulayın ya da merge_discard ile bırakın. Süreç tanımları ve iş takvimleri planda modül olarak görünür (fark versions[…].model.nodes[<düğüm id>] yolunda); örnekler, görevler, defter ve uyarlamalar merge edilmez.",
+        description: `Bir dalı ebeveynine (development) merge etmek için üç yönlü diff planı ister. Hedef her zaman dalın ebeveynidir — production'a merge eden bir yol YOKTUR. title ZORUNLUDUR: isteğin adıdır ve geçmişte o adla durur. Asenkron: yanıt 202 döner, plan hemen dolu değildir. Projede açık bir plan varsa 400 döner; önce onu uygulayın ya da merge_discard ile bırakın. Süreç tanımları ve iş takvimleri planda modül olarak görünür (fark versions[…].model.nodes[<düğüm id>] yolunda); örnekler, görevler, defter ve uyarlamalar merge edilmez. ${templateSubscriptionLock}`,
         inputSchema: { projectId: guid, sourceEnvironmentId: guid, title: mergeTitle, description: mergeDescription },
         annotations: writes
     }, handle(config, async ({ projectId, sourceEnvironmentId, title, description }) => {
@@ -61,7 +61,7 @@ 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). 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.",
+        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. Kayıt taşıma ayarı açık tabloların SATIRLARI da gelir: module='row' kalemi bir tablodur (recordId entity kimliği, name tablo adı), satır farkı 'rows.<anahtar>', hücre farkı 'rows.<anahtar>.<sütun>' yolundadır; yalnız dalın değişiklikleri kalem üretir, development'ın kendi satırları plana girmez. İki taraf tabanda olmayan aynı anahtarla farklı satır açtıysa 'rows.<anahtar>' yolunda base'i boş TEK çakışma gelir (kimlik çakışması) — ayrıntı rehberde (Tablo kayıtları). 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) · not-applicable (error: kararın yazılacağı yer development'ta yok — apply düşer; merge_refresh edip o yolda yeniden karar ver) · 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,
@@ -81,7 +81,7 @@ export function registerMergeTools(server, platform) {
     }));
     server.registerTool('merge_resolve', {
         title: 'Merge çakışmalarını çöz',
-        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.",
+        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; tablo satırının kimlik çakışmasında development'ın satırı kalır, dalın satırı YENİ ANAHTARLA eklenir, metin anahtarda 400) 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. ${templateSubscriptionLock}`,
         inputSchema: { projectId: guid, planId: guid, resolutions: z.array(resolution).min(1) },
         annotations: updates
     }, handle(config, async ({ projectId, planId, resolutions }) => {
@@ -90,7 +90,7 @@ export function registerMergeTools(server, platform) {
     }));
     server.registerTool('merge_apply', {
         title: 'Merge planını uygula',
-        description: "Planı tek transaction'da development'a uygular ve dalın şemasını düşürür. İsteğin adı zaten plan açılırken verilir; apply ayrı bir mesaj almaz. Asenkron: yanıt 202 döner. Çözülmemiş çakışma varsa 409 döner. PLAN BAYATSA DA 409 döner: plan alındıktan sonra DAL ya da development değiştiyse apply reddedilir — plan dalın o anki fotoğrafını taşır, uygulansaydı sonradan yapılan iş sessizce düşerdi. Çözümü merge_refresh'tir; yeni plan açmanız gerekmez.",
+        description: `Planı tek transaction'da development'a uygular ve dalın şemasını düşürür. İsteğin adı zaten plan açılırken verilir; apply ayrı bir mesaj almaz. Asenkron: yanıt 202 döner. Çözülmemiş çakışma varsa 409 döner. PLAN BAYATSA DA 409 döner: plan alındıktan sonra DAL ya da development değiştiyse apply reddedilir — plan dalın o anki fotoğrafını taşır, uygulansaydı sonradan yapılan iş sessizce düşerdi. Çözümü merge_refresh'tir; yeni plan açmanız gerekmez. ${templateSubscriptionLock}`,
         inputSchema: { projectId: guid, planId: guid },
         annotations: writes
     }, handle(config, async ({ projectId, planId }) => {
@@ -102,7 +102,7 @@ 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. 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.",
+        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. ${templateSubscriptionLock}`,
         inputSchema: { projectId: guid, planId: guid },
         annotations: writes
     }, handle(config, async ({ projectId, planId }) => {
@@ -114,7 +114,7 @@ export function registerMergeTools(server, platform) {
     }));
     server.registerTool('merge_revert', {
         title: "Uygulanmış merge'i geri al",
-        description: "Uygulanmış bir merge'i geri alan YENİ bir plan açar; kaynak plan silinmez, reverted olur ve geçmişte kalır. Yalnız status=applied|applied-with-drift ve kind=merge planlar geri alınabilir, pencere RevertWindowDays (varsayılan 7 gün) — dışında 400 döner. Ters plan kaynak plandaki her işlemi tersine çevirir: eklenen kayıt silinir, silinen geri gelir, değişen eski gövdesine döner. Merge'den SONRA elle değiştirilen kayıtlar conflict gelir ve orada source = merge öncesi değer, target = şimdiki değer demektir. Asenkron: yanıt 202, ters plan planning durumundadır.",
+        description: `Uygulanmış bir merge'i geri alan YENİ bir plan açar; kaynak plan silinmez, reverted olur ve geçmişte kalır. Yalnız status=applied|applied-with-drift ve kind=merge planlar geri alınabilir, pencere RevertWindowDays (varsayılan 7 gün) — dışında 400 döner. Ters plan kaynak plandaki her işlemi tersine çevirir: eklenen kayıt silinir, silinen geri gelir, değişen eski gövdesine döner; tablo satırları (module='row') da aynı kuralla döner. Merge'den SONRA elle değiştirilen kayıtlar conflict gelir ve orada source = merge öncesi değer, target = şimdiki değer demektir. Asenkron: yanıt 202, ters plan planning durumundadır. ${templateSubscriptionLock}`,
         inputSchema: { projectId: guid, planId: guid },
         annotations: writes
     }, handle(config, async ({ projectId, planId }) => {
@@ -126,7 +126,7 @@ export function registerMergeTools(server, platform) {
     }));
     server.registerTool('merge_discard', {
         title: 'Merge planından vazgeç',
-        description: "Planı uygulamadan kapatır. Uygulanmakta olan (status=applying) bir plan bırakılamaz — 400 döner. Dal ve şeması olduğu gibi kalır.",
+        description: `Planı uygulamadan kapatır. Uygulanmakta olan (status=applying) bir plan bırakılamaz — 400 döner. Dal ve şeması olduğu gibi kalır. ${templateSubscriptionLock}`,
         inputSchema: { projectId: guid, planId: guid },
         annotations: destructive
     }, handle(config, ({ projectId, planId }) => platform.org('DELETE', `/merges/${projectId}/${planId}`)));

package/dist/tools/microfunctions.js

@@ -2,7 +2,7 @@ import { guid, projectParam, environmentParam, pagingParams, readOnly, writes, u
 import { constraintSummary } from '../knowledge/backendConstraints.js';
 import { unmappedMembers, withUnmappedMembers } from '../knowledge/schemaGuard.js';
 import { evaluatePolicy, enforcePolicy, attachFindings } from '../knowledge/policy.js';
-import { policyRules } from '../knowledge/rules.js';
+import { policyRules, microfunctionArchiveEntrypointFindings } from '../knowledge/rules.js';
 import { handle } from '../platform/responses.js';
 import { z } from 'zod';
 const policyOverrideParam = z.boolean().optional()
@@ -19,7 +19,7 @@ const definitionInput = {
     language: z.enum(['node', 'python']).describe("Çalışma dili. Inline kaynakta dosya adı sabittir: node → function.js (exports.handler = async (args, context) => …), python → function.py (def handler(args, context))"),
     provider: z.enum(['built-in', 'aws-lambda']).describe("'built-in' platformun kendi Fission kümesinde koşar ve runtime hesabı İSTEMEZ (runtimeId boş kalır); 'aws-lambda' müşterinin kendi hesabında koşar ve runtimeId ZORUNLUDUR. 'azure-functions' enum'da tanımlı ama v1'de reddedilir (Faz 2)"),
     runtimeId: guid.optional().describe("AWS Lambda hesabı (microfunction_runtime_list). provider 'built-in' ise VERİLMEZ; 'aws-lambda' ise zorunlu ve hesabın provider'ı fonksiyonunkiyle aynı olmalı"),
-    sourceKind: z.enum(['inline', 'archive']).describe("'inline' ⇒ code zorunlu (≤ 512 KB, standart kütüphane; bağımlılık YOK); 'archive' ⇒ önce kayıt açılır, zip Studio'dan yüklenir (MCP'de zip yükleme yok — Faz 2) ve entrypoint 'modül.fonksiyon' olarak verilir"),
+    sourceKind: z.enum(['inline', 'archive']).describe("'inline' ⇒ code zorunlu (≤ 512 KB); dış paketler dependencies ile bildirilir. 'archive' ⇒ entrypoint 'modül.fonksiyon' olarak verilir; dosyalar zip'in içinde yaşar ve microfunction_archive_scaffold (iskelet) + microfunction_files_apply ile yazılır — paketler zip'teki requirements.txt / package.json'dadır, dependencies yok sayılır. Tek parça zip yükleme MCP'de yok (Studio'dan)"),
     code: z.string().optional().describe("Inline kaynak kodu. Sözleşme: tek bir handler dışa aktarılır, args çağrı argümanları, context SALT OKUNUR anlık görüntüdür (input/variables/steps/user/request/language/project/environment). Yazma yalnız dönüş değeriyle olur. Ayrıntı: platform_guide('microfunction')"),
     entrypoint: z.string().optional().describe("Zip kaynağında 'modül.fonksiyon' (ör. 'handlers/sum.handler'). Inline kaynakta gateway'in de platformun da beklediği sabit 'function.handler'dır — vermeyin"),
     parameterDtoId: guid.optional().describe("Çağrı argümanlarının sözleşmesi (DataTransferObject). Workflow step'i ifadeyi bu şemaya göre yazar; boşsa args = {} gider"),
@@ -29,8 +29,17 @@ const definitionInput = {
     timeoutSeconds: z.number().int().min(1).max(900).optional().describe("Fonksiyon bütçesi; varsayılan 30. Built-In üst sınırı 300, Lambda 900. Bütçe dolarsa çağrı MicrofunctionInvocationTimeoutException ile step'in fail dalına düşer"),
     memoryMb: z.number().int().min(128).max(3008).optional().describe("Varsayılan 256. Built-In'de yalnız kaydedilir (küme environment limiti geçerlidir); Lambda'da gerçekten uygulanır"),
     environmentVariables: environmentVariablesParam.optional(),
+    dependencies: z.string().optional().describe("Inline kaynağın dış paketleri, SATIR BAŞINA BİR PAKET (≤ 16 KB; boş ve '#' satırları yorum). python: requirements.txt satırı olduğu gibi — 'pillow==11.1.0', 'requests>=2.32'; pip seçeneği ('-r', '--index-url', '-e') YASAK. node: 'ad@aralık' — 'sharp@^0.33.0', '@scope/ad@1.2', aralıksız 'dayjs' → latest. Built-In'de yayın paketleri Fission builder'da kurar: yayın build süresince (5 dk'ya kadar) 'publishing' kalır, kurulum düşerse publish-failed ve publishError'da build günlüğünün son 4 KB'ı. aws-lambda'da KURULMAZ (MF-007) — paketler zip'te gelmeli. archive kaynağında yok sayılır (manifest zip'te). Built-In Python 3.13, Node 22 (Lambda'daki sürümlerle aynı); C uzantılı paketler (Pillow gibi) hazır wheel'den kurulur"),
+    testArguments: z.string().optional().describe("Studio Test call'unun kayıtlı argüman metni (≤ 64 KB, MicrofunctionTestArgumentsTooLarge); olduğu gibi saklanır, JSON geçerliliği DENETLENMEZ ve koşuma girmez. update TAM GÖVDEDİR: verilmezse kayıtlı metin silinir — önce microfunction_get'ten alın. Kaydetmek revision'ı artırır (yayındaki kayıt hasUnpublishedChanges: true olur)"),
     publish: z.boolean().optional().describe("true: kayıt açıldıktan/güncellendikten sonra aynı çağrıda yayın istenir ('Kaydet ve yayınla'). Yayın ASENKRONDUR — çağrı status: 'publishing' döner; sonucu microfunction_get ile izleyin (published | publish-failed + publishError)")
 };
+const archiveOperationInput = z.object({
+    type: z.enum(['write-file', 'create-directory', 'delete', 'rename']).describe("write-file: dosyayı oluşturur ya da içeriğini değiştirir · create-directory: boş klasör · delete: dosya ya da klasör (altındaki HER girdiyle) · rename: dosya ya da klasörü newPath'e taşır (klasörse altındakilerle)"),
+    path: z.string().min(1).describe("Zip içindeki yol, '/' ayraçlı: 'main.js', 'lib/util.js'. Kökle (/) başlamaz, / ile bitmez; boş, '.' ve '..' segmenti ve ters bölü içermez. Klasör yolu da sondaki / OLMADAN yazılır ('lib')"),
+    content: z.string().optional().describe("write-file için zorunlu. Metin dosyasında düz metin; ikili dosyada base64 + encoding: 'base64' (MCP'den tek dosya ≤ 8 MB)"),
+    encoding: z.enum(['utf8', 'base64']).optional().describe("content'in kodlaması; varsayılan utf8"),
+    newPath: z.string().optional().describe('rename için zorunlu hedef yol; path ile aynı kurallar. Hedef dolu olamaz, klasör kendi altına taşınamaz')
+});
 const runtimeInput = {
     name: z.string().min(1).max(255).describe('Hesap adı; benzersiz'),
     provider: z.literal('aws-lambda').optional().describe("v1'de yalnız 'aws-lambda' kabul edilir; gönderilmezse gateway onu koyar"),
@@ -101,11 +110,52 @@ export function registerMicrofunctionTools(server, platform) {
             project: projectParam,
             environment: environmentParam,
             id: guid,
-            args: z.record(z.unknown()).optional().describe("Fonksiyona giden argüman nesnesi (handler'ın ilk parametresi); parameterDtoId varsa o şemaya uymalı"),
+            args: z.unknown().optional().describe("Handler'ın ilk parametresi; herhangi bir JSON değeri. parameterBehavior 'object' ⇒ nesne, 'array' ⇒ dizi, 'primitive' ⇒ tek değer (workflow step'inin gönderdiği şekille aynı). parameterDtoId varsa o şemaya uymalı; boşsa {} gider"),
             preview: z.boolean().optional().describe("true: shim logları (console.log/print) zarfın logs alanında döner. false/boş: logs boş gelir — hata ayıklarken açın")
         },
         annotations: updates
     }, handle(config, ({ project, environment, id, args, preview }) => platform.tenant('POST', project, `/microfunctions/${id}/invoke`, { environment, body: { args, preview } })));
+    server.registerTool('microfunction_files_list', {
+        title: 'Microfunction arşiv dosyalarını listele',
+        description: "Zip kaynaklı microfunction'ın arşivindeki dosya ve klasörleri listeler: { hash, entries: [{ path, size, isDirectory }] }. Yalnız zip'te açık girdisi olan klasörler listelenir; ara klasörler dosya yollarından çıkar. microfunction_files_apply'a vereceğiniz expectedHash BURADAN gelir — yazmadan önce bu tool'u çağırın. Arşiv yoksa hash null ve liste boştur: sıfırdan başlamak için microfunction_archive_scaffold.",
+        inputSchema: { project: projectParam, environment: environmentParam, id: guid },
+        annotations: readOnly
+    }, handle(config, ({ project, environment, id }) => platform.tenant('GET', project, `/microfunctions/${id}/archive/entries`, { environment })));
+    server.registerTool('microfunction_file_get', {
+        title: 'Microfunction arşiv dosyasını oku',
+        description: "Arşivdeki tek dosyanın içeriğini döner: { path, size, isBinary, content }. 1 MB'ı aşan ya da UTF-8 metin olmayan dosyada isBinary: true ve content boştur — içeriği görmek için zip'in tamamı Studio'dan indirilir. Yol yoksa ya da klasörse 404.",
+        inputSchema: {
+            project: projectParam,
+            environment: environmentParam,
+            id: guid,
+            path: z.string().min(1).describe("Zip içindeki dosya yolu, microfunction_files_list'teki path ile aynı: 'lib/util.js'")
+        },
+        annotations: readOnly
+    }, handle(config, ({ project, environment, id, path }) => platform.tenant('GET', project, `/microfunctions/${id}/archive/file`, { environment, query: { path } })));
+    server.registerTool('microfunction_files_apply', {
+        title: 'Microfunction arşiv dosyalarını değiştir',
+        description: "Arşive bir dizi dosya işlemini TEK seferde uygular; platform yeni zip üretir, kayıt yeni archiveHash alır, revision artar ve eski zip nesnesi silinir. İşlemler SIRAYLA uygulanır. expectedHash microfunction_files_list'ten okunan hash'tir: kayıt o arada değiştiyse 409 (MicrofunctionArchiveConflictException) döner ve hiçbir şey yazılmaz — listeyi yeniden okuyup işlemleri ona göre kurun. Arşivi olmayan kayıtta expectedHash VERİLMEZ. Kayıt yayındaysa runtime eski sürümü koşmaya devam eder: yeni kod için microfunction_publish; yayın, entrypoint modülü zip'te yoksa 400 döner. " + constraintSummary('ApplyMicrofunctionArchiveChangesCommand'),
+        inputSchema: {
+            project: projectParam,
+            environment: environmentParam,
+            id: guid,
+            expectedHash: z.string().optional().describe("microfunction_files_list'in döndürdüğü hash; arşiv yoksa verilmez"),
+            operations: z.array(archiveOperationInput).describe('Sırayla uygulanan işlemler; en az 1'),
+            policyOverride: policyOverrideParam
+        },
+        annotations: updates
+    }, handle(config, async ({ project, environment, id, policyOverride, ...body }) => {
+        const findings = enforcePolicy(evaluatePolicy(config, policyRules, 'microfunctionArchive', body, { operation: 'update' }, policyOverride));
+        const entrypointFindings = await microfunctionArchiveEntrypointFindings(platform, project, environment, id, body.operations);
+        const drift = unmappedMembers('ApplyMicrofunctionArchiveChangesCommand', body);
+        return attachFindings(withUnmappedMembers(await platform.tenant('POST', project, `/microfunctions/${id}/archive/changes`, { environment, body }), drift), [...findings, ...entrypointFindings]);
+    }));
+    server.registerTool('microfunction_archive_scaffold', {
+        title: 'Microfunction arşiv iskeleti oluştur',
+        description: "Arşivi olmayan kayda dilin iskelet dosyalarını yazar ve kaydı zip kaynağına çevirir: node → main.js + package.json (boş dependencies), python → main.py + requirements.txt (yalnız yorum); entrypoint ikisinde de 'main.handler' olur. Paketler bu manifest dosyalarına yazılır (microfunction_files_apply) ve Built-In yayında kurulur. Arşiv zaten varsa 409 — mevcut dosyaları microfunction_files_list ile okuyun. Node'da giriş modülü index.js OLAMAZ: index.js platform shim'inin adıdır ve yayın bunu 400 ile reddeder.",
+        inputSchema: { project: projectParam, environment: environmentParam, id: guid },
+        annotations: writes
+    }, handle(config, ({ project, environment, id }) => platform.tenant('POST', project, `/microfunctions/${id}/archive/scaffold`, { environment })));
     server.registerTool('microfunction_runtime_list', {
         title: 'Microfunction runtime hesaplarını listele',
         description: "Bulut runtime hesaplarını (v1: AWS Lambda) listeler; secretAccessKey maskeli döner. Built-In fonksiyonların runtime kaydı YOKTUR — liste boşsa yalnız provider: 'built-in' fonksiyon tanımlayabilirsiniz.",