@appaflytech/zeyrek-ai-mcp 0.0.4 → 0.0.6

package/dist/tools/rows.js

@@ -1,7 +1,38 @@
-import { guid, projectParam, environmentParam, pagingParams, readOnly, writes, updates, destructive } from './common.js';
+import { findLocalizationCompanion, localizationRows, platformIgnoredLocalizations } from '../knowledge/localization.js';
+import { guid, entityRef, resolveEntityId, withResolved, projectParam, environmentParam, languageParam, pagingParams, readOnly, writes, updates, destructive } from './common.js';
+import { unmappedMembers, withUnmappedMembers } from '../knowledge/schemaGuard.js';
+import { withNormalization } from '../knowledge/normalize.js';
+import { RefResolver } from '../platform/refs.js';
+import { attachFindings, evaluatePolicy, enforcePolicy } from '../knowledge/policy.js';
+import { policyRules } from '../knowledge/rules.js';
+import { languageHeader } from '../knowledge/languageCodes.js';
 import { handle } from '../platform/responses.js';
 import { z } from 'zod';
 const rowValues = z.record(z.unknown()).describe("Alan SLUG'ı → değer sözlüğü; anahtarlar entity_get çıktısındaki field SLUG'larıdır (name değil — name kullanmak 'Please enter a valid value' hatası verir)");
