@appaflytech/zeyrek-ai-mcp 0.0.22 → 0.0.24

package/dist/tools/platformInfo.js

@@ -93,6 +93,7 @@ export function registerPlatformTools(server, platform) {
         'Modülün iş kuralları rehberini döner. Bir modülde İLK yazma işleminden önce ilgili rehberi okuyun:',
         ...guides.map(name => `- ${name}${guideRouting[name] ? `: ${guideRouting[name]}` : ''}`),
         "Büyük rehberler (page ~120 KB) section'sız çağrıda TAM METİN DÖNMEZ: giriş + bölüm listesi (outline) döner, truncated: true olur. Gövdeyi section ile bölüm bölüm alın.",
+        "Büyük gövdeyi (sayfa şeması, akış adımları, uç/workflow tanımı, patch op'ları) dosyaya yazıp bodyFile ile verin: gövde bağlamınızdan geçmez, satır içiyle aynı doğrulamadan geçer (page_*/flow_*/microservice_*/workflow_* create/update/patch). microservice_execute yanıt başlıkları varsayılan kısadır; ucun kendi başlığı için includeHeaders:'all'.",
         'Örnek gövdeler için ngapps://examples kaynaklarına bakın.'
     ].join('\n');
     server.registerTool('platform_whoami', {
@@ -155,6 +156,7 @@ export function registerPlatformTools(server, platform) {
         title: 'Kabiliyet boşluğu bildir',
         description: "Yapmak İSTEDİĞİNİZ ama platform desteklemediği için yapamadığınız her noktada BUNU ÇAĞIRIN — tasarımı sessizce küçültmeyin. Bu çağrı platforma gitmez, yalnızca günlüğe 'KABİLİYET BOŞLUĞU' bloğu yazar; hata günlüğünde görünmeyen bu kayıtlar ürün yol haritasının girdisidir. Önce rehbere bakıp (platform_guide; hazır komponent yetmiyorsa tek seferlik için 'html' kaçış kapısı, kalıcı bir ihtiyaç içinse 'external-component' — kendi komponentinizi yazıp yayınlayabilirsiniz) gerçekten desteklenmediğinden emin olun: desteklenen bir şeyi 'yok' diye bildirmek yanlış yol haritası üretir.",
         inputSchema: {
+            project: z.string().min(1).optional().describe("Boşluğun görüldüğü proje (ad ya da slug); kayda yazılır. Bu çağrı platforma gitmez, proje yalnız bağlamdır"),
             goal: z.string().min(1).optional().describe('Ne yapmak istediniz — kullanıcıya görünen sonuç olarak yazın ("randevu listesini hasta adına göre süzmek"). Eşanlamlı kabul edilir: title · summary · what.'),
             blocker: z.string().min(1).optional().describe('Neden yapamadınız — hangi kabiliyetin eksik olduğu ("uçta X yok", "komponentte Y prop\'u yok"). Eşanlamlı kabul edilir: reason · problem · missing · description.'),
             severity: z.string().optional().describe("YOL HARİTASINDAKİ SIRAYI BU ALAN BELİRLER, doldurun. blocker: özellik hiç yapılamadı · workaround: daha kötü bir yolla yapıldı · cosmetic: yalnız görsel/ergonomik kayıp. Eşanlamlılar çevrilir (critical/high/blocking→blocker, medium/major→workaround, low/minor/nit→cosmetic). TANINMAYAN değer reddedilir; verilmezse kayıt düşer ama yanıt 'incomplete' ile uyarır ve bildirim orta kovaya yazılır."),
@@ -172,9 +174,10 @@ export function registerPlatformTools(server, platform) {
         annotations: readOnly
     }, handle(config, async (input) => {
         const gap = normalizeGapReport(input);
-        logCapabilityGap({ goal: gap.goal, blocker: gap.blocker, severity: gap.severity, module: gap.module, attempted: gap.attempted, workaround: gap.workaround });
+        logCapabilityGap({ goal: gap.goal, blocker: gap.blocker, severity: gap.severity, module: gap.module, attempted: gap.attempted, workaround: gap.workaround, project: input.project });
         return {
             recorded: true,
+            ...(input.project ? { project: input.project } : {}),
             severity: gap.severity,
             module: gap.module ?? null,
             ...(Object.keys(gap.normalizedFrom).length > 0 ? { normalizedFrom: gap.normalizedFrom } : {}),

package/dist/tools/rows.js

@@ -4,7 +4,7 @@ import { unmappedMembers, withUnmappedMembers } from '../knowledge/schemaGuard.j
 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 { filterOperatorError, policyRules } from '../knowledge/rules.js';
 import { languageHeader } from '../knowledge/languageCodes.js';
 import { handle } from '../platform/responses.js';
 import { uploadFile } from './files.js';
@@ -224,6 +224,9 @@ export function registerRowTools(server, platform) {
         },
         annotations: readOnly
     }, handle(config, async ({ project, environment, entityId, language, ...body }) => {
+        const operatorError = filterOperatorError('row_list', body.filters);
+        if (operatorError)
+            throw new PlatformApiError(operatorError, 400);
         const notes = [];
         const headers = languageHeader(language, notes);
         const resolver = new RefResolver(platform, project, environment);
@@ -400,6 +403,9 @@ export function registerRowTools(server, platform) {
         if ((scope?.rowIds?.length ?? 0) > maxSelectedRowIds) {
             throw new PlatformApiError(`row_export: ${scope?.rowIds?.length} satır id'si, ${maxSelectedRowIds} sınırının üstünde. Bu kadar satırı seçerek değil filtreyle verin: scope { kind: 'view', filters: [...] }.`);
         }
+        const operatorError = filterOperatorError('row_export', scope?.filters);
+        if (operatorError)
+            throw new PlatformApiError(operatorError, 400);
         const resolvedFormat = format ?? 'xlsx';
         const notes = [];
         const resolver = new RefResolver(platform, project, environment);

package/dist/tools/schemaOps.js

@@ -24,7 +24,7 @@ export function outlineWriteResponse(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, replaceBoundFlows?} (olayın BÜTÜN bağlarını bu tek akışa indirir; olayda başka akış bağlıysa gateway PAGE-034 ile reddeder — bilerek değiştirmek için replaceBoundFlows: true) | add_event {target, event, eventValue} (olaya bir akış DAHA bağlar; bağlı akışların hepsi paralel ve birbirinden bağımsız koşar, sıra garantisi yoktur — sıra gerekiyorsa flow-trigger. Aynı akış iki kez 422 duplicate-event. Mobil runtime yalnız İLK akışı koşar) | remove_event {target, event, eventValue?} (olayı diziden çıkarır; target: 'page' sayfa düzeyi olaylar. Olaya birden fazla akış bağlıysa eventValue ile hangisi olduğunu verin, yoksa 422 ambiguous-event. 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.");
+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, replaceBoundFlows?} (olayın BÜTÜN bağlarını bu tek akışa indirir; olayda başka akış bağlıysa gateway PAGE-034 ile reddeder — bilerek değiştirmek için replaceBoundFlows: true) | add_event {target, event, eventValue} (olaya bir akış DAHA bağlar; bağlı akışların hepsi paralel ve birbirinden bağımsız koşar, sıra garantisi yoktur — sıra gerekiyorsa flow-trigger. Aynı akışı ikinci kez bağlamak etkisizdir (unchanged; tekrar güvenli). Mobil runtime yalnız İLK akışı koşar) | remove_event {target, event, eventValue?} (olayı diziden çıkarır; target: 'page' sayfa düzeyi olaylar. Olaya birden fazla akış bağlıysa eventValue ile hangisi olduğunu verin, yoksa 422 ambiguous-event. 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

package/dist/tools/screenWrite.js

@@ -35,9 +35,10 @@ export function invalidComponentNames(nodes) {
  * 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.
+ * barındıranın sayfa mı layout mu olduğuna bakmaz. `platform` yalnız PAGE-013 mesajının önerisini seçer
+ * (mobilde `grouped-list`); denetimlerin kendisi iki platformda aynıdır.
  */
-export function assertScreenWriteGuards(kind, screen) {
+export function assertScreenWriteGuards(kind, screen, platform) {
     const codes = GUARD_CODES[kind];
     const badEvents = invalidScreenEventNames(screen.events, codes.events);
     if (badEvents.length > 0)
@@ -54,7 +55,7 @@ export function assertScreenWriteGuards(kind, screen) {
     }
     const nested = nestedRepeaterNodes(screen.schema);
     if (nested.length > 0)
-        throw new PlatformApiError(nestedRepeaterMessage(nested), 400);
+        throw new PlatformApiError(nestedRepeaterMessage(nested, platform), 400);
 }
 /**
  * Katalog kurallarını (blok sınırı · auto-height · boyut string'i) ağaca uygular ve

package/dist/tools/screens.js

@@ -9,6 +9,81 @@ export const schemaParam = z.array(z.record(z.unknown()))
 export const eventsParam = z.array(z.record(z.unknown()))
     .describe("Sayfa/layout düzeyi olaylar: [{ name, value }] — value bir flow id'sidir");
 export const modeParam = z.enum(['summary', 'subtree', 'full']).optional().describe("summary (varsayılan): yalnız id/elementId/name/type ağacı — hedef bulmak için bunu kullanın. subtree: componentId ile tek alt ağaç. full: tüm şema.");
+/**
+ * Şema ağacındaki TÜM düğümler (kök + iç içe çocuklar); page_get, page_create özeti, page_update
+ * ve page_schema_get aynı sayımı kullanır. Parçalı okumanın `deferred` yer tutucuları düğüm değildir.
+ */
+export function countSchemaNodes(nodes) {
+    return (nodes ?? []).reduce((total, node) => node.deferred === true ? total : total + 1 + countSchemaNodes(node.children), 0);
+}
+function schemaNodeKey(node) {
+    return typeof node.elementId === 'string' ? node.elementId : String(node.id);
+}
+function schemaNodeKeys(nodes) {
+    return (nodes ?? []).flatMap(node => [schemaNodeKey(node), ...schemaNodeKeys(node.children)]);
+}
+/** `stored` ağacında olup `sent` ağacında olmayan düğümlerin elementId'leri, ön-sırayla (PAGE-037). */
+export function missingElementIds(stored, sent) {
+    const kept = new Set(schemaNodeKeys(sent));
+    return schemaNodeKeys(stored).filter(key => !kept.has(key));
+}
+/**
+ * ZM-28: şemayı her biri `budgetChars` karakteri (JSON uzunluğu, `shrink` ile aynı ölçü) aşmayan
+ * parçalara böler. Ön-sıra ve deterministik: alt ağacı sığan düğüm BÜTÜN alınır, sığmayan kabuk olarak
+ * yazılır ve çocuklarına inilir; parçaların birleşimi orijinal şemanın birebir aynısıdır.
+ */
+export function splitSchemaIntoParts(schema, budgetChars) {
+    const parts = [];
+    let current = [];
+    let currentChars = 2;
+    const place = (item, chars) => {
+        if (current.length > 0 && currentChars + 1 + chars > budgetChars) {
+            parts.push(current);
+            current = [];
+            currentChars = 2;
+        }
+        currentChars += (current.length > 0 ? 1 : 0) + chars;
+        current.push(item);
+    };
+    const visit = (node, parentElementId, index) => {
+        const whole = { parentElementId, index, node };
+        const wholeChars = JSON.stringify(whole).length;
+        if (2 + wholeChars <= budgetChars) {
+            place(whole, wholeChars);
+            return;
+        }
+        const children = Array.isArray(node.children) ? node.children : [];
+        const shell = {
+            parentElementId,
+            index,
+            node: { ...node, children: children.map(child => ({ elementId: schemaNodeKey(child), deferred: true })) }
+        };
+        const shellChars = JSON.stringify(shell).length;
+        if (children.length === 0 || 2 + shellChars > budgetChars) {
+            throw new PlatformApiError(`'${schemaNodeKey(node)}' (${String(node.type)}) düğümünün kendi gövdesi ${children.length === 0 ? wholeChars : shellChars} karakter; parça bütçesi ${budgetChars} karakter olduğu için tek düğüm bile bir yanıta sığmıyor. Düğümün büyük prop'unu page_schema_patch (replace_prop) ile küçültün ya da parçalara bölün; sonra cursor:'0' ile yeniden okuyun.`, 400);
+        }
+        place(shell, shellChars);
+        children.forEach((child, childIndex) => visit(child, schemaNodeKey(node), childIndex));
+    };
+    schema.forEach((node, index) => visit(node, null, index));
+    if (current.length > 0 || parts.length === 0)
+        parts.push(current);
+    return parts;
+}
+/** Opak parçalı okuma cursor'ı: sürüm değişince eski cursor reddedilir. */
+export function encodeSchemaCursor(version, partIndex) {
+    return `${version}:${partIndex}`;
+}
+/** `'0'` sürümsüz ilk parçadır; `<sürüm>:<parça>` sürümü taşır. Çözülemeyen cursor `undefined`. */
+export function decodeSchemaCursor(cursor) {
+    if (/^\d+$/.test(cursor))
+        return { partIndex: Number(cursor) };
+    const separator = cursor.lastIndexOf(':');
+    const partIndex = cursor.slice(separator + 1);
+    if (separator < 0 || !/^\d+$/.test(partIndex))
+        return undefined;
+    return { version: cursor.slice(0, separator), partIndex: Number(partIndex) };
+}
 /**
  * Ağacı yalnız kimlik alanlarına indirger; hedef aramak için okunur boyutta tutar.
  * `styleSource` verilirse (undefined DEĞİLSE) her düğüme efektif stil raporu da
@@ -102,6 +177,11 @@ export function flowPath(host, applicationId, hostId, flowId) {
             : `/components/${applicationId}/${hostId}/flows`;
     return flowId ? `${root}/${flowId}` : root;
 }
+/**
+ * Sayfa PUT gövdesi okunan sayfadan kurulur ve o sayfanın sürümünü `baseVersion` olarak taşır:
+ * platform sürümsüz sayfa PUT'unu reddeder (`plans/mobil-plantcare-acigi` b-05, K11). Gövde
+ * okunduğu andaki sayfanın üstüne yazar; ajanın planladığı sürümü `page_update` kendisi koyar.
+ */
 export function pageUpdateBody(page, overrides = {}) {
     const layout = (page.layout ?? {});
     return {
@@ -116,6 +196,7 @@ export function pageUpdateBody(page, overrides = {}) {
         middlewareIds: page.middlewareIds ?? [],
         roleIds: Array.isArray(page.roleIds) ? page.roleIds : identifiers(page.roles),
         layoutId: page.layoutId ?? layout.id ?? null,
+        baseVersion: page.version === undefined || page.version === null ? undefined : String(page.version),
         ...overrides
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appaflytech/zeyrek-ai-mcp",
-  "version": "0.0.22",
+  "version": "0.0.24",
   "type": "module",
   "description": "Zeyrek (NgApps) platform APIs as MCP tools — data, logic and Studio design surface in one gateway",
   "license": "UNLICENSED",