@appaflytech/zeyrek-ai-mcp 0.0.8 → 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/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);
-}

package/dist/tools/themes.js

@@ -0,0 +1,163 @@
+import { guid, projectParam, readOnly, updates } from './common.js';
+import { diffCssVars, mergeRadiusScale, mergeSpacingScale, mergeTypeScale, resolveTheme } from '../knowledge/themeResolve.js';
+import { diffThemePaths, mergeTheme, normalizeTheme, readProjectTheme, summarizeTheme, themeInput, unsetThemePaths } from '../knowledge/themeSchema.js';
+import { componentPresetTypeWarnings, themeInputWarnings, unsetWarnings } from '../knowledge/themeRules.js';
+import { attachFindings, enforcePolicy, evaluatePolicy, applyPolicyMode } from '../knowledge/policy.js';
+import { projectUpdateForm } from './projects.js';
+import { withNormalization } from '../knowledge/normalize.js';
+import { PlatformApiError } from '../platform/errors.js';
+import { policyRules } from '../knowledge/rules.js';
+import { handle } from '../platform/responses.js';
+import { z } from 'zod';
+const modeParam = z.enum(['light', 'dark']);
+/**
+ * Tema PROJE kaydıdır (`projects.theme` jsonb), ortam başına değil: okuma da yazma da
+ * Organization.API'ye gider ve `environment` parametresi YOKTUR. Kayıt her aktif ortamın tenant
+ * kopyasına platform tarafından yayılır (`UpdateProjectWhenOrganizationProjectUpdatedEventHandler`).
+ */
+async function loadProject(platform, project) {
+    const slug = platform.resolveProject(project);
+    const payload = await platform.org('GET', `/p/${slug}`);
+    const data = (payload?.data ?? {});
+    return {
+        payload,
+        project: { id: data.id, slug: data.slug, name: data.name },
+        theme: readProjectTheme(payload)
+    };
+}
+const EMPTY_THEME_NOTE = 'Proje TEMASIZ — runtime platformun kendi varsayılanını çizer (accent #0052CC, Inter 14px, '
+    + 'radius 4px, spacing 10px). Marka için theme_update; yalnız TEK bir sayfada sapma istiyorsanız '
+    + "page_container.style içinde --ng-* değişkenlerini ezin (platform_guide('page') Kural 1h).";
+export function registerThemeTools(server, platform) {
+    const config = platform.config;
+    server.registerTool('theme_get', {
+        title: 'Proje temasını getir',
+        description: "Projenin tema kaydını döner: hangi alanlara dokunulmuş (summary), kaydın kendisi (raw) ya da EKRANA İNEN hâli (resolved — tam palet + birleşik ölçekler + runtime'ın bastığı bütün --ng-* değişkenleri). 'Accent'i ezmedim, ekranda hangi mavi çiziliyor' sorusunun cevabı resolved kipidir. Tema PROJE kaydıdır: ortam parametresi yoktur, bütün ortamların runtime'ı aynı temayı çizer.",
+        inputSchema: {
+            project: projectParam,
+            view: z.enum(['summary', 'raw', 'resolved']).optional().describe("summary (varsayılan): dokunulmuş alanların dökümü + preset/bileşen preset listesi. raw: tema kaydı olduğu gibi. resolved: palet, token'lar, gölge kademeleri ve cssVars (--ng-* → değer)"),
+            mode: modeParam.optional().describe("Yalnız resolved: hangi mod çözülsün. Verilmezse kaydın kendi mode'u (yoksa light). Palet override'ları mod başına tutulur (palette / paletteDark), bu yüzden iki mod ayrı ayrı çözülür")
+        },
+        annotations: readOnly
+    }, handle(config, async ({ project, view, mode }) => {
+        const { project: projectInfo, theme } = await loadProject(platform, project);
+        const storedMode = theme?.mode === 'dark' ? 'dark' : 'light';
+        const head = { project: projectInfo, hasTheme: theme !== undefined, storedMode };
+        if (view === 'raw') {
+            return {
+                ...head,
+                theme: theme ?? {},
+                note: theme === undefined
+                    ? EMPTY_THEME_NOTE
+                    : "Kayıt olduğu gibi. Ekrana inen değerler için view:'resolved'; kısmi yazma için theme_update."
+            };
+        }
+        if (view === 'resolved') {
+            const resolved = resolveTheme(theme, mode);
+            return {
+                ...head,
+                mode: resolved.mode,
+                palette: resolved.palette,
+                // Alan adı 'tokens' OLAMAZ: `maskSecrets` anahtarında 'token' geçen her değeri '***' ile
+                // değiştiriyor (`secretKeyPattern`, platform/secrets.ts) ve yanıt sessizce boşalıyordu —
+                // ölçüldü 2026-09-15, tema token'ları tasarım değeri, gizli bilgi değil.
+                values: {
+                    fontFamily: resolved.tokens.fontFamily,
+                    fontHeading: resolved.tokens.headingFontFamily ?? resolved.tokens.fontFamily,
+                    fontSize: resolved.tokens.fontSize,
+                    fontWeight: resolved.tokens.fontWeight,
+                    spacing: resolved.tokens.spacing,
+                    borderRadius: resolved.tokens.borderRadius,
+                    defaultInputSize: resolved.tokens.defaultInputSize,
+                    typeScale: mergeTypeScale(resolved.tokens.typeScale),
+                    radiusScale: mergeRadiusScale(resolved.tokens.radiusScale),
+                    spacingScale: mergeSpacingScale(resolved.tokens.spacingScale),
+                    shadow: resolved.tokens.shadow
+                },
+                shadow: resolved.shadow,
+                cssVars: resolved.cssVars,
+                presets: Object.keys(theme?.presets ?? {}),
+                componentPresets: Object.keys(theme?.componentPresets ?? {}),
+                note: "cssVars, Theme.svelte'nin her sayfaya bastığı değişkenlerdir; bir sayfanın page_container.style'ı aynı adı yeniden tanımlarsa O SAYFADA o kazanır. Koyu mod için mode:'dark' — ziyaretçinin kendi tercihi (theme-toggle, localStorage) runtime'da projenin modunun önüne geçer."
+            };
+        }
+        if (theme === undefined)
+            return { ...head, note: EMPTY_THEME_NOTE };
+        const summary = summarizeTheme(theme);
+        return {
+            ...head,
+            ...summary,
+            note: "Değerlerin ekrana indiği hâl için view:'resolved'; yazmak için theme_update (kısmi günceller, lint'ten geçirir, hangi CSS değişkeninin değiştiğini söyler). Adlı bir preset'i düğüme bağlamak: style.$preset — platform_guide('theme')."
+        };
+    }));
+    server.registerTool('theme_update', {
+        title: 'Proje temasını güncelle',
+        description: "Temayı KISMİ günceller: kaydı okur, verdiğiniz alanları derin birleştirir, normalize eder, lint'ten geçirir ve yazar — bir rengi değiştirmek preset'leri ve bileşen preset'lerini düşürmez. Yanıt hangi yolların değiştiğini (changed) ve hangi CSS değişkeninin hangi değerden hangi değere gittiğini (cssVarsChanged) söyler; dryRun ile yazmadan aynı yanıtı alırsınız. DİKKAT: tema PROJE kaydıdır — değişiklik BÜTÜN ortamların runtime'ına iner (production dâhil) ve Studio tema paneli açık ve kaydedilmemişse panelin sonraki Save'i bu yazmayı ezer.",
+        inputSchema: {
+            project: projectParam,
+            theme: themeInput.optional().describe("Yazılacak alanlar — KISMİ. Nesneler derin birleşir, dizi/ilkel değer yerine geçer. Tanınmayan anahtar (ör. 'pallete') istek gitmeden reddedilir: platform temayı doğrulamayan bir jsonb blob'u olarak saklar ve yazım hatası kayıtta sessizce yaşardı"),
+            unset: z.array(z.string().min(1)).optional().describe("Silinecek nokta yolları: 'presets.kart', 'componentPresets.button.versions.V2', 'headingFontFamily', 'paletteDark.accent.primary'. Silmenin kanalı budur — null yazmak silmez"),
+            replace: z.boolean().optional().describe("true: 'theme' mevcut kaydın YERİNE geçer (birleştirme yok). Temayı sıfırlamak: replace: true, theme: {}"),
+            applicationId: guid.optional().describe('Verilirse componentPresets tipleri o uygulamanın kataloğuna göre denetlenir (THEME-011); verilmezse bu kontrol atlanır'),
+            dryRun: z.boolean().optional().describe('Yazmadan aynı yanıtı döner: changed + cssVarsChanged + lint bulguları. Yazmadan önce ekranda ne değişeceğini görmenin yolu budur'),
+            policyOverride: z.boolean().optional().describe('block bulgularını warn\'a indirir (bilinçli istisna)')
+        },
+        annotations: updates
+    }, handle(config, async ({ project, theme, unset, replace, applicationId, dryRun, policyOverride }) => {
+        if (theme === undefined && (unset === undefined || unset.length === 0)) {
+            throw new PlatformApiError("theme_update: 'theme' ya da 'unset' parametrelerinden en az biri dolu olmalı. Temayı sıfırlamak için replace: true, theme: {} verin.", 400);
+        }
+        const { project: projectInfo, payload, theme: base } = await loadProject(platform, project);
+        const data = (payload?.data ?? {});
+        const name = typeof data.name === 'string' ? data.name : undefined;
+        const slug = typeof data.slug === 'string' ? data.slug : undefined;
+        if (name === undefined || data.id === undefined) {
+            throw new PlatformApiError(`theme_update: '${platform.resolveProject(project)}' projesi okunamadı (ad ya da id yok); project_get ile kontrol edin.`, 400);
+        }
+        const patch = (theme ?? {});
+        const current = base ?? {};
+        const merged = replace === true ? patch : mergeTheme(current, patch);
+        const removal = unsetThemePaths(merged, unset ?? []);
+        const normalized = normalizeTheme(removal.theme);
+        const next = normalized.theme;
+        const findings = [...enforcePolicy(evaluatePolicy(config, policyRules, 'theme', next, { operation: 'update' }, policyOverride))];
+        // Uyarılar `policyRules` dışında üretiliyor (girdiye ve platform okumasına bakıyorlar), bu
+        // yüzden POLICY kipini ve policyOverride'ı kendileri uygulamak zorunda — WF-031 ile aynı yol.
+        if (config.policyMode !== 'off') {
+            const warnings = [
+                ...themeInputWarnings(patch, next),
+                ...unsetWarnings(current, unset ?? [])
+            ];
+            if (applicationId !== undefined && Object.keys(next.componentPresets ?? {}).length > 0) {
+                const catalog = await platform.tenant('GET', project, `/components/${applicationId}`, { query: { pageIndex: 0, pageLength: 999 } })
+                    .catch(() => undefined);
+                if (catalog?.data)
+                    warnings.push(...componentPresetTypeWarnings(next, catalog.data));
+            }
+            findings.push(...applyPolicyMode(config, warnings, policyOverride));
+        }
+        const before = resolveTheme(current).cssVars;
+        const after = resolveTheme(next).cssVars;
+        const changed = diffThemePaths(current, next);
+        const head = {
+            project: projectInfo,
+            changed: { ...changed, ...(removal.missing.length > 0 ? { missing: removal.missing } : {}) },
+            cssVarsChanged: diffCssVars(before, after),
+            theme: summarizeTheme(next)
+        };
+        const panelWarning = "Studio tema paneli AÇIK ve kaydedilmemişse panelin sonraki Save'i bu yazmayı ezer; panel kapalıyken yazın.";
+        const note = `Tema PROJE kaydıdır: bu değişiklik bütün ortamların runtime'ına indi (production dâhil). Kanıt: page_screenshot — ikinci mod için colorScheme:'dark'. ${panelWarning}`;
+        if (dryRun === true) {
+            return attachFindings(withNormalization({
+                ...head,
+                dryRun: true,
+                // Kuru koşunun notu GELECEK zaman kurar: yazma notunu "YAZILMADI" önekiyle sunmak
+                // aynı cümlede iki şey söylüyordu ("yazılmadı" + "indi") — ölçüldü 2026-09-15 canlı koşu.
+                note: `YAZILMADI (dryRun) — bu çağrı hiçbir şey değiştirmedi. Yazarsanız değişiklik bütün ortamların runtime'ına iner (production dâhil) ve ekranda page_screenshot ile doğrulanır (ikinci mod için colorScheme:'dark'). ${panelWarning}`
+            }, normalized.fixes), findings);
+        }
+        const form = projectUpdateForm({ name, slug, theme: JSON.stringify(next) });
+        const response = await platform.org('PUT', `/projects/${String(data.id)}`, { form });
+        return attachFindings(withNormalization({ ...head, updated: true, note, platform: response }, normalized.fixes), findings);
+    }));
+}