+/**
+ * `row_*` DBMS düzeyi bir satır yüzeyidir; var olan satır kümesinden TÜRETİLEN satırları
+ * (geçmiş, hareket, log, junction, backfill) gövdede taşımak onun işi değildir — 2026-09-05'te
+ * 802, 2026-09-06'da 552 satır bu yüzden elle yazıldı (`B-34`, `B-50`) ve ikinci koşunun 65
+ * dakikasının ~21'i buraya gitti. Eşik büyük tutuldu: bulgu her toplu yazmada bağırırsa koşunun
+ * sinyal oranını kendisi düşürür, bu yüzden yalnız "elle taşınamayacak kadar büyük" dizilerde
+ * konuşur ve cümlesi KOŞULLUDUR — dışarıdan gelen veriyi (içe aktarma, kullanıcı girdisi)
+ * yazan çağıranı suçlamaz.
+ */
+const DERIVED_ROW_THRESHOLD = 50;
+function derivedRowFindings(rows) {
+    if (!rows || rows.length < DERIVED_ROW_THRESHOLD)
+        return [];
+    return [{
+            ruleId: 'ROW-001',
+            severity: 'warn',
+            message: `Gövdede ${rows.length} satır var. Bu satırlar VAR OLAN satırlardan türetiliyorsa (geçmiş/hareket/log/junction tablosu, backfill) onları gövdede taşımayın: tek bir kayıtlı 'INSERT … SELECT' sorgusu aynı işi TEK çağrıda yapar ve hiçbir id elle taşınmaz (ölçüldü 2026-09-07). Satırlar dışarıdan geliyorsa (içe aktarma, kullanıcı verisi) bu çağrı doğru yoldur. Ham SQL yolu UYGULAMA katmanını atlar (automation tetiklenmez, incremental sayaç ilerlemez, localization companion yazılmaz) ama veritabanı kısıtları — NOT NULL, FK, UNIQUE, enum CHECK — aynen uygulanır. Reçete, merdiven kalıbı ve anahtar sözleşmesi: platform_guide('entity') §'Toplu ve türetilmiş satır'.`,
+            guide: 'ngapps://guides/entity'
+        }];
+}
+const includeTranslationsParam = z.boolean().optional()
+    .describe("Çok dilli alanların TÜM dillerini de getirir: satıra 'localizations: { <dil>: { <alan>: <değer> } }' eklenir. Verilmezse satır yalnız istek dilinde düzleştirilmiş gelir (çevirisi olmayan alan varsayılan dile düşer).");
+const localizationsParam = z.record(z.record(z.unknown())).optional()
+    .describe("Dil kodu → çok dilli alan değerleri; ör. { tr: { name: 'Yıllık izin' }, en: { name: 'Annual leave' } }. Verilen her dil upsert edilir, verilmeyen dile dokunulmaz. Dil kodu projenin dil listesinde değilse platform 400 döner ve ana satır da yazılmaz.");
 export function registerRowTools(server, platform) {
     const config = platform.config;
     server.registerTool('row_list', {
@@ -10,106 +41,189 @@ export function registerRowTools(server, platform) {
         inputSchema: {
             project: projectParam,
             environment: environmentParam,
-            entityId: guid,
+            entityId: entityRef,
             selectedFields: z.array(z.string()).optional().describe('Dönen satırlar bu alan adlarına indirgenir, id her zaman dahildir; platform tam satırı hesapladığı için kırpma gateway tarafında yapılır'),
             filters: z.array(z.record(z.unknown())).optional().describe('Platform Filter dizisi; biçim için row_list\'i filtresiz çağırıp Studio\'daki bir filtreyi referans alın'),
+            language: languageParam,
+            includeTranslations: includeTranslationsParam,
             ...pagingParams
         },
         annotations: readOnly
-    }, handle(config, async ({ project, environment, entityId, ...body }) => {
-        const payload = await platform.tenant('POST', project, `/entities/${entityId}/row/list`, { environment, body });
+    }, handle(config, async ({ project, environment, entityId, language, ...body }) => {
+        const notes = [];
+        const headers = languageHeader(language, notes);
+        const resolver = new RefResolver(platform, project, environment);
+        const resolvedEntityId = await resolveEntityId(resolver, entityId);
+        const payload = await platform.tenant('POST', project, `/entities/${resolvedEntityId}/row/list`, { environment, body, headers });
         const wanted = body.selectedFields ?? [];
-        if (!wanted.length || !payload || typeof payload !== 'object' || Array.isArray(payload))
-            return payload;
-        const rows = payload.data;
-        if (!Array.isArray(rows))
-            return payload;
-        const keep = new Set([...wanted.map(field => field.toLowerCase()), 'id']);
-        return {
+        const rows = payload && typeof payload === 'object' && !Array.isArray(payload) ? payload.data : undefined;
+        if (!wanted.length || !Array.isArray(rows))
+            return withNormalization(withResolved(payload, resolver.resolved), notes);
+        /**
+         * 'localizations' keep listesine girmezse includeTranslations'ın getirdiği çeviriler tam da
+         * onları isteyen çağrıda kırpılırdı: iki parametre birlikte verildiğinde sessizce boşa çıkar.
+         */
+        const keep = new Set([...wanted.map(field => field.toLowerCase()), 'id', ...(body.includeTranslations ? ['localizations'] : [])]);
+        return withNormalization(withResolved({
             ...payload,
             data: rows.map(row => row && typeof row === 'object' && !Array.isArray(row)
                 ? Object.fromEntries(Object.entries(row).filter(([key]) => keep.has(key.toLowerCase())))
                 : row)
-        };
+        }, resolver.resolved), notes);
     }));
     server.registerTool('row_get', {
         title: 'Satır getir',
         description: 'Tek satırı id ile getirir.',
-        inputSchema: { project: projectParam, environment: environmentParam, entityId: guid, id: z.string().min(1) },
+        inputSchema: { project: projectParam, environment: environmentParam, entityId: entityRef, id: z.string().min(1), language: languageParam, includeTranslations: includeTranslationsParam },
         annotations: readOnly
-    }, handle(config, ({ project, environment, entityId, id }) => platform.tenant('GET', project, `/entities/${entityId}/row/${encodeURIComponent(id)}`, { environment })));
+    }, handle(config, async ({ project, environment, entityId, id, language, includeTranslations }) => {
+        const notes = [];
+        const headers = languageHeader(language, notes);
+        const resolver = new RefResolver(platform, project, environment);
+        const resolvedEntityId = await resolveEntityId(resolver, entityId);
+        const payload = await platform.tenant('GET', project, `/entities/${resolvedEntityId}/row/${encodeURIComponent(id)}`, { environment, headers, ...(includeTranslations ? { query: { includeTranslations: true } } : {}) });
+        return withNormalization(withResolved(payload, resolver.resolved), notes);
+    }));
     server.registerTool('row_create', {
         title: 'Satır ekle',
-        description: "Tek satır için 'row', çoklu ekleme için 'rows' verin (ikisi birden verilmez).",
+        description: "Tek satır için 'row', çoklu ekleme için 'rows' verin (ikisi birden verilmez). Çoklu dilli entity'de 'localizations: { tr: {…}, en: {…} }' ile dil satırlarını da aynı çağrıda yazar: companion entity'yi ve FK'yı gateway bulur (yalnız 'row' ile). 'rows' TEK TRANSACTION'da yazılır: bir satır doğrulamadan düşerse HİÇBİRİ yazılmaz ve hata hangi satır indeksinin düştüğünü söyler. Automation'lar satır BAŞINA tetiklenir — sync (isQueue:true) automation'lar aynı transaction'da satır satır koşar, biri düşerse toplu yazma geri alınır. Tek çağrıda en çok 1000 satır. SINIR: row_* bir veritabanı yönetim yüzeyidir — satırları GÖVDEDE taşır. VAR OLAN satırlardan türetilen bir küme (geçmiş/hareket/log/junction, backfill) bu yola AİT DEĞİLDİR; onu tek bir kayıtlı 'INSERT … SELECT' sorgusu + query kaynaklı uç yazar, reçete platform_guide('entity') §'Toplu ve türetilmiş satır'. Toplu ucun id döndürmesine GÜVENMEYİN: 2026-09-07 ölçümünde boş gövde döndü (2026-09-05'te anahtar listesi dönüyordu, fark B-63) — id gerekiyorsa ardından row_list çekin. TOPLU eklemede dil değerlerini satırın KENDİ içine koyun ('rows: [{ kod: 'A1', localizations: { tr: {…} } }]') — üst düzey 'localizations' toplu uçta hangi satıra ait olduğunu söyleyemez. 'row' içine düz çok dilli slug yazarsanız değer İSTEK DİLİ için kaydedilir — dili 'language' ile seçin.",
         inputSchema: {
             project: projectParam,
             environment: environmentParam,
-            entityId: guid,
+            entityId: entityRef,
             row: rowValues.optional(),
-            rows: z.array(z.record(z.unknown())).optional()
+            rows: z.array(z.record(z.unknown())).optional(),
+            localizations: localizationsParam,
+            language: languageParam,
+            rowContext: z.record(z.unknown()).optional()
+                .describe("Satır olayının DIŞINDAN automation'a geçirilecek değerler. Tetiklenen automation bunları ifadelerinde `rowContext.<anahtar>` ile okur — zaman damgası, göç kaynağı, toplu iş kimliği gibi. Tarihsel (geçmiş tarihli) veri üretmenin yolu budur: automation `UtcNow()` yerine `rowContext.occurredAt`'i yazabilir. Verilmezse automation bağlamı değişmez.")
         },
         annotations: writes
-    }, handle(config, ({ project, environment, entityId, row, rows }) => {
+    }, handle(config, async ({ project, environment, entityId, row, rows, localizations, rowContext, language }) => {
         if (row && rows)
             throw new Error("'row' ve 'rows' birlikte verilemez.");
-        if (rows)
-            return platform.tenant('POST', project, `/entities/${entityId}/row/bulk`, { environment, body: { rows } });
-        if (row)
-            return platform.tenant('POST', project, `/entities/${entityId}/row`, { environment, body: { row } });
-        throw new Error("'row' ya da 'rows' parametrelerinden biri zorunlu.");
+        if (localizations && !row)
+            throw new Error("Üst düzey 'localizations' yalnız 'row' ile verilir: toplu uçta hangi satıra ait olduğu belirsizdir. Toplu eklemede dil değerlerini satırın kendi içine koyun — rows: [{ …, localizations: { tr: {…} } }].");
+        if (!row && !rows)
+            throw new Error("'row' ya da 'rows' parametrelerinden biri zorunlu.");
+        const notes = [];
+        const headers = languageHeader(language, notes);
+        const wantedLocalizations = localizations && Object.keys(localizations).length > 0 ? localizations : undefined;
+        const shapeFindings = enforcePolicy(evaluatePolicy(config, policyRules, 'row', rows ? { rows } : { row }, { operation: 'create' }));
+        const resolver = new RefResolver(platform, project, environment);
+        if (rows) {
+            const bulkEntityId = await resolveEntityId(resolver, entityId);
+            const bulkBody = { rows, ...(rowContext ? { rowContext } : {}) };
+            const bulkDrift = unmappedMembers('CreateBulkRowCommand', bulkBody);
+            return attachFindings(withUnmappedMembers(withNormalization(withResolved(await platform.tenant('POST', project, `/entities/${bulkEntityId}/row/bulk`, { environment, headers, body: bulkBody }), resolver.resolved), notes), bulkDrift), [...shapeFindings, ...derivedRowFindings(rows)]);
+        }
+        const resolvedEntityId = await resolveEntityId(resolver, entityId);
+        const body = { row, ...(wantedLocalizations ? { localizations: wantedLocalizations } : {}), ...(rowContext ? { rowContext } : {}) };
+        const drift = unmappedMembers('CreateRowCommand', body);
+        const response = await platform.tenantWithHeaders('POST', project, `/entities/${resolvedEntityId}/row`, { environment, headers, body });
+        const created = response.body;
+        if (!wantedLocalizations || !platformIgnoredLocalizations(response.headers)) {
+            return attachFindings(withUnmappedMembers(withNormalization(withResolved(created, resolver.resolved), notes), drift), shapeFindings);
+        }
+        notes.push("platform 'localizations' alanını tanımıyor (X-Unmapped-Members); dil satırlarını gateway companion entity'ye yazdı.");
+        const entity = await resolver.entity(entityId);
+        let mainRowId = created.data?.id;
+        try {
+            // Satır sözlüğü alan SLUG'larıyla anahtarlanır ve PK slug'ı 'id' olmak ZORUNDA değildir
+            // (CreateRowCommandHandler `entityDto.PrimaryKey()` kullanır). 'id' yoksa gerçek PK'yı
+            // bulmadan yazmak FK'sı NULL dil satırları üretir ve bunu başarı diye raporlardı.
+            if (mainRowId === undefined || mainRowId === null) {
+                const primaryKey = (await resolver.entityFields(entity)).find(field => field.primaryKey);
+                mainRowId = primaryKey ? created.data?.[primaryKey.slug] : undefined;
+            }
+            if (mainRowId === undefined || mainRowId === null) {
+                throw new Error("Ana satır yazıldı ama yanıtta birincil anahtar okunamadı; dil satırları FK'sız yazılmadı (FK'sı boş satır sessiz yanlış olurdu).");
+            }
+            const companion = await findLocalizationCompanion(resolver, entity);
+            const localizationBatch = localizationRows(companion, mainRowId, wantedLocalizations);
+            await platform.tenant('POST', project, `/entities/${companion.entityId}/row/bulk`, { environment, body: { rows: localizationBatch } });
+            return attachFindings(withUnmappedMembers(withNormalization(withResolved({ ...created, localizations: { entityId: companion.entityId, languages: Object.keys(wantedLocalizations), count: localizationBatch.length } }, resolver.resolved), notes), drift), shapeFindings);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return attachFindings(withUnmappedMembers(withNormalization(withResolved({ ...created, localizationsFailed: { mainRowId, error: message, note: 'Ana satır YAZILDI, dil satırları yazılamadı; gateway geri alamaz. Ya companion entity\'ye row_create ile elle yazın ya da ana satırı row_delete ile silip tekrar deneyin.' } }, resolver.resolved), notes), drift), shapeFindings);
+        }
     }));
     server.registerTool('row_update', {
         title: 'Satır güncelle',
-        description: "Tek satır için 'row', çoklu güncelleme için 'rows' verin; satır id alanı gövdede olmalıdır.",
+        description: "Tek satır için 'row', çoklu güncelleme için 'rows' verin; satır id alanı gövdede olmalıdır. 'rows' TEK TRANSACTION'da yazılır: bir satır düşerse HİÇBİRİ yazılmaz ve hata hangi satır indeksinin düştüğünü söyler. Automation'lar satır BAŞINA tetiklenir — sync (isQueue:true) automation'lar aynı transaction'da satır satır koşar. Tek çağrıda en çok 1000 satır. Aynı sınır row_create'te olduğu gibi geçerlidir: var olan satırlardan HESAPLANAN toplu güncelleme (durum/toplam/damga backfill'i) kayıtlı bir 'UPDATE … FROM' sorgusuna aittir — platform_guide('entity') §'Toplu ve türetilmiş satır'. Çeviri güncellemek için 'localizations: { tr: {…}, en: {…} }' verin — ana satır hiç değişmese de yalnız çeviriler yazılabilir. TOPLU güncellemede aynı nesne satırın KENDİ içine konur ('rows: [{ id: 1, localizations: { tr: {…} } }]'); 'row' içindeki düz çok dilli slug İSTEK DİLİNE yazılır.",
         inputSchema: {
             project: projectParam,
             environment: environmentParam,
-            entityId: guid,
+            entityId: entityRef,
             row: rowValues.optional(),
-            rows: z.array(z.record(z.unknown())).optional()
+            rows: z.array(z.record(z.unknown())).optional(),
+            localizations: localizationsParam,
+            language: languageParam,
+            rowContext: z.record(z.unknown()).optional()
+                .describe("Satır olayının DIŞINDAN automation'a geçirilecek değerler. Tetiklenen automation bunları ifadelerinde `rowContext.<anahtar>` ile okur — zaman damgası, göç kaynağı, toplu iş kimliği gibi. Tarihsel (geçmiş tarihli) veri üretmenin yolu budur: automation `UtcNow()` yerine `rowContext.occurredAt`'i yazabilir. Verilmezse automation bağlamı değişmez.")
         },
         annotations: updates
-    }, handle(config, ({ project, environment, entityId, row, rows }) => {
+    }, handle(config, async ({ project, environment, entityId, row, rows, localizations, rowContext, language }) => {
         if (row && rows)
             throw new Error("'row' ve 'rows' birlikte verilemez.");
-        if (rows)
-            return platform.tenant('PUT', project, `/entities/${entityId}/row/bulk`, { environment, body: { rows } });
-        if (row)
-            return platform.tenant('PUT', project, `/entities/${entityId}/row`, { environment, body: { row } });
-        throw new Error("'row' ya da 'rows' parametrelerinden biri zorunlu.");
+        if (localizations && !row)
+            throw new Error("Üst düzey 'localizations' yalnız 'row' ile verilir: toplu uçta hangi satıra ait olduğu belirsizdir. Toplu güncellemede dil değerlerini satırın kendi içine koyun — rows: [{ id, localizations: { tr: {…} } }].");
+        if (!row && !rows)
+            throw new Error("'row' ya da 'rows' parametrelerinden biri zorunlu.");
+        const shapeFindings = enforcePolicy(evaluatePolicy(config, policyRules, 'row', rows ? { rows } : { row }, { operation: 'update' }));
+        const notes = [];
+        const headers = languageHeader(language, notes);
+        const resolver = new RefResolver(platform, project, environment);
+        const resolvedEntityId = await resolveEntityId(resolver, entityId);
+        if (rows) {
+            const bulkBody = { rows, ...(rowContext ? { rowContext } : {}) };
+            const bulkDrift = unmappedMembers('UpdateBulkRowCommand', bulkBody);
+            return attachFindings(withUnmappedMembers(withNormalization(withResolved(await platform.tenant('PUT', project, `/entities/${resolvedEntityId}/row/bulk`, { environment, headers, body: bulkBody }), resolver.resolved), notes), bulkDrift), [...shapeFindings, ...derivedRowFindings(rows)]);
+        }
+        const body = { row, ...(localizations ? { localizations } : {}), ...(rowContext ? { rowContext } : {}) };
+        const drift = unmappedMembers('UpdateRowCommand', body);
+        return attachFindings(withUnmappedMembers(withNormalization(withResolved(await platform.tenant('PUT', project, `/entities/${resolvedEntityId}/row`, { environment, headers, body }), resolver.resolved), notes), drift), shapeFindings);
     }));
     server.registerTool('row_delete', {
         title: 'Satır sil',
-        description: "Tek satır için 'id', çoklu silme için 'ids' verin.",
+        description: "Tek satır için 'id', çoklu silme için 'ids' verin. Çok dilli entity'de dil satırlarını platform ana satırdan ÖNCE kendisi siler; eski platform sürümünde yabancı anahtar hatası dönerse önce companion entity'nin satırlarını silin.",
         inputSchema: {
             project: projectParam,
             environment: environmentParam,
-            entityId: guid,
+            entityId: entityRef,
             id: z.string().optional(),
             ids: z.array(z.union([z.string(), z.number()])).optional()
         },
         annotations: destructive
-    }, handle(config, ({ project, environment, entityId, id, ids }) => {
+    }, handle(config, async ({ project, environment, entityId, id, ids }) => {
         if (id && ids)
             throw new Error("'id' ve 'ids' birlikte verilemez.");
+        if (!id && !ids)
+            throw new Error("'id' ya da 'ids' parametrelerinden biri zorunlu.");
+        const resolver = new RefResolver(platform, project, environment);
+        const resolvedEntityId = await resolveEntityId(resolver, entityId);
         if (ids)
-            return platform.tenant('POST', project, `/entities/${entityId}/row/bulk/delete`, { environment, body: { rowIds: ids } });
-        if (id)
-            return platform.tenant('DELETE', project, `/entities/${entityId}/row/${encodeURIComponent(id)}`, { environment });
-        throw new Error("'id' ya da 'ids' parametrelerinden biri zorunlu.");
+            return withResolved(await platform.tenant('POST', project, `/entities/${resolvedEntityId}/row/bulk/delete`, { environment, body: { rowIds: ids } }), resolver.resolved);
+        return withResolved(await platform.tenant('DELETE', project, `/entities/${resolvedEntityId}/row/${encodeURIComponent(String(id))}`, { environment }), resolver.resolved);
     }));
     server.registerTool('row_next_code', {
         title: 'Sıradaki kodu üret',
-        description: 'Incremental tipli alan için sıradaki kodu döner.',
+        description: "Incremental tipli alan için sıradaki kodu döner ve sayacı İLERLETMEZ (persist:false) — kodun nasıl görüneceğini kaydetmeden görmek için. Gövde row_create'in Incremental alanına yazdığınız nesneyle aynıdır: { prefix, separator, counter, digitCount }. 'counter' ve 'digitCount' platform tarafında ZORUNLUDUR (GetNextIncrementalCodeQueryValidator: NotEmpty) — eksik verilirse istek 400 döner, bu yüzden gateway de ikisini zorunlu tutar.",
         inputSchema: {
             project: projectParam,
             environment: environmentParam,
-            entityId: guid,
+            entityId: entityRef,
             fieldId: guid,
-            prefix: z.string().optional(),
-            separator: z.string().optional(),
-            digitCount: z.number().int().optional()
+            prefix: z.string().optional().describe("Kodun önüne gelen sabit ('EMP')"),
+            separator: z.string().optional().describe("Önek ile sayaç arasındaki ayraç ('-'); verilmezse boş"),
+            counter: z.number().int().min(1).describe('Sayacın BAŞLANGIÇ değeri — platform zorunlu tutar (NotEmpty, yani 0 kabul edilmez). Alanın kayıtlı sayacını bilmiyorsanız entity_get ile alanın tanımına bakın.'),
+            digitCount: z.number().int().min(1).describe("Sayacın basamak sayısı (4 → '0006'); platform zorunlu tutar (NotEmpty)")
         },
         annotations: readOnly
-    }, handle(config, ({ project, environment, entityId, ...body }) => platform.tenant('POST', project, `/entities/${entityId}/row/next-code`, { environment, body })));
+    }, handle(config, async ({ project, environment, entityId, ...body }) => {
+        const resolver = new RefResolver(platform, project, environment);
+        const resolvedEntityId = await resolveEntityId(resolver, entityId);
+        return withResolved(await platform.tenant('POST', project, `/entities/${resolvedEntityId}/row/next-code`, { environment, body }), resolver.resolved);
+    }));
 }

package/dist/tools/screenWrite.js

@@ -0,0 +1,59 @@
+import { invalidScreenEventNames, invalidWidgetTypeNodes, nestedRepeaterNodes, nestedRepeaterMessage, blockSizeNote, heightTypeNote, sizeStringNote } from '../knowledge/normalize.js';
+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' }
+};
+/** JS tanımlayıcısı olmayan `name` alanlarını toplar; ad `const <ad> = Components["<ad>"]` üretimine girer. */
+export function invalidComponentNames(nodes) {
+    const found = [];
+    for (const node of nodes ?? []) {
+        const name = node.name;
+        if (typeof name === 'string' && name.length > 0 && !/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(name.replace(/-/g, ''))) {
+            found.push(`'${name}' (${node.elementId ?? '?'})`);
+        }
+        found.push(...invalidComponentNames(node.children));
+    }
+    return found;
+}
+/**
+ * Sayfa ve layout yazma yollarının ORTAK kapısı: olay adı (PAGE-011 · LAY-004), widget düğümü
+ * (PAGE-012 · LAY-005), komponent adı (PAGE-009) ve iç içe repeater (PAGE-013) denetimleri —
+ * hepsi istek gitmeden 400.
+ *
+ * PAGE-009 ve PAGE-013'ün layout ayağı 2026-09-09'da eklendi: ikisi de yalnız sayfa yollarında
+ * koşuyordu, oysa layout `views`'ü aynı runtime'dan geçer — bozuk ad o layout'a bağlı HER
+ * sayfanın ifadelerini öldürür, iç içe repeater'ın geri yazma kırılması ise yapısaldır ve
+ * barındıranın sayfa mı layout mu olduğuna bakmaz.
+ */
+export function assertScreenWriteGuards(kind, screen) {
+    const codes = GUARD_CODES[kind];
+    const badEvents = invalidScreenEventNames(screen.events, codes.events);
+    if (badEvents.length > 0)
+        throw new PlatformApiError(`Geçersiz ${codes.noun} olayı (istek gönderilmedi): ${badEvents.join(' · ')}`, 400);
+    const badWidgets = invalidWidgetTypeNodes(screen.schema, codes.widgets);
+    if (badWidgets.length > 0)
+        throw new PlatformApiError(`Geçersiz widget düğümü (istek gönderilmedi): ${badWidgets.join(' · ')}`, 400);
+    const badNames = invalidComponentNames(screen.schema);
+    if (badNames.length > 0) {
+        throw new PlatformApiError(`PAGE-009 — komponent adı JS tanımlayıcısı değil (istek gönderilmedi): ${badNames.join(' · ')}. `
+            + 'Runtime her komponent için `const <ad> = Components["<ad>"]` üretir; boşluklu ya da geçersiz bir ad '
+            + 'SAYFADAKİ TÜM ifadeleri "Missing initializer in const declaration" ile öldürür (layout adları her sayfaya sızar). '
+            + `name alanını elementId ile aynı yaz; okunabilir Türkçe başlık için props.title / props.text / props.label kullan (${codes.noun} ${codes.tree}).`, 400);
+    }
+    const nested = nestedRepeaterNodes(screen.schema);
+    if (nested.length > 0)
+        throw new PlatformApiError(nestedRepeaterMessage(nested), 400);
+}
+/**
+ * Katalog kurallarını (blok sınırı · auto-height · boyut string'i) ağaca uygular ve
+ * `withNormalization` kuyruğuna giren üç notu döndürür. Boş/verilmemiş ağaçta katalog
+ * okunmaz — uygulanacak düğüm yoktur, notlar da boş çıkardı.
+ */
+export async function screenCatalogNotes(platform, project, environment, applicationId, nodes) {
+    if (!Array.isArray(nodes) || nodes.length === 0)
+        return [];
+    const catalog = await applyCatalogLayoutRules(platform, project, environment, applicationId, nodes);
+    return [...blockSizeNote(catalog.clamped), ...heightTypeNote(catalog.heights), ...sizeStringNote(catalog.sizes)];
+}

