@appaflytech/zeyrek-ai-mcp 0.0.7 → 0.0.9

package/dist/tools/projects.js

@@ -8,6 +8,7 @@ import { z } from 'zod';
 import { evaluatePolicy, enforcePolicy, attachFindings } from '../knowledge/policy.js';
 import { policyRules } from '../knowledge/rules.js';
 import { constraintSummary } from '../knowledge/backendConstraints.js';
+import { readProjectTheme } from '../knowledge/themeSchema.js';
 import { readProjectLanguages, runtimeResolvesTranslations, resolveSeedLanguages, SEED_LANGUAGES, SEED_DEFAULT_LANGUAGE } from '../knowledge/languages.js';
 const languageCode = z.string().regex(/^[a-z]{2}$/, 'ISO 639-1 iki harfli küçük dil kodu (tr, en, de …)');
 function localizationFix(state) {
@@ -80,6 +81,45 @@ const templateOptionsInput = z.object({
     templateId: guid,
     templateReceiveUpdates: z.boolean().optional()
 });
+const themeInput = z.union([z.string(), z.record(z.unknown())]);
+/**
+ * `Theme` form alanının değeri. Platform alanı JSON METNİ olarak alıyor
+ * (`UpdateOrganizationProjectCommand.Theme` bir `string`), ama ajan doğal olarak nesne yazıyor:
+ * nesne gateway'de serileştirilir. Metin verildiyse JSON olduğu İSTEK GİTMEDEN denetlenir —
+ * geçersiz metin platformda `ToJsonDocument()` sırasında patlar ve mesaj hangi alanın bozuk
+ * olduğunu söylemez.
+ */
+export function themeField(theme, tool) {
+    if (theme === undefined)
+        return undefined;
+    if (typeof theme !== 'string')
+        return JSON.stringify(theme);
+    try {
+        JSON.parse(theme);
+    }
+    catch (error) {
+        throw new PlatformApiError(`${tool}: 'theme' metni JSON olarak çözülemedi (${error.message}). Temayı nesne olarak verin — gateway serileştirir.`, 400);
+    }
+    return theme;
+}
+/**
+ * `PUT /projects/{id}` gövdesinin ortak üçlüsü.
+ *
+ * Uç bir REPLACE'tir ve eksik alan "koru" değil **SİL** demektir: `OrganizationProject.Override`
+ * `Theme = theme;` satırını koşulsuz çalıştırır (`OrganizationProject.cs:103`), `Updated` olayı da
+ * sonucu her aktif ortamın tenant kaydına kopyalar
+ * (`UpdateProjectWhenOrganizationProjectUpdatedEventHandler.cs:36`). Yani yalnız dil ayarını
+ * değiştiren bir çağrı markanın tamamını düşürüyordu ve yanıt 200 dönüyordu (S-1). Gövdeyi kuran
+ * tek yer burasıdır ki aynı uca yazan her tool aynı korumayı paylaşsın.
+ */
+export function projectUpdateForm(fields) {
+    const form = new URLSearchParams({ Name: fields.name });
+    if (fields.slug)
+        form.set('Slug', fields.slug);
+    if (fields.theme !== undefined)
+        form.set('Theme', fields.theme);
+    return form;
+}
 export function registerProjectTools(server, platform) {
     const config = platform.config;
     server.registerTool('project_list', {
@@ -105,7 +145,7 @@ export function registerProjectTools(server, platform) {
         inputSchema: {
             name: z.string().min(1),
             slug: z.string().min(1).describe('Organizasyonda tekil; veritabanı adı zeyrek_<org>_<slug> bundan türer ve sonradan değiştirmek bütün runtime rotalarını kırar'),
-            theme: z.string().optional().describe('Tema JSON\'u string olarak'),
+            theme: themeInput.optional().describe("Tema nesnesi (ya da JSON metni) — Studio tema panelinin yazdığı kayıtla aynı şekil: mode · palette · paletteDark · fontFamily · typeScale · shadow · presets · componentPresets. Verilmezse proje platformun varsayılan temasıyla (accent #0052CC, Inter 14px) doğar. Kurulmuş bir projenin temasını DEĞİŞTİRMEK için theme_update: kısmi günceller, şema/lint'ten geçirir ve hangi CSS değişkeninin değiştiğini söyler"),
             languages: z.array(z.string().min(1)).min(1).optional().describe(`Proje dilleri (ISO 639-1; 'tr-TR' gibi bölgeli değer kabul edilir ve 'tr'ye indirgenir, indirgeme gatewayNormalized ile bildirilir). Verilmezse gateway [${SEED_LANGUAGES.join(', ')}] tohumlar — projenin dilsiz doğmasına ve çevirilerin sessizce çözülmemesine izin verilmez`),
             defaultLanguage: z.string().min(1).optional().describe(`languages içinde olmalı (indirgenmiş hâliyle karşılaştırılır); yalnız defaultLanguage verirseniz languages onunla kurulur. İkisi de yoksa '${SEED_DEFAULT_LANGUAGE}'`),
             application: applicationInput.optional(),
@@ -130,8 +170,9 @@ export function registerProjectTools(server, platform) {
         }
         const form = new URLSearchParams({ Name: args.name, Slug: args.slug });
         const notes = [];
-        if (args.theme)
-            form.set('Theme', args.theme);
+        const theme = themeField(args.theme, 'project_create');
+        if (theme !== undefined)
+            form.set('Theme', theme);
         if (args.application) {
             form.set('Application.Slug', args.application.slug);
             form.set('Application.Name', args.application.name);
@@ -171,13 +212,15 @@ export function registerProjectTools(server, platform) {
             id: guid,
             name: z.string().min(1).optional().describe('Verilmezse mevcut ad korunur — yalnız dil ayarını değiştirmek için adı tekrar göndermeniz gerekmez'),
             slug: z.string().optional(),
-            theme: z.string().optional(),
+            theme: themeInput.optional().describe("Tema nesnesi (ya da JSON metni); verilen kayıt mevcut temanın YERİNE geçer — bir alanı değiştirmek için theme_update kullanın (kısmi birleştirir, lint'ten geçirir). VERİLMEZSE mevcut tema korunur — gateway projeden okuyup gövdeye geri koyar, çünkü platform Theme alanı gövdede yokken temayı siler ve silinen tema bütün ortamların runtime'ına iner (S-1). Temayı gerçekten temizlemek için theme: {} verin"),
             languages: z.array(languageCode).min(1).optional().describe("ISO 639-1 iki harfli kod listesi (proje dilleri, platformun 184 kodluk sözlüğünden — PRJ-002). Runtime çevirileri YALNIZ bu kodlarla çözer; liste kurulmadan yazılan çeviriler 200 döner ama ekrana ham anahtar basılır (S-15). Yeni proje bu liste BOŞ doğar — çeviri kullanacaksanız burayı kurmak ilk adımdır"),
             defaultLanguage: languageCode.optional().describe("languages içinde olmalı — proje dilleri hiç kurulmadıysa (ilk kurulumda) tek başına verilebilir. Runtime kayıtlı dil seçimi yokken buna düşer; boşsa aktif dil hiç seçilmez ve ilk açılışta bütün etiketler ham anahtar çizilir")
         },
         annotations: updates
     }, handle(config, async (args) => {
         const findings = enforcePolicy(evaluatePolicy(config, policyRules, 'project', args, { operation: 'update' }));
+        // Çağıranın hatası okumadan ÖNCE döner: bozuk tema metni için projeyi çekmenin anlamı yok.
+        const requestedTheme = themeField(args.theme, 'project_update');
         // Platform gövdede slug yoksa onu ADDAN yeniden üretiyor. Yalnız dil ayarını değiştiren bir
         // çağrı bu yüzden 'test_dev' slug'ını 'mcp-benchmark' yapmıştı ve o an bütün runtime URL'leri
         // kırılmıştı (09-05 Corecruiter koşusu, S-11). Gateway mevcut değerleri okuyup gövdeye koyar;
@@ -185,16 +228,15 @@ export function registerProjectTools(server, platform) {
         const current = ((await platform.org('GET', `/projects/${args.id}`))?.data ?? {});
         const currentSlug = typeof current.slug === 'string' ? current.slug : undefined;
         const currentName = typeof current.name === 'string' ? current.name : undefined;
+        // Tema da aynı korumaya muhtaç ve aynı okumadan gelir — ek istek yok (S-1, projectUpdateForm).
+        const currentTheme = current.theme !== null && typeof current.theme === 'object' ? current.theme : undefined;
         const name = args.name ?? currentName;
         const slug = args.slug ?? currentSlug;
         if (name === undefined) {
             throw new PlatformApiError(`'${args.id}' projesinin adı okunamadı; name alanını açıkça verin (platform bu uçta adı zorunlu tutuyor).`, 400);
         }
-        const form = new URLSearchParams({ Name: name });
-        if (slug)
-            form.set('Slug', slug);
-        if (args.theme)
-            form.set('Theme', args.theme);
+        const theme = requestedTheme ?? (currentTheme === undefined ? undefined : JSON.stringify(currentTheme));
+        const form = projectUpdateForm({ name, slug, theme });
         const languages = args.languages ? normalizeLanguageCodes(args.languages, 'languages') : undefined;
         const defaultLanguage = args.defaultLanguage ? normalizeLanguageCode(args.defaultLanguage, 'defaultLanguage') : undefined;
         languages?.codes.forEach(code => form.append('Languages', code));
@@ -212,6 +254,9 @@ export function registerProjectTools(server, platform) {
                 : []),
             ...(args.name === undefined && currentName !== undefined
                 ? [`project_update gövdesine mevcut ad ('${currentName}') gateway tarafından kondu (name verilmedi).`]
+                : []),
+            ...(args.theme === undefined && currentTheme !== undefined
+                ? ["project_update gövdesine mevcut TEMA gateway tarafından kondu: platform Theme alanı gövdede yokken temayı SİLİYOR (Override koşulsuz yazar) ve silinen tema bütün ortamların runtime'ına iner — yalnız dil ayarını değiştiren bir çağrı markanın tamamını düşürüyordu (S-1). Temayı gerçekten temizlemek istiyorsanız theme: {} verin."]
                 : [])
         ];
         return attachFindings(withNormalization(payload, notes), findings);
@@ -278,9 +323,20 @@ export function registerProjectTools(server, platform) {
         // Dil durumu haritanın parçası: `pick` null/undefined alanları eler, yani dilsiz projede
         // languages haritadan da sessizce düşerdi — eksikliği görünmez kılan tam o davranış (`S-15`).
         const languageState = readProjectLanguages(projectPayload);
+        const themeSummary = readProjectTheme(projectPayload);
         return {
             project: pick(projectData, ['id', 'slug', 'name', 'languages', 'defaultLanguage']),
             ...(languageState ? { localization: localizationBlock(languageState) } : {}),
+            // Tema haritanın parçası: projenin markası olup olmadığı, sayfa kurmadan önce bilinmesi
+            // gereken bir şeydir ve `pick` onu göstermezdi.
+            theme: themeSummary === undefined
+                ? { hasTheme: false }
+                : {
+                    hasTheme: true,
+                    mode: themeSummary.mode === 'dark' ? 'dark' : 'light',
+                    presets: Object.keys(themeSummary.presets ?? {}),
+                    componentPresets: Object.keys(themeSummary.componentPresets ?? {})
+                },
             environments: (Array.isArray(projectData.environments) ? projectData.environments : []).map(entry => pick(entry, ['id', 'name'])),
             environment: platform.resolveEnvironment(environment),
             applications,
@@ -300,6 +356,7 @@ export function registerProjectTools(server, platform) {
                 ...(languageState && !runtimeResolvesTranslations(languageState)
                     ? [`DİKKAT: projenin dil ayarı eksik (localization bloğuna bakın) — çeviri yazsanız bile runtime her etiketi ham anahtar olarak basar. Etiketleri translation_* üzerinden verecekseniz ÖNCE ${localizationFix(languageState)}.`]
                     : []),
+                "Tema/preset'ler: theme_get (view:'resolved' ekrana inen --ng-* değerlerini verir).",
                 "Detay: entity_get/microservice_get/workflow_get (büyük kayıtlarda view:'outline'); değişiklik: *_patch. Automation'lar entity başına: automation_list(entityId) — ağaçtaki automationCount yalnız platform sayıyorsa görünür."
             ].join(' ')
         };

package/dist/tools/queries.js

@@ -6,10 +6,57 @@ import { unmappedMembers, withUnmappedMembers } from '../knowledge/schemaGuard.j
 import { handle } from '../platform/responses.js';
 import { z } from 'zod';
 import { evaluatePolicy, enforcePolicy, attachFindings } from '../knowledge/policy.js';
-import { policyRules } from '../knowledge/rules.js';
+import { policyRules, rawQueryParameterNames } from '../knowledge/rules.js';
+import { PlatformApiError } from '../platform/errors.js';
 import { constraintSummary } from '../knowledge/backendConstraints.js';
 const policyOverrideParam = z.boolean().optional()
     .describe('true: politika block bulgularını warn\'a indirir (bilinçli istisna; yanıtta işaretlenir)');
+function inferredParameterType(value) {
+    if (typeof value === 'number')
+        return Number.isInteger(value) ? 'number' : 'float';
+    if (typeof value === 'boolean')
+        return 'bool';
+    if (Array.isArray(value))
+        return 'array';
+    if (value !== null && typeof value === 'object')
+        return 'object';
+    return 'text';
+}
+/**
+ * G-13 — `PreviewQueryCommand` değeri yalnız `parameters[].value`'dan okur; üst düzey `parameters`
+ * argümanı şemada yokken SDK tarafından hata vermeden atılıyordu ve sorgu NULL'la koşuyordu.
+ * Argüman artık komutun kendi alanına bağlanır.
+ */
+function bindPreviewParameters(definition, parameters, notes) {
+    const names = Object.keys(parameters ?? {});
+    if (parameters === undefined || names.length === 0)
+        return definition;
+    const rows = (Array.isArray(definition.parameters) ? definition.parameters : []);
+    const conflicts = names.filter(name => {
+        const row = rows.find(entry => entry?.name === name);
+        return row !== undefined && row.value !== undefined && JSON.stringify(row.value) !== JSON.stringify(parameters[name]);
+    });
+    if (conflicts.length > 0) {
+        throw new PlatformApiError(`parameters ile definition.parameters aynı adı farklı değerle taşıyor: ${conflicts.map(name => `'${name}'`).join(', ')}. Değeri tek yerde verin.`, 400);
+    }
+    const bound = rows.map(row => typeof row?.name === 'string' && row.name in parameters ? { ...row, value: parameters[row.name] } : row);
+    const added = names.filter(name => !rows.some(row => row?.name === name));
+    notes.push(`parameters definition.parameters[].value'ya bağlandı: ${names.join(', ')}${added.length > 0 ? ` (tipi değerden çıkarılıp eklenen satır: ${added.join(', ')})` : ''}`);
+    return {
+        ...definition,
+        parameters: [...bound, ...added.map(name => ({ name, type: inferredParameterType(parameters[name]), value: parameters[name] }))]
+    };
+}
+/** `language` sayılmaz: platform `{{language}}` kullanan sorguya değeri kendisi ekler (`PreviewQueryCommand.cs`). */
+function unboundPreviewParameters(definition) {
+    const rows = (Array.isArray(definition.parameters) ? definition.parameters : []);
+    return rawQueryParameterNames(definition.rawQuery)
+        .filter(name => name.toLowerCase() !== 'language')
+        .filter(name => {
+        const value = rows.find(row => row?.name === name)?.value;
+        return value === undefined || value === null || (typeof value === 'string' && value.trim() === '');
+    });
+}
 export function registerQueryTools(server, platform) {
     const config = platform.config;
     server.registerTool('query_list', {
@@ -26,7 +73,7 @@ export function registerQueryTools(server, platform) {
     }, handle(config, ({ project, environment, id }) => platform.tenant('GET', project, `/queries/${id}`, { environment })));
     server.registerTool('query_create', {
         title: 'Query oluştur',
-        description: "Yeni query tanımlar (ham SQL). definition = CreateQueryCommand gövdesi. AGREGASYON VE RAPORLAMANIN YOLU BUDUR (SUM/COUNT/AVG/GROUP BY, dönemsel özet, KPI) — view_* bir TAM METİN ARAMA indeksidir, özet üretmez (09-02 M-3). VAR OLAN SATIRLARDAN TÜRETİLEN SATIR YAZMANIN DA YOLU BUDUR: 'INSERT … SELECT' kaydedip query kaynaklı bir uçtan çalıştırmak, geçmiş/hareket/junction tablosunu TEK çağrıda doldurur ve hiçbir id elle taşınmaz (ölçüldü 2026-09-07; reçete platform_guide('entity') §'Toplu ve türetilmiş satır'). Kayıt sırasında gövde bir kez ÇALIŞTIRILIR ama geri alınır — yazan sorguyu kaydetmek satır bırakmaz ve 'returnScheme' boş döner. Kayıtlı query'nin parametreleri parameterScheme ile tanımlanır ve runtime'da bağlanır; tüketimi source:'query' microservice'idir. PARAMETRENİN DEĞERİ HER ZAMAN ÇAĞRIDAN GELİR (body → query-string → header): parametreye ifade kaynağı verilemez (parameters[].source komut şemasında yoktur, platform sessizce atar) ve middleware'in kurduğu user bu yola girmez. Kimlik/tenant kapsamı sunucu tarafında zorlanacaksa sorguyu bir workflow query adımından çağırın — reçete platform_guide('microservice') §'Kimlik kapsaması × uç kaynağı'. BOŞ STRING parametre NULL'a çevrilir: '= @p' koşulu hiçbir satırla eşleşmez ve sorgu sessizce 0 satır döner — 'filtre yok' için (@p IS NULL OR ...) yazın ya da sentinel kullanın. Yorum içindeki belirteç parametre sayılmaz. SQL çalıştırılamazsa kayıt YİNE de oluşur: returnScheme boş kalır ve yanıttaki message nedeni söyler — SQL'i düzeltip query_update ile kaydedin. SORGUNUN KENDİ AÇIKLAMASI VAR: `description` alanını doldurun — sorgu listesinde ad ve slug dışında ipucu yoktur ve ucun açıklaması (MS-014) bunun yerine geçmez, çünkü bir sorgu birden çok uçtan tüketilir; boş bırakılırsa gateway `QRY-006` uyarısı düşürür (yazmayı durdurmaz). " + constraintSummary('CreateQueryCommand'),
+        description: "Yeni query tanımlar (ham SQL). definition = CreateQueryCommand gövdesi. AGREGASYON VE RAPORLAMANIN YOLU BUDUR (SUM/COUNT/AVG/GROUP BY, dönemsel özet, KPI) — view_* bir TAM METİN ARAMA indeksidir, özet üretmez (09-02 M-3). VAR OLAN SATIRLARDAN TÜRETİLEN SATIR YAZMANIN DA YOLU BUDUR: 'INSERT … SELECT' kaydedip query kaynaklı bir uçtan çalıştırmak, geçmiş/hareket/junction tablosunu TEK çağrıda doldurur ve hiçbir id elle taşınmaz (ölçüldü 2026-09-07; reçete platform_guide('entity') §'Toplu ve türetilmiş satır'). Kayıt sırasında gövde bir kez ÇALIŞTIRILIR ama geri alınır — yazan sorguyu kaydetmek satır bırakmaz ve 'returnScheme' boş döner. Kayıtlı query'nin parametreleri parameterScheme ile tanımlanır ve runtime'da bağlanır; tüketimi source:'query' microservice'idir. PARAMETRENİN DEĞERİ HER ZAMAN ÇAĞRIDAN GELİR (body → query-string → header): parametreye ifade kaynağı verilemez (parameters[].source komut şemasında yoktur, platform sessizce atar) ve middleware'in kurduğu user bu yola girmez. Kimlik/tenant kapsamı sunucu tarafında zorlanacaksa sorguyu bir workflow query adımından çağırın — reçete platform_guide('microservice') §'Kimlik kapsaması × uç kaynağı'. BOŞ STRING parametre NULL'a çevrilir: '= @p' koşulu hiçbir satırla eşleşmez ve sorgu sessizce 0 satır döner — 'filtre yok' için (@p IS NULL OR ...) yazın ya da sentinel kullanın; (@p = '' OR ...) kalıbı hiçbir zaman eşleşmez ve gateway `QRY-007` uyarısı düşürür. Yorum içindeki belirteç parametre sayılmaz. SQL çalıştırılamazsa kayıt YİNE de oluşur: returnScheme boş kalır ve yanıttaki message nedeni söyler — SQL'i düzeltip query_update ile kaydedin. SORGUNUN KENDİ AÇIKLAMASI VAR: `description` alanını doldurun — sorgu listesinde ad ve slug dışında ipucu yoktur ve ucun açıklaması (MS-014) bunun yerine geçmez, çünkü bir sorgu birden çok uçtan tüketilir; boş bırakılırsa gateway `QRY-006` uyarısı düşürür (yazmayı durdurmaz). " + constraintSummary('CreateQueryCommand'),
         inputSchema: { project: projectParam, environment: environmentParam, definition: definitionParam, policyOverride: policyOverrideParam },
         annotations: writes
     }, handle(config, async ({ project, environment, definition, policyOverride }) => {
@@ -59,12 +106,31 @@ export function registerQueryTools(server, platform) {
     server.registerTool('query_preview', {
         title: 'Query önizle',
         description: "Kaydedilmemiş query tanımını datasource üzerinde çalıştırır. definition = PreviewQueryCommand gövdesi. Preview ROLLBACK edilir: yazan bir sorgu (INSERT/UPDATE/DELETE) çalışır, affectedRowCount gerçek sayıyı döner ama SATIR KALMAZ (ölçüldü, 09-04 Y-19) — yazmayı doğrulamak için sorguyu kaydedip microservice/workflow üzerinden çalıştırın. YANITTA ROLLBACK İŞARETİ YOKTUR: 2026-09-07'de ölçüldü, yazan sorgunun yanıtı yalnız { affectedRowCount, elapsedMilliseconds } taşıyor — sayı başarı gibi görünür, tek kanıt sonradan row_list çekmektir. BOŞ STRING parametre NULL'a çevrilir (üç koşuda ölçüldü): '= @p' hiçbir satırla eşleşmez, 0 satır döner ve hata yoktur. Davranış kuralları: platform_guide('microservice'). " + constraintSummary('PreviewQueryCommand'),
-        inputSchema: { project: projectParam, environment: environmentParam, datasourceId: guid, definition: definitionParam, language: languageParam, policyOverride: policyOverrideParam },
+        inputSchema: {
+            project: projectParam,
+            environment: environmentParam,
+            datasourceId: guid,
+            definition: definitionParam,
+            parameters: z.record(z.unknown()).optional()
+                .describe("Önizleme değerleri (ad → değer). definition.parameters[] içindeki aynı adlı satırın value'suna yazılır; satır yoksa tipi değerden çıkarılarak eklenir (tam sayı → number, ondalık → float, true/false → bool, diğerleri → text). Aynı ad definition.parameters'ta FARKLI bir value ile de varsa çağrı gönderilmez."),
+            language: languageParam,
+            policyOverride: policyOverrideParam
+        },
         annotations: writes
-    }, handle(config, async ({ project, environment, datasourceId, definition, language, policyOverride }) => {
-        const findings = enforcePolicy(evaluatePolicy(config, policyRules, 'query', definition, { operation: 'preview' }, policyOverride));
+    }, handle(config, async ({ project, environment, datasourceId, definition: given, parameters, language, policyOverride }) => {
         const notes = [];
+        const definition = bindPreviewParameters(given, parameters, notes);
+        const findings = enforcePolicy(evaluatePolicy(config, policyRules, 'query', definition, { operation: 'preview' }, policyOverride));
         const headers = languageHeader(language, notes);
-        return attachFindings(withNormalization(await platform.tenant('POST', project, `/queries/${datasourceId}/preview`, { environment, body: definition, headers }), notes), findings);
+        const payload = await platform.tenant('POST', project, `/queries/${datasourceId}/preview`, { environment, body: definition, headers });
+        const unbound = unboundPreviewParameters(definition);
+        const withUnbound = unbound.length > 0 && payload && typeof payload === 'object' && !Array.isArray(payload)
+            ? {
+                ...payload,
+                unboundParameters: unbound,
+                unboundParametersNote: "rawQuery bu parametrelere başvuruyor ama değerleri yok ya da boş string (platform boş string'i NULL'a çevirir) — sorgu onları NULL ile koştu. Değeri üst düzey 'parameters' ya da definition.parameters[].value ile verin."
+            }
+            : payload;
+        return attachFindings(withNormalization(withUnbound, notes), findings);
     }));
 }

package/dist/tools/schemaOps.js

@@ -0,0 +1,280 @@
+import { isFlexContainer, schemaOpValidationErrors, FLEX_LAYOUT_PROP_NAMES, PAGE_CONTAINER_ELEMENT_ID } from '../knowledge/normalize.js';
+import { findNode, outlineAppliedPatch } from './screens.js';
+import { setPropTypeErrors } from '../knowledge/propTypes.js';
+import { PlatformApiError } from '../platform/errors.js';
+import { z } from 'zod';
+/*
+ * Şema micro-op'larının gateway tarafı: sayfa (`page_schema_patch`), layout (`layout_schema_patch`)
+ * ve widget (`component_schema_patch`) aynı sunucu sözlüğünü (`PageSchemaMicroOpApplier`) konuşur,
+ * bu yüzden op planlama ve istek öncesi reddetme tek yerde durur.
+ */
+/**
+ * Yazma yanıtındaki şema gövdesinin biçimi (B-55 · S-9). Varsayılan `outline`: gövde ajanın
+ * aynı turda kendi gönderdiği içeriğin yankısıdır, kanıt ise pointer'da ve `silentlyDropped`ta
+ * durur. Bayrağı bilmeyen ajan pahalı olanı ödemesin diye kırpma OPT-OUT'tur (aynı karar:
+ * `DS-004`, `datasource_configuration_options`).
+ */
+export const writeViewParam = z.enum(['outline', 'full']).optional().describe("Yanıttaki şema gövdesinin biçimi. outline (VARSAYILAN): komponent ağaçları iskelete iner (id/elementId/name/type/children), appliedPatch her op'un op+path'ini verir — 'yalnız o komponente mi dokunuldu' kanıtı JSON Pointer'dadır, 'kaydedildi mi' kanıtı silentlyDropped'tadır. full: platformun döndürdüğü gövde aynen gelir.");
+/**
+ * `appliedPatch` zarfın altında da gelebilir (`{ data: { appliedPatch } }`), düz de.
+ */
+export function outlineWriteResponse(response) {
+    const inner = response.data;
+    const container = (inner && typeof inner === 'object' && !Array.isArray(inner) ? inner : response);
+    if (Array.isArray(container.appliedPatch))
+        container.appliedPatch = outlineAppliedPatch(container.appliedPatch);
+}
+export const opsParam = z.array(z.record(z.unknown())).describe("Micro-op listesi. Op sözlüğü: replace_prop {target, prop, value} (value ham değer, code sarmalı {type: 'code', ref: '{{ … }}'} ya da translation sarmalı {type: 'translation', ref: '<çeviri anahtarı>'} — prop tipini değiştirmek için komponenti silip yeniden EKLEMEYİN, ona yazan setter'ların hedefi silinir (FLOW-018); platform replace_prop'ta expression alanını OKUMAZ — gateway onu code sarmalına çevirir) | set_binding {target, prop, expression: '{{ Page.variables.x }}'} | add_component {parent (üst elementId ya da 'root'), index?, component} | remove_component {target} | move_component {target, parent, index?, position: {x, y}} (index ÇİZİM sırası değildir, runtime çocukları blocks.position'a göre (y, sonra x) çizer. page_schema_patch'te flex kapta gateway index'i görünen sıraya çevirir ve kardeş konumlarını yeniden yazar; ızgara kapta sırayı position.y verir, sona eklemeyen index PAGE-033 uyarısıdır. layout_schema_patch ve component_schema_patch bu çeviriyi YAPMAZ: orada sırayı position.y ile verin) | set_event {target, event, eventValue} | remove_event {target, event} (olayı diziden çıkarır; target: 'page' sayfa düzeyi olaylar. set_event ile eventValue: null olay SİLMEZ, değersiz ölü kayıt bırakır. Olmayan olay 422 missing-event) | set_validations {target, validations: [{type, message, value, isActive}]} (komponentin validation listesini TAMAMEN değiştirir; boş dizi hepsini siler) | set_appearance {target, appearance: {heightType?, widthType?, tooltip?, background?, …}} (kurulu düğümün appearance'ına YALNIZ verilen alanları yazar, gerisini korur; null alanı temizler; bilinmeyen alan unknown-appearance-field ile reddedilir. GÖRÜNÜRLÜK appearance'ta DEĞİLDİR: gizlemek için replace_prop {target, prop: 'isHidden', value: true}, koşul için set_binding {prop: 'isHidden'} — add_component gövdesindeki appearance.isHidden'ı gateway props.isHidden'a taşır) | resize_component {target, size?: {w,h}, appearance?: {widthType,widthString,heightType,heightString}, states?: {isWrapper,isScrollable,isSticky,isDroppable,isFloating,isQuickStack}, breakpoint?: 1024} (gateway adı: platforma set_block {target, breakpoint, size} + set_appearance {target, appearance} + set_states {target, states} olarak gider — o üç op'u doğrudan da gönderebilirsiniz. move_component'e konan size reddedilir. Izgarada blocks[].size, flex'te appearance geçerlidir; ebeveynin düzeni yazılanı etkisiz kılıyorsa PAGE-019 uyarısı çıkar. states bir PROP DEĞİL düğüm alanıdır ve replace_prop onu yazamaz — düğümü silmeden isWrapper bayrağını değiştirmenin yolu budur). set_prop_type {target, prop, propType: 'static'|'code'|'translation', ref?, data?} (replace_prop sarmalıyla aynı sonucu verir ve mevcut data'yı tasarım yedeği olarak taşır. Bu op prop'un TİPİNİ yerinde değiştirir. Taşıyıcı alan tipe göre: static → data, code ve translation → ref (runtime data'yı her turda ezer, anahtar yalnız ref'te yaşar). Eksik taşıyıcı istek gönderilmeden reddedilir; page_schema_validate aynı kararı verir) | reorder {parent ('root' ya da elementId), order: [çocuk elementId'lerinin TAMAMI, yeni sırada]} (yalnız DİZİ sırasını değiştirir; çizim sırası blocks.position'dır — görünen sırayı değiştirmek için konumları set_block/move_component ile de yazın) | set_state_binding {target, binding: {name, expression, targets}} (ada göre ekler/değiştirir) | remove_state_binding {target, name} | batch {gestureId?, label?, ops: [...]} (iç içe batch yok). target = elementId. İstek atomiktir: tek op reddedilirse hiçbiri yazılmaz.");
+/**
+ * PAGE-008 — `set_event` uydurma bir olay adıyla 200 döner ve bağ SESSİZCE ölü kalır: motor olayı
+ * komponentin yaydığı adla eşleştirir, eşleşme yoksa akış hiç çalışmaz. Kontrol yalnız hedefin
+ * tipini ve o tipin katalogdaki olay listesini pozitif olarak çözebildiğinde konuşur (okunan ağaçta
+ * olmayan hedefler — sayfa yamasında layout düğümleri — ve katalogda olay tanımlamayan tipler
+ * doğrulanmadan geçer).
+ */
+export function unknownEventOps(ops, typesByElementId, eventsBySlug) {
+    return ops
+        .map(op => op)
+        .filter(op => op.op === 'set_event')
+        .flatMap(op => {
+        const target = String(op.target ?? '');
+        const event = String(op.event ?? '');
+        const type = typesByElementId.get(target);
+        const declared = type ? eventsBySlug.get(type) : undefined;
+        if (!event || !declared || declared.includes(event))
+            return [];
+        return [`'${target}' (${type}) komponenti '${event}' diye bir olay YAYMAZ. Yaydıkları: ${declared.join(', ')}. Platform bu op'u 200 ile kabul eder ama bağ sessizce ölü kalır — akış hiçbir zaman çalışmaz. Doğru adı component_get(slug:'${type}') çıktısındaki events listesinden alın.`];
+    });
+}
+/**
+ * Ön kontroller eskiden İLK hatada fırlatıyordu: dört op'u yanlış olan bir yama dört ayrı turda
+ * ancak görülüyordu ve her tur tüm planı yeniden gönderiyordu (S-11, 2026-09-15). Artık op başına
+ * toplanır ve tek yanıtta döner. Yama yine ATOMİKTİR — birbirine bağlı op'lar (add_component +
+ * set_event) yarım kalmasın diye geçenler de gönderilmez.
+ */
+export function rejectedOpsMessage(unordered) {
+    const rejected = [...unordered].sort((left, right) => left.index - right.index);
+    const lines = rejected.map(entry => `#${entry.index} ${entry.op}${entry.target ? ` '${entry.target}'` : ''} [${entry.code}]: ${entry.message}`);
+    const validationHint = rejected.some(entry => entry.code === 'PAGE-016')
+        ? " PAGE-016 çalışan biçimi dört alanı da taşır: { type: 'required'|'email'|'regex'|'max-length'|'min-length'|'max-value'|'min-value'|'value-options', message: '<kullanıcıya görünen metin>', value: <eşik/desen/true>, isActive: true }."
+        : '';
+    return `Ön kontrol ${rejected.length} op'u reddetti; yama atomik olduğu için HİÇBİR op gönderilmedi (istek gönderilmedi). Düşen op'ları düzeltip TÜM listeyi tek çağrıda yeniden gönderin.${validationHint}\n${lines.join('\n')}\nrejectedOps: ${JSON.stringify(rejected)}`;
+}
+export function collectTypes(nodes, into) {
+    for (const node of nodes ?? []) {
+        if (typeof node.elementId === 'string' && typeof node.type === 'string')
+            into.set(node.elementId, node.type);
+        collectTypes(node.children, into);
+    }
+}
+export function removeNodeFromTree(nodes, target, parent) {
+    for (let index = 0; index < nodes.length; index++) {
+        if (nodes[index].elementId === target)
+            return { node: nodes.splice(index, 1)[0], parent };
+        const found = removeNodeFromTree(nodes[index].children ?? [], target, nodes[index]);
+        if (found)
+            return found;
+    }
+    return undefined;
+}
+function setDesktopPosition(node, position) {
+    const blocks = Array.isArray(node.blocks) ? node.blocks : [];
+    const block = blocks.find(entry => Number(entry?.breakpoint) === 1024);
+    if (block)
+        block.position = { x: Number(position.x ?? 0), y: Number(position.y ?? 0) };
+}
+/**
+ * PAGE-010 boşluk analizi patch'in SONUCUNU görmek zorunda: tek başına op'lardaki y değerleri,
+ * kapsayıcının mevcut çocukları bilinmeden anlamsız. Op'lar okunan şemanın kopyasına uygulanır
+ * (add: parent'ın children'ına ekle — kökler retargetRootAdds ile page_container'a gittiği için
+ * burada da öyle çözülür; move: düğümü taşı — parent verilmemişse aynı ebeveynde kalır — ve verilen
+ * position'ı desktop block'una yaz; ikisinde de index platformdaki gibi diziye yerleşir) ve analiz
+ * yalnız dokunulan kapsayıcılarda koşar.
+ */
+export function simulateLayoutOps(schema, ops) {
+    const touched = new Set();
+    const attach = (node, requestedParent, index) => {
+        const parentId = typeof requestedParent === 'string' && requestedParent !== '' && requestedParent !== 'root'
+            ? requestedParent
+            : PAGE_CONTAINER_ELEMENT_ID;
+        const parent = findNode(schema, parentId);
+        const siblings = parent ? [...(parent.children ?? [])] : schema;
+        const insertAt = typeof index === 'number' && Number.isFinite(index) ? Math.max(0, Math.min(index, siblings.length)) : siblings.length;
+        siblings.splice(insertAt, 0, node);
+        if (parent) {
+            parent.children = siblings;
+            touched.add(String(parent.elementId ?? parentId));
+        }
+        else {
+            touched.add('kök');
+        }
+    };
+    for (const op of ops) {
+        if (op.op === 'add_component' && op.component && typeof op.component === 'object') {
+            attach(JSON.parse(JSON.stringify(op.component)), op.parent, op.index);
+        }
+        // Düzen prop'ları (layout/flex grubu) simülasyona girer: PAGE-010 flex kapsayıcının içini
+        // analiz etmez, PAGE-015 ise op'tan SONRAKİ layout değerine bakar — ikisi de op uygulanmadan
+        // doğru karar veremez.
+        if (op.op === 'replace_prop' && FLEX_LAYOUT_PROP_NAMES.has(String(op.prop ?? ''))) {
+            const target = findNode(schema, String(op.target ?? ''));
+            const codeWrapper = op.value && typeof op.value === 'object' && op.value.type === 'code';
+            if (target)
+                target.props = { ...(target.props ?? {}), [String(op.prop)]: codeWrapper ? op.value : { type: 'static', ref: null, data: op.value } };
+        }
+        if (op.op === 'move_component') {
+            const moved = removeNodeFromTree(schema, String(op.target ?? ''));
+            if (!moved)
+                continue;
+            if (op.position && typeof op.position === 'object')
+                setDesktopPosition(moved.node, op.position);
+            attach(moved.node, op.parent ?? moved.parent?.elementId ?? 'root', op.index);
+        }
+    }
+    return touched;
+}
+/**
+ * F-8 — olay kaldırma 2026-09-14'e kadar gateway emülasyonuydu (şemayı okuyup tam PUT). Artık
+ * platformun `remove_event` op'u; `target: 'page'` sayfa düzeyi olayları hedefler ve olmayan olay
+ * sessizce yutulmaz, `missing-event` ile 422 döner.
+ */
+export function planEventRemovals(ops) {
+    return ops.map(op => {
+        const target = String(op.target ?? '');
+        const event = String(op.event ?? '');
+        if (!target || !event)
+            throw new PlatformApiError("remove_event için 'target' ve 'event' zorunludur.", 400);
+        return `${target}.${event}`;
+    });
+}
+function findParentNode(nodes, target) {
+    for (const node of nodes) {
+        if ((node.children ?? []).some(child => child.elementId === target))
+            return node;
+        const deeper = findParentNode(node.children ?? [], target);
+        if (deeper)
+            return deeper;
+    }
+    return undefined;
+}
+/**
+ * G-25 — `states` bir prop değil düğüm alanı ve `replace_prop` onu yazamaz. Anahtar kümesi beyaz
+ * listeyle sınırlı: platform bilinmeyen anahtarı `unknown-states-field` ile reddeder ama ajan mesajı
+ * burada, istek gönderilmeden daha açık.
+ */
+const WRITABLE_STATES = new Set(['isWrapper', 'isScrollable', 'isSticky', 'isDroppable', 'isFloating', 'isQuickStack']);
+/**
+ * `resize_component` gateway'in op adıdır (G-14): ızgarada boyut `blocks[].size`, flex'te
+ * `appearance`, bayraklar `states`. 2026-09-14'ten beri sunucu üçünü de kendi op'larıyla yazar
+ * (`set_block`, `set_appearance`, `set_states`); gateway yalnız çevirir. Tam GET + tam PUT yolu
+ * kalktı — bir sayfaya dokunan tek istek PATCH'tir.
+ */
+export function resizeServerOps(op) {
+    const target = String(op.target ?? '');
+    const size = op.size && typeof op.size === 'object' ? op.size : undefined;
+    const appearance = op.appearance && typeof op.appearance === 'object' ? op.appearance : undefined;
+    const states = op.states && typeof op.states === 'object' ? op.states : undefined;
+    return [
+        ...(size ? [{ op: 'set_block', target, breakpoint: Number(op.breakpoint ?? 1024), size }] : []),
+        ...(appearance ? [{ op: 'set_appearance', target, appearance }] : []),
+        ...(states ? [{ op: 'set_states', target, states }] : [])
+    ];
+}
+/**
+ * Sunucu hedefi ve bloğu kendisi doğrular; burada okunan sayfadan yapılan kontrol ajana bağlamı
+ * olan bir mesaj ve PAGE-019/020 uyarıları içindir. `size` yalnız verilen kenarı taşır: eksik
+ * kenar okunan bloktan tamamlanır, yoksa sunucu 0 yazardı.
+ */
+export function planResizes(schema, ops, readTool = 'page_schema_get') {
+    const serverOps = [];
+    const applied = [];
+    const warnings = [];
+    for (const op of ops) {
+        const target = String(op.target ?? '');
+        const size = op.size && typeof op.size === 'object' ? op.size : undefined;
+        const appearance = op.appearance && typeof op.appearance === 'object' ? op.appearance : undefined;
+        const states = op.states && typeof op.states === 'object' ? op.states : undefined;
+        const breakpoint = Number(op.breakpoint ?? 1024);
+        if (!target)
+            throw new PlatformApiError("resize_component için 'target' zorunludur.", 400);
+        if (!size && !appearance && !states) {
+            throw new PlatformApiError(`resize_component '${target}' için 'size' ({ w, h } — ızgara), 'appearance' ({ widthType, widthString, heightType, heightString } — flex) ya da 'states' ({ isWrapper, isScrollable, isSticky, isDroppable, isFloating, isQuickStack }) verilmelidir; üçü de boş.`, 400);
+        }
+        if (states) {
+            const unknownStates = Object.keys(states).filter(key => !WRITABLE_STATES.has(key));
+            if (unknownStates.length > 0) {
+                throw new PlatformApiError(`resize_component '${target}': bilinmeyen states anahtarı (${unknownStates.join(', ')}). Yazılabilir bayraklar: ${[...WRITABLE_STATES].join(', ')}.`, 400);
+            }
+        }
+        const node = findNode(schema, target);
+        if (!node)
+            throw new PlatformApiError(`resize_component hedefi bulunamadı: '${target}'. ${readTool} ile elementId'leri listeleyin.`, 400);
+        const parent = findParentNode(schema, target);
+        const inFlex = parent !== undefined && isFlexContainer(parent);
+        let resolved = op;
+        if (size) {
+            const blocks = Array.isArray(node.blocks) ? node.blocks : [];
+            const block = blocks.find(entry => Number(entry?.breakpoint) === breakpoint);
+            if (!block) {
+                throw new PlatformApiError(`resize_component '${target}' düğümünde ${breakpoint} breakpoint'li blok yok (var olanlar: ${blocks.map(entry => entry?.breakpoint).join(', ') || 'hiç'}). Farklı bir breakpoint verin ya da düğümü add_component ile blokları kurulu olarak ekleyin.`, 400);
+            }
+            const current = (block.size ?? {});
+            const merged = { w: Number(size.w ?? current.w ?? 0), h: Number(size.h ?? current.h ?? 0) };
+            resolved = { ...op, size: merged };
+            applied.push(`${target}.size=${JSON.stringify(merged)}`);
+            if (inFlex) {
+                warnings.push(`PAGE-019 (uyarı): '${target}' düğümünün ebeveyni flex kapsayıcı; orada yerleşimi 'blocks[].size' DEĞİL appearance (widthType/widthString/heightType/heightString) belirler. Boyut yazıldı ama ekranda etkisi olmayabilir — flex'te ölçü vermek için aynı op'a 'appearance' koyun.`);
+            }
+        }
+        if (states) {
+            applied.push(`${target}.states=${JSON.stringify(states)}`);
+            if (states.isWrapper === true) {
+                warnings.push(`PAGE-020 (uyarı): '${target}' düğümüne isWrapper:true yazıldı — runtime sarmalayıcı düğüme 'min-height: 80vh' veriyor ve bu, sayfanın altına yüzlerce piksel ölü boşluk ekleyebilir (ölçüldü 09-05: dokuz düğüm ~1600px). style ile ezilemez; gerekmiyorsa isWrapper:false bırakın.`);
+            }
+        }
+        if (appearance) {
+            applied.push(`${target}.appearance=${JSON.stringify(appearance)}`);
+            if (!inFlex && parent !== undefined) {
+                warnings.push(`PAGE-019 (uyarı): '${target}' düğümünün ebeveyni flex DEĞİL; ızgarada yerleşimi 'blocks[].size' belirler ve appearance genişlik/yükseklik alanları etkisiz kalabilir. Izgarada ölçü vermek için aynı op'a 'size' koyun.`);
+            }
+        }
+        serverOps.push(...resizeServerOps(resolved));
+    }
+    return { serverOps, applied, warnings };
+}
+/**
+ * `set_prop_type` (P0-2) 2026-09-14'ten beri platformun op'u; taşıyıcı kuralı
+ * (`PROP_TYPE_CARRIER`) iki tarafta aynı. Hedef okunan sayfada aranır ki ajan "bulunamadı"yı
+ * bağlamıyla alsın; `value` eşanlamlısı sunucunun `data` alanına taşınır.
+ */
+export function planPropTypes(schema, ops, readTool = 'page_schema_get') {
+    const missing = ops.map(op => String(op.target ?? '')).find(target => !findNode(schema, target));
+    if (missing !== undefined) {
+        throw new PlatformApiError(`set_prop_type hedefi bulunamadı: '${missing}'. ${readTool} ile elementId'leri listeleyin.`, 400);
+    }
+    return {
+        serverOps: ops.map(({ value, ...op }) => (op.data === undefined && value !== undefined ? { ...op, data: value } : op)),
+        applied: ops.map(op => {
+            const current = findNode(schema, String(op.target))?.props;
+            return `${op.target}.${op.prop}: ${current?.[String(op.prop)]?.type ?? '(yok)'} → ${op.propType}`;
+        })
+    };
+}
+/**
+ * İstek gitmeden reddedilen gövde hataları. `normalizeSchemaOps` ÖNCE koşmalıdır: PAGE-016 yalnız
+ * normalizasyonun tamamlayamadığı validation gövdelerini sayar.
+ */
+export function assertOpBodies(opRecords, propTypeOps) {
+    const propTypeIssues = setPropTypeErrors(propTypeOps);
+    if (propTypeIssues.length > 0)
+        throw new PlatformApiError(`set_prop_type gövdesi eksik (istek gönderilmedi): ${propTypeIssues.join(' · ')}`, 400);
+    const sizedMoves = opRecords.filter(entry => entry.op === 'move_component' && entry.size !== undefined);
+    if (sizedMoves.length > 0) {
+        throw new PlatformApiError(`move_component yalnız 'position' uygular; gövdeye konan 'size' platformda SESSİZCE düşer (ölçüldü 2026-09-04, appliedPatch'te yalnız /blocks/0/position görünür). Boyut için resize_component kullanın: { op: 'resize_component', target: '<elementId>', size: { w, h } } — flex kapsayıcı içindeyse 'appearance'. Etkilenen hedefler: ${sizedMoves.map(entry => entry.target).join(' · ')}`, 400);
+    }
+    const validationIssues = schemaOpValidationErrors(opRecords);
+    if (validationIssues.length > 0) {
+        throw new PlatformApiError(`PAGE-016 — validation gövdesi eksik (istek gönderilmedi): ${validationIssues.join(' · ')}. `
+            + "Çalışan biçim dört alanı da taşır: { type: 'required'|'email'|'regex'|'max-length'|'min-length'|'max-value'|'min-value'|'value-options', message: '<kullanıcıya görünen metin>', value: <eşik/desen/true>, isActive: true }.", 400);
+    }
+}

package/dist/tools/screenWrite.js

@@ -4,7 +4,8 @@ import { applyCatalogLayoutRules } from './components.js';
 import { PlatformApiError } from '../platform/errors.js';
 const GUARD_CODES = {
     page: { events: 'PAGE-011', widgets: 'PAGE-012', noun: 'sayfa', tree: 'schema' },
-    layout: { events: 'LAY-004', widgets: 'LAY-005', noun: 'layout', tree: 'views' }
+    layout: { events: 'LAY-004', widgets: 'LAY-005', noun: 'layout', tree: 'views' },
+    widget: { events: 'PAGE-011', widgets: 'PAGE-012', noun: 'widget', tree: 'schema' }
 };
 /**
  * JS tanımlayıcısı olmayan ya da AYRILMIŞ `name` alanlarını toplar; ad

package/dist/tools/screens.js

@@ -152,10 +152,3 @@ export async function fetchHost(platform, host, project, environment, applicatio
     }
     return record;
 }
-export function hostUpdateBody(host, record, overrides = {}) {
-    if (host === 'page')
-        return pageUpdateBody(record, overrides);
-    if (host === 'layout')
-        return layoutUpdateBody(record, overrides);
-    return componentUpdateBody(record, overrides);
-}