package/dist/tools/screens.js

@@ -31,6 +31,33 @@ export function summarize(node, styleSource) {
     }
     return summary;
 }
+/**
+ * Yazma yanıtındaki `appliedPatch` gövdesini iskelete indirger (B-55 · S-9).
+ *
+ * Alanın KANIT değeri path'indedir: "gerçekten yalnız o komponente mi dokunuldu" sorusunu
+ * JSON Pointer cevaplar (`page.md` Kural 2). `value` ise ajanın aynı turda KENDİ gönderdiği
+ * gövdenin yankısıdır — `add_component`'te eklenen alt ağacın tamamı, `replace_prop`'ta
+ * yazılan Prop'un tamamı (`AppliedJsonPatch(Op, Path, Value)`). 2026-09-06·2 koşusunda on
+ * dört yazma çağrısının yanıtı bağlamın en büyük tek kalemiydi.
+ *
+ * Kanıt kaybı yok: yamanın KAYDEDİLDİĞİNİ `appliedPatch` zaten söylemiyordu (G-23). Onu
+ * yamadan sonra okunan şemayla karşılaştıran `schemaOpDrops` söylüyor ve sonucu yanıtta
+ * `silentlyDropped` olarak duruyor. Tam gövde `view: 'full'` ile alınır.
+ */
+export function outlineAppliedPatch(applied) {
+    if (!Array.isArray(applied))
+        return applied;
+    return applied.map(entry => {
+        if (!entry || typeof entry !== 'object' || Array.isArray(entry))
+            return entry;
+        const record = entry;
+        const value = record.value;
+        const node = value && typeof value === 'object' && !Array.isArray(value) && typeof value.elementId === 'string'
+            ? summarize(value)
+            : undefined;
+        return { op: record.op, path: record.path, ...(node ? { component: node } : {}) };
+    });
+}
 /** elementId ya da id ile ağaçta düğüm bulur. */
 export function findNode(nodes, target) {
     for (const node of nodes ?? []) {
@@ -77,6 +104,7 @@ export function pageUpdateBody(page, overrides = {}) {
         name: page.name,
         slug: page.slug,
         browserTitle: page.browserTitle ?? '',
+        browserTitleKey: page.browserTitleKey ?? '',
         schema: page.schema ?? [],
         events: asArray(page.events).filter(event => event?.value),
         middlewareIds: page.middlewareIds ?? [],

package/dist/tools/translations.js

@@ -1,22 +1,38 @@
 import { guid, projectParam, environmentParam, readOnly, updates } from './common.js';
 import { handle } from '../platform/responses.js';
 import { z } from 'zod';
+import { evaluatePolicy, enforcePolicy, attachFindings } from '../knowledge/policy.js';
+import { readProjectLanguages, translationLanguageFindings } from '../knowledge/languages.js';
+import { policyRules } from '../knowledge/rules.js';
 const translationKeyInput = z.object({
     key: z.string().min(1),
-    values: z.record(z.string()).describe("Dil kodu (ISO 639-1) → çeviri metni; kodlar projenin languages listesinde (project_get/project_update) tanımlı olmalı"),
+    values: z.record(z.string().regex(/^[a-z]{2}$/, 'ISO 639-1 iki harfli küçük dil kodu (tr, en, de …); tr-TR gibi bölge ekli kod reddedilir'), z.string()).describe("Dil kodu (ISO 639-1, iki küçük harf) → çeviri metni. Platform kodu yalnız 184 kodluk ISO sözlüğüne göre doğrular (TR-001); PROJENİN languages listesine göre doğrulamaz — o bağı gateway kurar (TR-002)"),
     componentId: guid.optional().describe("Çeviriyi belirli bir komponente bağlar; o komponent silinince kaydı da silinir")
 });
+/**
+ * Yazma öncesi projenin dil durumunu okur. Proje okunamazsa (uç düşer, yetki yoksa) kontrol
+ * ATLANIR ve karar platforma kalır — `project_create`'in slug ön aramasındaki (PRJ-001) davranışın
+ * aynısı. Uydurma bulgu üretilmez.
+ */
+async function languageFindings(platform, project, keys) {
+    const slug = platform.resolveProject(project);
+    const codes = keys.flatMap(entry => Object.keys(entry.values ?? {}));
+    if (codes.length === 0)
+        return [];
+    const payload = await platform.org('GET', `/p/${slug}`).catch(() => undefined);
+    return translationLanguageFindings(readProjectLanguages(payload), codes, slug);
+}
 export function registerTranslationTools(server, platform) {
     const config = platform.config;
     server.registerTool('translation_list', {
         title: 'Çevirileri listele',
-        description: "Application'ın tüm çeviri kayıtlarını (dil × anahtar × değer) düz liste olarak döner. Proje dilleri/varsayılan dil için project_get; sayfada bir prop'u çeviriye bağlamak için platform_guide('translation').",
+        description: "Application'ın tüm çeviri kayıtlarını (dil × anahtar × değer) düz liste olarak döner. Proje dilleri/varsayılan dil için project_get (yanıtındaki localization bloğu runtime'ın bu çevirileri çözüp çözemeyeceğini söyler); sayfada bir prop'u çeviriye bağlamak için platform_guide('translation').",
         inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid },
         annotations: readOnly
     }, handle(config, ({ project, environment, applicationId }) => platform.tenant('GET', project, `/translations/${applicationId}`, { environment })));
     server.registerTool('translation_update', {
         title: 'Çevirileri güncelle',
-        description: "Bir ya da daha çok çeviri anahtarını toplu ekler/günceller (keys) ve/veya siler (deletedKeys) — tek çağrıda ikisi de verilebilir. 'keys' üzerinden yeni bir anahtar da açılabilir (upsert). 'values'taki dil kodları projenin languages listesinde tanımlı olmalı, aksi hâlde platform reddeder.",
+        description: "Bir ya da daha çok çeviri anahtarını toplu ekler/günceller (keys) ve/veya siler (deletedKeys) — tek çağrıda ikisi de verilebilir. 'keys' üzerinden yeni bir anahtar da açılabilir (upsert; verilmeyen diller silinmez, korunur). DİKKAT: çeviri yazmak tek başına YETMEZ — runtime bir etiketi ancak projenin languages listesi ve defaultLanguage kuruluysa çözer, aksi hâlde ekrana ham anahtar basar ve yazma yine 200 döner (ölçüldü 2026-09-09, S-15). Gateway yazmadan önce projeyi okur ve bağ kopuksa TR-002 caution'ı düşer; dilleri project_update(languages, defaultLanguage) ile kurun. Backend ön kontrolü (TR-001, block): anahtarlar boş olamaz ve tekil, dil kodları ISO 639-1 listesinden, deletedKeys boş olamaz.",
         inputSchema: {
             project: projectParam,
             environment: environmentParam,
@@ -25,13 +41,13 @@ export function registerTranslationTools(server, platform) {
             deletedKeys: z.array(z.string().min(1)).optional().describe('Silinecek anahtar adları')
         },
         annotations: updates
-    }, handle(config, ({ project, environment, applicationId, keys, deletedKeys }) => {
+    }, handle(config, async ({ project, environment, applicationId, keys, deletedKeys }) => {
         if (!keys?.length && !deletedKeys?.length) {
             throw new Error("'keys' ya da 'deletedKeys' parametrelerinden en az biri dolu olmalı.");
         }
-        return platform.tenant('PUT', project, `/translations/${applicationId}`, {
-            environment,
-            body: { keys: keys ?? [], deletedKeys: deletedKeys ?? [] }
-        });
+        const body = { keys: keys ?? [], deletedKeys: deletedKeys ?? [] };
+        const findings = enforcePolicy(evaluatePolicy(config, policyRules, 'translation', body, { operation: 'update' }));
+        const languages = await languageFindings(platform, project, keys ?? []);
+        return attachFindings(await platform.tenant('PUT', project, `/translations/${applicationId}`, { environment, body }), [...findings, ...languages]);
     }));
 }

package/dist/tools/views.js

@@ -3,6 +3,12 @@ import { guid, projectParam, environmentParam, definitionParam, pagingParams, re
 import { PlatformApiError } from '../platform/errors.js';
 import { handle } from '../platform/responses.js';
 import { z } from 'zod';
+import { unmappedMembers, withUnmappedMembers } from '../knowledge/schemaGuard.js';
+import { evaluatePolicy, enforcePolicy, attachFindings } from '../knowledge/policy.js';
+import { policyRules } from '../knowledge/rules.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)');
 export function registerViewTools(server, platform) {
     const config = platform.config;
     const normalizeSource = (definition) => {
@@ -19,29 +25,33 @@ export function registerViewTools(server, platform) {
     }, handle(config, ({ project, environment, ...query }) => platform.tenant('GET', project, '/views', { environment, query })));
     server.registerTool('view_get', {
         title: 'View getir',
-        description: 'Tek view tanımını getirir; view_create için en iyi gövde şablonudur.',
+        description: "Tek view tanımını getirir; view_create için en iyi gövde şablonudur. Hatırlatma: view TAM METİN ARAMA indeksidir, agregasyon/raporlama aracı değildir — özet için query_create (09-02 M-3).",
         inputSchema: { project: projectParam, environment: environmentParam, id: guid },
         annotations: readOnly
     }, handle(config, ({ project, environment, id }) => platform.tenant('GET', project, `/views/${id}`, { environment })));
     server.registerTool('view_create', {
         title: 'View oluştur',
-        description: "TAM METİN ARAMA indeksi tanımlar (definition = CreateViewCommand; gövde şeması ngapps://schemas/CreateViewCommand, analizör sözlüğü platform_guide('view')) — raporlama/agregasyon aracı DEĞİLDİR. Seçilen tablo/alanlar analizörden (tokenizer/dil) geçirilip slug adlı projeksiyon tablosuna indekslenir; tüketimi source:'view' microservice'idir ve o uç ZORUNLU 'searchText' parametresi ister (+limit/offset). Rapor/özet için raw query (query_create) + query kaynaklı microservice kullanın. Birden çok entity verilebilir (entities: [{entityId, alias}], fields alias'la bağlanır: viewEntityAlias) ama bu JOIN DEĞİLDİR: her tablo ayrı ayrı indekslenir, aralarında ilişki tanımı yoktur ve eşleşme hangi tablodan geldiyse dönen kayıt o tablonun satırıdır. İlişkili içeriği tek kayıtta aratmak için denormalize bir alan kullanın (yorum metnini talebe yazan automation + tek entity'li view).",
-        inputSchema: { project: projectParam, environment: environmentParam, definition: definitionParam },
+        description: "TAM METİN ARAMA indeksi tanımlar (definition = CreateViewCommand; gövde şeması ngapps://schemas/CreateViewCommand, analizör sözlüğü platform_guide('view')) — raporlama/agregasyon aracı DEĞİLDİR. Seçilen tablo/alanlar analizörden (tokenizer/dil) geçirilip slug adlı projeksiyon tablosuna indekslenir; tüketimi source:'view' microservice'idir ve o uç ZORUNLU 'searchText' parametresi ister (+limit/offset). Rapor/özet için raw query (query_create) + query kaynaklı microservice kullanın. Birden çok entity verilebilir (entities: [{entityId, alias}], fields alias'la bağlanır: viewEntityAlias) ama bu JOIN DEĞİLDİR: her tablo ayrı ayrı indekslenir, aralarında ilişki tanımı yoktur ve eşleşme hangi tablodan geldiyse dönen kayıt o tablonun satırıdır. İlişkili içeriği tek kayıtta aratmak için denormalize bir alan kullanın (yorum metnini talebe yazan automation + tek entity'li view). " + constraintSummary('CreateViewCommand'),
+        inputSchema: { project: projectParam, environment: environmentParam, definition: definitionParam, policyOverride: policyOverrideParam },
         annotations: writes
-    }, handle(config, async ({ project, environment, definition }) => {
+    }, handle(config, async ({ project, environment, definition, policyOverride }) => {
         const fixes = normalizeSource(definition);
+        const findings = enforcePolicy(evaluatePolicy(config, policyRules, 'view', definition, { operation: 'create' }, policyOverride));
+        const drift = unmappedMembers('CreateViewCommand', definition);
         const response = await platform.tenant('POST', project, '/views', { environment, body: definition });
-        return withNormalization(response, viewAliasNote(fixes));
+        return attachFindings(withUnmappedMembers(withNormalization(response, viewAliasNote(fixes)), drift), findings);
     }));
     server.registerTool('view_update', {
         title: 'View güncelle',
-        description: "View tanımını günceller (definition = UpdateViewCommand, şema ngapps://schemas/UpdateViewCommand); mevcut hâli view_get ile alın. UpdateViewCommand'da datasourceId YOKTUR (create'te bağlanır). DİKKAT: view_get alanları 'viewEntityId' ile döndürür, yazma tarafı 'viewEntityAlias' ister — okuduğunuzu birebir geri yazarsanız gateway id'yi alias'a çevirir, çeviremezse isteği reddeder.",
-        inputSchema: { project: projectParam, environment: environmentParam, id: guid, definition: definitionParam },
+        description: "View tanımını günceller (definition = UpdateViewCommand, şema ngapps://schemas/UpdateViewCommand); mevcut hâli view_get ile alın. UpdateViewCommand'da datasourceId YOKTUR (create'te bağlanır). DİKKAT: view_get alanları 'viewEntityId' ile döndürür, yazma tarafı 'viewEntityAlias' ister — okuduğunuzu birebir geri yazarsanız gateway id'yi alias'a çevirir, çeviremezse isteği reddeder. " + constraintSummary('UpdateViewCommand'),
+        inputSchema: { project: projectParam, environment: environmentParam, id: guid, definition: definitionParam, policyOverride: policyOverrideParam },
         annotations: updates
-    }, handle(config, async ({ project, environment, id, definition }) => {
+    }, handle(config, async ({ project, environment, id, definition, policyOverride }) => {
         const fixes = normalizeSource(definition);
+        const findings = enforcePolicy(evaluatePolicy(config, policyRules, 'view', definition, { operation: 'update' }, policyOverride));
+        const drift = unmappedMembers('UpdateViewCommand', definition);
         const response = await platform.tenant('PUT', project, `/views/${id}`, { environment, body: definition });
-        return withNormalization(response, viewAliasNote(fixes));
+        return attachFindings(withUnmappedMembers(withNormalization(response, viewAliasNote(fixes)), drift), findings);
     }));
     server.registerTool('view_delete', {
         title: 'View sil',
@@ -51,7 +61,7 @@ export function registerViewTools(server, platform) {
     }, handle(config, ({ project, environment, id }) => platform.tenant('DELETE', project, `/views/${id}`, { environment })));
     server.registerTool('view_rebuild', {
         title: 'View yeniden kur',
-        description: 'View projeksiyon tablosunu yeniden inşa eder (veri değişikliklerinden sonra senkron için).',
+        description: "View projeksiyon tablosunu yeniden inşa eder (veri değişikliklerinden sonra senkron için). Rebuild ARAMA indeksini tazeler; sayım/özet üretmez — raporlama için query_create (09-02 M-3).",
         inputSchema: { project: projectParam, environment: environmentParam, id: guid },
         annotations: writes
     }, handle(config, ({ project, environment, id }) => platform.tenant('POST', project, `/views/${id}/rebuild`, { environment })));