@appaflytech/zeyrek-ai-mcp 0.0.5 → 0.0.7

package/dist/knowledge/componentEvents.js

@@ -6,10 +6,17 @@ export const componentEventContracts = {
         pagination: { payload: { offset: 'number', limit: 'number' } },
         filter: { payload: { filters: 'Array<{ field, operator, value, filterType, conditionType }>', offset: 'number' } },
         sort: { payload: { sortField: 'string (kolonun name alanı)', sortType: "'asc' | 'desc' | '' (temizlendi)", offset: 'number' } },
-        select: { payload: {}, reads: 'self.selectedRow' },
-        selectionChange: { payload: {}, reads: 'self.selectedRows (dizi) + self.selectedRow' },
+        search: {
+            payload: {
+                searchText: 'string (kutuya yazılan metin, KIRPILMAZ; kutu temizlenince "")',
+                offset: 'number (0’a döner)'
+            },
+            reads: 'isSearchable:true iken araç çubuğundaki kutudan: yazmaya ara verince (400 ms), Enter’da ve kutu boşaltılınca hemen yayılır; aynı metin ikinci kez yayılmaz (Enter dahil). Enter formu göndermez. Tablo satırları kendisi SÜZMEZ — akış self.searchText ile sorguyu yeniden çalıştırıp rows’u yazar'
+        },
+        select: { payload: {}, reads: 'self.selectedRow — satır tıklaması rowSelection:none dahil HER kipte yazar ve bu olayı çalıştırır; isReadonly:true iken hiç çalışmaz' },
+        selectionChange: { payload: {}, reads: 'self.selectedRows (dizi) + self.selectedRow — yalnız multi kipindeki onay kutularından (satır tıklaması tetiklemez)' },
         doubleClick: { payload: {}, reads: 'self.selectedRow' },
-        rowChange: { payload: {}, reads: 'self.rows (düzenlenen satır yerinde güncellenir)' }
+        rowChange: { payload: {}, reads: 'self.selectedRow (düzenlenen satır, YENİ değeriyle) — satır nesnesi self.rows içinde de yerinde güncellenir; değer gerçekten değişmediyse olay çalışmaz' }
     },
     datatable: {
         mount: { payload: {}, reads: 'self.filters · self.sortField · self.sortType · self.offset · self.limit' }
@@ -32,8 +39,23 @@ export const componentEventContracts = {
     },
     phoneinput: {
         mount: NO_DATA,
-        change: { payload: { value: 'string (E.164, ör. +905321234567)' }, reads: "setter: self.value da yazılır. DEĞER DEĞİŞMEDİYSE YAYILMAZ — hane sınırına çarpan tuşlar ve süzülen harfler akış tetiklemez (PhoneInput.svelte:66)" },
-        blur: { payload: { value: 'string (E.164)' }, reads: 'change’in aksine her odak kaybında yayılır, değer aynı olsa bile; setter DEĞİLDİR' }
+        change: {
+            payload: {
+                value: 'string (E.164, ör. +905321234567)',
+                formattedValue: 'string (kullanıcının gördüğü satır: "+90 532 123 45 67"; boş alanda "")',
+                isValid: 'boolean (numara seçili ülke için TAM mı — boş alan false; zorunluluk kararı validations.required’ın işi)'
+            },
+            reads: "self’e yazılan tek anahtar `value`dur; `formattedValue` ve `isValid` düğüme YAZILMAZ, yalnız event.data’dadır (params). DEĞER DEĞİŞMEDİYSE YAYILMAZ — hane sınırına çarpan tuşlar ve süzülen harfler akış tetiklemez"
+        },
+        enter: {
+            payload: { value: 'string (E.164)', formattedValue: 'string', isValid: 'boolean' },
+            reads: 'Enter tuşu; change ile aynı yük. self.value’yu bu da yazar (platform emisyonun data’sını koşulsuz yazıyor, ARC-067) ama değer zaten change’in yazdığıdır — "gönder" kancası olarak kullan'
+        },
+        focus: NO_DATA,
+        blur: {
+            payload: { value: 'string (E.164)', formattedValue: 'string', isValid: 'boolean' },
+            reads: 'focus/blur SATIR düzeyindedir: numara alanı ile ülke seçicisi arasında gezinmek olay yaymaz, yalnız alanın tamamına girip çıkmak yayar. blur change’in aksine değer aynı olsa da yayılır ve yayılmış bir focus’un karşılığı alan sonradan donsa bile gelir; yükü self.value’yu yine yazar (ARC-067)'
+        }
     },
     filterbuilder: {
         mount: NO_DATA,
@@ -62,24 +84,81 @@ export const componentEventContracts = {
     },
     'layout-region': { mount: NO_DATA },
     navigations: { mount: NO_DATA },
-    textinput: { mount: NO_DATA, change: valueChange('string'), blur: NO_DATA },
-    textarea: { mount: NO_DATA, change: valueChange('string'), blur: NO_DATA },
-    password: { mount: NO_DATA, change: valueChange('string'), blur: NO_DATA },
-    // `change` ve `changed` AYNI anda yayılır (NumberInput.svelte:199-200) ve ikisi de setter'dır;
-    // `changed` eski akışlarla uyum için duruyor — yeni akışı `change`'e bağla, ikisine birden değil.
-    numberinput: { mount: NO_DATA, change: valueChange('number'), changed: valueChange('number'), blur: NO_DATA },
+    // `change` her tuşta (input), `changed` değer kesinleşince (native change: blur/Enter) yayılır;
+    // ikisi de setter'dır — pahalı akışı (sorgu, kayıt) `changed`'e bağla.
+    textinput: {
+        mount: NO_DATA,
+        change: valueChange('string'),
+        changed: valueChange('string (blur/Enter ile kesinleşen değer)'),
+        enter: { payload: { value: 'string (Enter anındaki değer)' }, reads: "form içindeyse Enter formun submit akışını da çalıştırır — kaydı forma bağla, enter'a değil" },
+        focus: NO_DATA,
+        blur: NO_DATA
+    },
+    textarea: { mount: NO_DATA, change: valueChange('string'), changed: valueChange('string (blur ile kesinleşen değer)'), focus: NO_DATA, blur: NO_DATA },
+    password: {
+        mount: NO_DATA,
+        change: valueChange('string'),
+        changed: valueChange('string (blur/Enter ile kesinleşen değer)'),
+        enter: { payload: { value: 'string (Enter anındaki değer)' }, reads: "form içindeyse Enter formun submit akışını da çalıştırır — girişi forma bağla, enter'a değil" },
+        focus: NO_DATA,
+        blur: NO_DATA
+    },
+    // `change` her tuşta ve artı/eksi düğmesinde, `changed` değer kesinleşince (blur/Enter, düğme)
+    // yayılır; ikisi de setter'dır — pahalı akışı `changed`'e bağla. Boşaltılan alan 0 yayar (K-3).
+    numberinput: {
+        mount: NO_DATA,
+        change: valueChange('number (aralığa kırpılmış)'),
+        changed: valueChange('number (blur/Enter/artı-eksi ile kesinleşen değer)'),
+        enter: { payload: { value: 'number (Enter anında kesinleşen, kırpılmış değer)' }, reads: "form içindeyse Enter formun submit akışını da çalıştırır — kaydı forma bağla, enter'a değil" },
+        focus: NO_DATA,
+        blur: NO_DATA
+    },
     incrementalinput: { mount: NO_DATA, change: valueChange('string'), blur: NO_DATA },
-    texteditor: { onMount: NO_DATA, onChange: valueChange('string (HTML)') },
-    checkbox: { change: valueChange('boolean'), checked: valueChange('boolean'), unchecked: valueChange('boolean') },
-    switch: { change: valueChange('boolean'), checked: valueChange('boolean'), unchecked: valueChange('boolean') },
+    // Adlar 2026-09-11'de `on` önekinden kurtuldu: şema onMount/onChange diyordu, runtime
+    // mount/change yayıyordu ve flow-machine eşleşmeyi ADLA yaptığı için bu bileşene bağlanan
+    // hiçbir akış çalışmıyordu.
+    texteditor: {
+        mount: NO_DATA,
+        change: { payload: { value: "string (HTML; boş editörde boş metin)" }, reads: "setter: self.value da yazılır. HER TUŞTA yayılır — pahalı akışı changed'e bağla" },
+        changed: { payload: { value: "string (HTML; boş editörde boş metin)" }, reads: "setter: self.value da yazılır; yalnız odak çıkışında ve değer gerçekten değiştiyse yayılır" },
+        focus: NO_DATA,
+        blur: NO_DATA
+    },
+    checkbox: {
+        mount: NO_DATA,
+        change: { payload: { value: 'boolean' }, reads: "setter: self.value da yazılır. Her tıkta İKİ olay yayılır — change ve (yeni duruma göre) checked ya da unchecked; ikisini birden bağlarsan akış iki kez koşar" },
+        checked: { payload: { value: 'boolean (true)' }, reads: 'setter: self.value da yazılır; change ile AYNI tıkta yayılır' },
+        unchecked: { payload: { value: 'boolean (false)' }, reads: 'setter: self.value da yazılır; change ile AYNI tıkta yayılır' },
+        focus: NO_DATA,
+        blur: NO_DATA
+    },
+    switch: {
+        mount: NO_DATA,
+        change: { payload: { value: 'boolean' }, reads: "setter: self.value da yazılır. Her flip'te İKİ olay yayılır — change ve (yeni duruma göre) checked ya da unchecked; ikisini birden bağlarsan akış iki kez koşar" },
+        checked: { payload: { value: 'boolean (true)' }, reads: 'setter: self.value da yazılır; change ile AYNI flip’te yayılır' },
+        unchecked: { payload: { value: 'boolean (false)' }, reads: 'setter: self.value da yazılır; change ile AYNI flip’te yayılır' },
+        focus: NO_DATA,
+        blur: NO_DATA
+    },
     radio: { change: valueChange('string') },
-    dropdown: { mount: NO_DATA, change: valueChange('seçilen option değeri'), search: { payload: { searchText: 'string' } }, focus: NO_DATA },
-    'multi-select': { mount: NO_DATA, change: valueChange('değer dizisi'), search: { payload: { searchText: 'string' } }, focus: NO_DATA },
-    'tag-input': { mount: NO_DATA, change: valueChange('etiket dizisi'), focus: NO_DATA },
+    dropdown: { mount: NO_DATA, change: { payload: { value: 'seçilen option değeri', selectedLabel: "seçilen option'ın label metni (temizlemede '')" } }, search: { payload: { searchText: 'string' } }, focus: NO_DATA, blur: NO_DATA },
+    'multi-select': { mount: NO_DATA, change: { payload: { value: "seçilen değerlerin dizisi: [{ value, label, id, text }] — id/text, value/label'ın eski adlı ikizleridir" } }, search: { payload: { searchText: 'string' } }, focus: NO_DATA, blur: NO_DATA },
+    'tag-input': { mount: NO_DATA, change: { payload: { value: 'etiket dizisi: [{ value, color? }] — renk verilmemiş etikette color anahtarı HİÇ bulunmaz' } }, search: { payload: { searchText: 'string' } }, focus: NO_DATA, blur: NO_DATA },
     datepicker: { mount: NO_DATA, change: { payload: { value: 'string (tarih)', HH: 'string', mm: 'string' } } },
     datetimepicker: { mount: NO_DATA, change: { payload: {}, reads: 'self.value' } },
     daterangepicker: { mount: NO_DATA, change: { payload: { valueFrom: 'string', valueTo: 'string', HH: 'string', mm: 'string' } } },
-    datetimerangepicker: { mount: NO_DATA, change: { payload: { valueFrom: 'string', valueTo: 'string', HH: 'string', mm: 'string' } } },
+    datetimerangepicker: {
+        mount: NO_DATA,
+        change: {
+            payload: {
+                valueFrom: "string 'yyyy-MM-ddTHH:mm:ss' | null (yerel duvar saati, dilim eki yok; yarı boşaltılınca null)",
+                valueTo: "string 'yyyy-MM-ddTHH:mm:ss' | null"
+            },
+            reads: "ikisi de düğümün prop'una yazılır: self.valueFrom / self.valueTo. Bir yarı yalnız tarih+saat ikisi de seçilince yayar. HH/mm anahtarları YOKTUR (2026-09-12'de kayıttan çıkarıldı — runtime hiç göndermiyordu)."
+        },
+        focus: NO_DATA,
+        blur: NO_DATA
+    },
     fileUpload: { change: { payload: {}, reads: 'self.value' } },
     fileInput: { change: { payload: { value: 'Array<{ type, value }>', fileName: 'string' } } },
     filebutton: { change: { payload: { value: 'Array<{ type, value }>', fileName: 'string' } } },
@@ -118,9 +197,18 @@ export const componentEventContracts = {
     // 2026-08-25c, `docs/20-komponent-bilgi-katmani.md` §9).
     autocomplete: {
         mount: NO_DATA,
-        change: valueChange('string (YAZILAN metin — option değeri değil)'),
-        select: { payload: { value: "seçilen option'ın değeri", label: "seçilen option'ın etiketi" }, reads: 'self.value etiketi taşır; id gerekiyorsa bu olaydaki value' },
-        search: { payload: { searchText: 'string' } },
+        change: {
+            payload: { value: 'string (YAZILAN metin — option değeri değil)' },
+            reads: "setter: self.value da yazılır. Temizleme (×) ve strict geri alma aynı olayı { value: '', selectedValue: '', selectedLabel: '' } ile yayar — alan boşalınca seçim durumu da boşalır"
+        },
+        select: {
+            payload: {
+                selectedValue: "seçilen option'ın değeri",
+                selectedLabel: "seçilen option'ın etiketi"
+            },
+            reads: "self.value etiketi taşır; option'ın değeri için self.selectedValue (2026-09-11'e kadar yükün adları value/label idi ve alanın kendi prop'larını eziyordu)"
+        },
+        search: { payload: { searchText: 'string' }, reads: 'self.searchText' },
         enter: { payload: { value: 'string (Enter anındaki metin; vurgulu öneri yokken)' } },
         focus: NO_DATA,
         blur: NO_DATA
@@ -191,13 +279,20 @@ export const componentEventContracts = {
         blur: NO_DATA
     },
     statcard: { mount: NO_DATA, click: NO_DATA, footerClick: { payload: {}, reads: "footerFlow zaten doğrudan çalışır; footerHref varsa tıklama ona gider" } },
-    switcher: { change: valueChange('boolean'), checked: valueChange('boolean'), unchecked: valueChange('boolean') },
+    switcher: {
+        mount: NO_DATA,
+        change: { payload: { value: 'boolean' }, reads: "setter: self.value da yazılır. Her geçişte İKİ olay yayılır — change ve (yeni duruma göre) checked ya da unchecked; ikisini birden bağlarsan akış iki kez koşar" },
+        checked: { payload: { value: 'boolean (true)' }, reads: 'setter: self.value da yazılır; change ile AYNI geçişte yayılır' },
+        unchecked: { payload: { value: 'boolean (false)' }, reads: 'setter: self.value da yazılır; change ile AYNI geçişte yayılır' },
+        focus: NO_DATA,
+        blur: NO_DATA
+    },
     timeline: {
         mount: NO_DATA,
         clickItem: { payload: { currentItem: 'tıklanan olay öğesi', index: 'number' }, reads: "öğenin kendi flow'u da doğrudan çalışır" },
         showMore: NO_DATA
     },
-    timepicker: { mount: NO_DATA, change: valueChange("string 'HH:mm' (temizlenince '')"), focus: NO_DATA, blur: NO_DATA },
+    timepicker: { mount: NO_DATA, change: { payload: { value: "string 'HH:mm' (temizlenince '')", selectedLabel: "seçilen saatin gösterilen metni — 12h kipinde '01:00 PM' (temizlenince '')" } }, focus: NO_DATA, blur: NO_DATA },
     toast: {
         open: NO_DATA,
         close: NO_DATA,
@@ -270,9 +365,9 @@ export const componentEventContracts = {
         mount: NO_DATA,
         change: {
             payload: { value: "string (PNG data-URL ya da HAM SVG işaretlemesi; temizlemede '')" },
-            reads: 'setter: self.value da güncellenir, event.data.value da dolu gelir; her tamamlanan çizgide bir kez yayılır'
+            reads: "setter: self.value da güncellenir, event.data.value da dolu gelir; her tamamlanan çizgide bir kez yayılır. Ayrıca outputFormat/penColor/penWidth değişince mevcut vuruşlar yeniden dışa aktarılır ve change bir kez daha yayılır. Akış value'yu setter ile yazdığında ped sıfırlanır ama change YAYILMAZ — kendi yazdığın değer geri gelmez"
         },
-        clear: { payload: {}, reads: "temizlemede önce change('') yayılır, sonra clear — değeri change'ten oku" }
+        clear: { payload: {}, reads: "yalnız kullanıcı Clear düğmesine bastığında yayılır; önce change('') gelir, sonra clear — değeri change'ten oku. Akıştan value'yu '' yapmak pedi temizler ama hiçbir olay yaymaz" }
     },
     stepper: {
         mount: NO_DATA,

package/dist/knowledge/coverage.js

@@ -20,6 +20,49 @@ export function formBindingWarnings(ops) {
         .filter(elementId => !boundForms.has(elementId))
         .map(elementId => `FORM-001: '${elementId}' formuna 'submit' olayı bağlanmadı — form kendi başına kayıt YAPMAZ, gönderimi bir flow yürütür. flow_create ile submit akışını kurup set_event { target: '${elementId}', event: 'submit', eventValue: <flow id> } ile bağlayın (örnek: ngapps://examples/page-form-upsert). Bağlamayı sonraki patch'e bıraktıysanız bu uyarıyı yok sayın.`);
 }
+/**
+ * FORM-003 — formun `submit` olayı bağlı ama form içindeki butonun `click` olayı bağlı değil.
+ * ÖLÇÜLDÜ 2026-09-05 (Corecruiter koşusu, `S-18`): `ngapps://examples/page-sign-in` örneği akışı
+ * forma bağlıyor ve içine düz bir `button` koyuyor; runtime o butonu `<button type="button">`
+ * çiziyor, yani HTML form submit'i HİÇ doğmuyor. Butona tıklamak da alanda Enter da uca istek
+ * göndermedi, hata da çıkmadı — teşhis yalnız gerçek tıklamayla mümkün oldu. Örneğin kendi notu
+ * "kimlik middleware'i kuran her projede bu sayfa ZORUNLUDUR" dediği için tuzak, örneği izleyerek
+ * kurulan her uygulamanın giriş kapısında duruyor.
+ */
+export function formSubmitButtonWarnings(ops) {
+    const operations = asObjects(ops);
+    const boundClicks = new Set(operations
+        .filter(op => op.op === 'set_event' && String(op.event ?? '') === 'click')
+        .map(op => String(op.target ?? '')));
+    const submitForms = new Set(operations
+        .filter(op => op.op === 'set_event' && String(op.event ?? '') === 'submit')
+        .map(op => String(op.target ?? '')));
+    const submitsNatively = (node) => {
+        const prop = (node.props ?? {}).type;
+        return String(prop?.data ?? prop ?? '') === 'submit';
+    };
+    const buttonsIn = (node) => {
+        const found = [];
+        for (const child of asObjects(node.children)) {
+            if (String(child.type ?? '') === 'button' && !submitsNatively(child))
+                found.push(String(child.elementId ?? '?'));
+            found.push(...buttonsIn(child));
+        }
+        return found;
+    };
+    return operations
+        .filter(op => op.op === 'add_component' && FORM_TYPES.has(String(op.component?.type ?? '')))
+        .flatMap(op => {
+        const component = (op.component ?? {});
+        const elementId = String(component.elementId ?? '?');
+        if (!submitForms.has(elementId))
+            return [];
+        const loose = buttonsIn(component).filter(buttonId => !boundClicks.has(buttonId));
+        if (loose.length === 0)
+            return [];
+        return [`FORM-003 (uyarı): '${elementId}' formunun 'submit' olayı bağlı ama içindeki buton(lar) ne props.type:'submit' taşıyor ne de 'click' olayı bağlı: ${loose.join(', ')}. Buton varsayılan olarak type="button" çizilir ve HTML form submit'i HİÇ doğmaz — tıklamak da Enter da uca istek göndermez, hata da çıkmaz (ölçüldü 2026-09-05). İki çözümden biri: butona props.type = 'submit' verin, ya da aynı akışı butonun click olayına da bağlayın (set_event { target: '${loose[0]}', event: 'click', eventValue: <aynı flow id> }).`];
+    });
+}
 /**
  * FORM-002 — akıştaki yazma ucu (post/put/patch) hiç `source:'body'` parametresi taşımıyor:
  * istek gider, gövde boş olduğu için kayıt ya boş yazılır ya doğrulamadan döner. Form alanları uca

package/dist/knowledge/flowGuards.js

@@ -0,0 +1,30 @@
+/**
+ * FLOW-011'in guard tanıması: lint `Steps.x.headers && Steps.x.headers["total-count"]` formunu
+ * guard'sız sanıp uyarıyordu ve aynı ifade için İKİ bulgu üretiyordu — regex her geçişi bağımsız
+ * saydığı, guard formu da kalıbı iki kez içerdiği için (İK koşusu E-6).
+ */
+function stepRef(name) {
+    const escaped = name.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    return `Steps\\s*(?:\\.\\s*${escaped}|\\[\\s*['"]${escaped}['"]\\s*\\])`;
+}
+const anyHeadersAccess = /Steps\s*(?:\.\s*([A-Za-z_$][\w$]*)|\[\s*['"]([^'"]+)['"]\s*\])\s*\??\.\s*headers\b/g;
+export function headersAccessNames(expression) {
+    const names = new Set();
+    let match;
+    anyHeadersAccess.lastIndex = 0;
+    while ((match = anyHeadersAccess.exec(expression)) !== null) {
+        names.add(match[1] ?? match[2] ?? '');
+    }
+    return [...names].filter(name => name !== '');
+}
+export function isHeadersAccessGuarded(expression, name) {
+    const ref = stepRef(name);
+    const unguardedRead = new RegExp(`${ref}\\s*\\.\\s*headers\\s*(?:\\.|\\[)`, 'g');
+    const guardedRead = new RegExp(`${ref}\\s*(?:\\?\\.\\s*headers|\\.\\s*headers\\s*\\?\\.)`, 'g');
+    const precondition = new RegExp(`${ref}\\s*(?:\\.\\s*headers\\s*)?&&`);
+    if (precondition.test(expression))
+        return true;
+    const unguarded = expression.match(unguardedRead)?.length ?? 0;
+    const guarded = expression.match(guardedRead)?.length ?? 0;
+    return unguarded === 0 && guarded > 0;
+}

package/dist/knowledge/functionGuards.js

@@ -0,0 +1,134 @@
+export const FUNCTIONS_NAMESPACE = 'Functions';
+const NAME_PATTERN = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
+/** JavaScript ayrılmış sözcükleri — `GlobalFunctionRules.ReservedWordNames` ile aynı liste. */
+export const RESERVED_WORDS = new Set([
+    'await', 'break', 'case', 'catch', 'class', 'const', 'continue', 'debugger', 'default', 'delete',
+    'do', 'else', 'enum', 'export', 'extends', 'false', 'finally', 'for', 'function', 'if',
+    'implements', 'import', 'in', 'instanceof', 'interface', 'let', 'new', 'null', 'package', 'private',
+    'protected', 'public', 'return', 'static', 'super', 'switch', 'this', 'throw', 'true', 'try',
+    'typeof', 'var', 'void', 'while', 'with', 'yield'
+]);
+/**
+ * Workflow motorunun global adları — `GlobalFunctionRules.WorkflowReservedNames` ile birebir.
+ * `source:'workflow'` fonksiyonu bu adı alırsa motorun kendi nesnesini ezerdi (platform 422).
+ */
+export const WORKFLOW_RESERVED_NAMES = new Set([
+    'Authorized', 'body', 'convert', 'ConvertToCsv', 'ConvertToPdf', 'cookie', 'crypto', 'DecodeQr', 'DeepEqual', 'error', 'file',
+    'GenerateAccessToken', 'GenerateGuid', 'GenerateJwt', 'GeneratePKCE', 'Hash', 'header', 'input', 'log', 'Log', 'Now',
+    'queryString', 'request', 'RequestPathAndQuery', 'RequestUrl', 'route', 'system', 'Today', 'ToTimeZone', 'UtcNow', 'ValidateAccessToken'
+]);
+export function sourceOf(definition) {
+    return definition.source === 'workflow' ? 'workflow' : 'studio';
+}
+export function isValidParameterName(name) {
+    return typeof name === 'string' && NAME_PATTERN.test(name) && !RESERVED_WORDS.has(name);
+}
+export function isValidFunctionName(name, source = 'studio') {
+    return isValidParameterName(name) && (source === 'workflow' ? !WORKFLOW_RESERVED_NAMES.has(name) : name !== FUNCTIONS_NAMESPACE);
+}
+/** Geçersiz adın NEDENİ — mesaj kullanıcıya hangi kuralı bozduğunu söylesin diye. */
+export function nameProblem(name, source = 'studio') {
+    if (typeof name !== 'string' || name.trim() === '')
+        return 'boş';
+    if (!NAME_PATTERN.test(name))
+        return `JS tanımlayıcısı değil (${NAME_PATTERN.source})`;
+    if (RESERVED_WORDS.has(name))
+        return 'JavaScript ayrılmış sözcüğü';
+    if (source === 'workflow' && WORKFLOW_RESERVED_NAMES.has(name))
+        return `workflow motorunun global adı ('${name}' — system, input, Now… ezilemez)`;
+    if (source === 'studio' && name === FUNCTIONS_NAMESPACE)
+        return `'${FUNCTIONS_NAMESPACE}' ad alanının kendisi (ayrılmış ad, K1)`;
+    return undefined;
+}
+/** Çağrı biçimi: studio `Functions.<ad>`, workflow çıplak `<ad>`. */
+export function callPrefix(source) {
+    return source === 'workflow' ? '' : `${FUNCTIONS_NAMESPACE}.`;
+}
+/**
+ * Studio'nun canlı imza önizlemesiyle aynı biçim: `Functions.toplamHesapla(fiyat, adet = 1)`;
+ * workflow kaynağında öneksiz `toplamHesapla(fiyat, adet = 1)`. Varsayılanı olmayan ve zorunlu
+ * olmayan parametre `ad?` yazılır.
+ */
+export function functionSignature(definition) {
+    const parameters = Array.isArray(definition.parameters) ? definition.parameters : [];
+    const rendered = parameters
+        .filter(parameter => parameter && typeof parameter === 'object')
+        .map(parameter => {
+        const name = String(parameter.name ?? '?');
+        if (parameter.defaultValue !== undefined && parameter.defaultValue !== null)
+            return `${name} = ${JSON.stringify(parameter.defaultValue)}`;
+        return parameter.required === true ? name : `${name}?`;
+    });
+    return `${callPrefix(sourceOf(definition))}${String(definition.name ?? '?')}(${rendered.join(', ')})`;
+}
+const CALL_PATTERN = /\bFunctions\s*\.\s*([A-Za-z_$][\w$]*)\s*\(/g;
+/**
+ * Bir ifadedeki `Functions.<ad>(` çağrılarını ve KABA argüman sayısını döner. Sayım parantez
+ * dengesiyle üst düzey virgülleri sayar; string/şablon ve iç içe çağrı içindeki virgül
+ * sayılmaz. Yine de yaklaşıktır — çağıran yalnız FAZLA argümanda uyarır, eksik argümanı
+ * `required` kuralına bırakır (K5: eşleme konumsaldır, `undefined` → varsayılan).
+ */
+export function functionCallRefs(expression) {
+    const refs = [];
+    let match;
+    CALL_PATTERN.lastIndex = 0;
+    while ((match = CALL_PATTERN.exec(expression)) !== null) {
+        refs.push({ name: match[1] ?? '', argCount: countArguments(expression, match.index + match[0].length), index: match.index });
+    }
+    return refs.filter(ref => ref.name !== '');
+}
+function countArguments(source, start) {
+    let depth = 0;
+    let commas = 0;
+    let quote;
+    let sawToken = false;
+    for (let index = start; index < source.length; index++) {
+        const char = source[index];
+        if (quote !== undefined) {
+            if (char === '\\') {
+                index++;
+                continue;
+            }
+            if (char === quote)
+                quote = undefined;
+            continue;
+        }
+        if (char === '\'' || char === '"' || char === '`') {
+            quote = char;
+            sawToken = true;
+            continue;
+        }
+        if (char === '(' || char === '[' || char === '{') {
+            depth++;
+            sawToken = true;
+            continue;
+        }
+        if (char === ')' || char === ']' || char === '}') {
+            if (depth === 0)
+                return sawToken ? commas + 1 : 0;
+            depth--;
+            continue;
+        }
+        if (char === ',' && depth === 0) {
+            commas++;
+            continue;
+        }
+        if (!/\s/.test(char))
+            sawToken = true;
+    }
+    return sawToken ? commas + 1 : 0;
+}
+function escapeRegex(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/** Çıplak `<ad>(` çağrısı — backend `GlobalFunction.IsCalledIn`'in workflow kalıbıyla aynı sınırlar. */
+export function callsBareName(name, expression) {
+    return name !== '' && new RegExp(`(?<![A-Za-z0-9_$.])${escapeRegex(name)}\\s*\\(`).test(expression);
+}
+/** Gövde kendi adını çağırıyor mu — studio `Functions.<ad>(`, workflow çıplak `<ad>(` (özyineleme, FN-003). */
+export function callsItself(name, body, source = 'studio') {
+    return source === 'workflow' ? callsBareName(name, body) : functionCallRefs(body).some(ref => ref.name === name);
+}
+export function mentionsAwait(body) {
+    return /\bawait\b/.test(body);
+}

package/dist/knowledge/guideSections.js

@@ -0,0 +1,49 @@
+const turkishMap = { ç: 'c', ğ: 'g', ı: 'i', ö: 'o', ş: 's', ü: 'u', â: 'a', î: 'i', û: 'u' };
+export function sectionSlug(title) {
+    return title.toLocaleLowerCase('tr')
+        .replace(/[çğıöşüâîû]/g, letter => turkishMap[letter] ?? letter)
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+/**
+ * Rehberler `## ` başlıklarıyla bölümlü; `page.md` 120 KB'ı aşınca tool çıktı sınırına takıldı ve
+ * MCP kanalından hiç okunamadı (09-04 koşusu). Bölümleme var olan başlıkları kullanır, dosyaların
+ * içeriğine dokunmaz.
+ *
+ * Satır sonu ÖNEMLİ: başlık ifadesindeki `.` satır sonu karakterlerini eşlemez ve `$` çok satırlı
+ * değildir, yani `\r` ile biten bir satırda hiçbir başlık görünmez. Windows çalışma ağacında
+ * (`.gitattributes` yokken) rehberlerin tamamı CRLF olduğu için bölümleyici tek "giriş" bölümü
+ * üretiyor, `platform_guide` de oversize dalında rehberin TAMAMINI döndürüp tool sınırını
+ * aşıyordu — ölçüldü 2026-09-05, `page.md` 22 başlık → 1 bölüm. Girdi bu yüzden bölünmeden önce
+ * satır sonlarından arındırılır.
+ */
+export function splitGuideSections(markdown) {
+    const sections = [];
+    const used = new Map();
+    let fence = '';
+    let title = '';
+    let lines = [];
+    const push = () => {
+        if (title === '' && lines.join('\n').trim() === '')
+            return;
+        const base = title === '' ? 'giris' : sectionSlug(title);
+        const seen = (used.get(base) ?? 0) + 1;
+        used.set(base, seen);
+        sections.push({ slug: seen === 1 ? base : `${base}-${seen}`, title: title === '' ? 'Giriş' : title, body: lines.join('\n').trim() });
+    };
+    for (const line of markdown.split(/\r\n|\r|\n/)) {
+        const marker = /^\s*(`{3,})/.exec(line)?.[1] ?? '';
+        if (marker.length > 0)
+            fence = fence === '' ? marker : (marker.length >= fence.length ? '' : fence);
+        const heading = fence === '' ? /^## (?!#)(.+)$/.exec(line)?.[1] : undefined;
+        if (heading === undefined) {
+            lines.push(line);
+            continue;
+        }
+        push();
+        title = heading.trim();
+        lines = [];
+    }
+    push();
+    return sections;
+}

package/dist/knowledge/hydrate.js

@@ -0,0 +1,97 @@
+import { RefResolveError, isGuid } from '../platform/refs.js';
+const fieldCarriers = ['fields', 'selectFields', 'returnFields'];
+function entries(value) {
+    return Array.isArray(value) ? value.filter((entry) => Boolean(entry) && typeof entry === 'object') : [];
+}
+function collectJoinAliases(joins, into) {
+    for (const join of entries(joins)) {
+        const alias = String(join.alias ?? '').trim();
+        if (alias)
+            into.add(alias);
+        collectJoinAliases(join.joins, into);
+    }
+    return into;
+}
+function pendingEntries(parameters) {
+    const pending = [];
+    const walk = (list) => {
+        for (const entry of entries(list)) {
+            if (typeof entry.fieldSlug === 'string' && typeof entry.fieldId !== 'string')
+                pending.push(entry);
+            walk(entry.children);
+        }
+    };
+    for (const key of fieldCarriers)
+        walk(parameters[key]);
+    walk(parameters.filters);
+    return pending;
+}
+/**
+ * Hydration normalize'dan ÖNCE koşmak zorundadır: `normalizeTableParameters` join ve seçim
+ * yollarını `fieldId`'ye göre üretir (`normalize.ts` `fillJoinPaths`), boş `fieldId` gören
+ * normalize yolu hiç doldurmaz.
+ *
+ * GUID'li ve `fieldSlug` taşımayan tanımlar hiç ağ turu ödemez ve ağaç hiç okunmaz — ağaç
+ * uçtaki gizli entity'leri (Files/Folders, EnumValues) TAŞIMAZ, dolayısıyla koşulsuz çözüm
+ * bugüne kadar çalışan GUID'li çağrıları "ağaçta yok" diye düşürürdü.
+ *
+ * Kapsam bilinçli olarak KÖK entity ile sınırlı: `joins[]` girdileri şemada `fieldSlug`
+ * taşımaz (`TableJoin` = alias·entityId·fieldId·joins·path), join'lenen entity'nin alanları
+ * ayrı bir görev.
+ */
+export async function hydrateMicroserviceRefs(definition, resolver) {
+    if (definition.source !== 'table')
+        return [];
+    const rootRef = String(definition.entityId ?? '');
+    if (rootRef === '')
+        return [];
+    const parameters = (definition.sourceParameters ?? {});
+    const nestedRef = String(parameters.entityId ?? '');
+    const pending = pendingEntries(parameters);
+    if (pending.length === 0 && isGuid(rootRef) && (nestedRef === '' || isGuid(nestedRef)))
+        return [];
+    const fixes = [];
+    const root = await resolver.entity(rootRef);
+    if (!isGuid(rootRef)) {
+        definition.entityId = root.entityId;
+        fixes.push(`entityId '${rootRef}' → ${root.entityId}`);
+    }
+    if (nestedRef !== '' && !isGuid(nestedRef)) {
+        parameters.entityId = (await resolver.entity(nestedRef)).entityId;
+        fixes.push(`sourceParameters.entityId '${nestedRef}' → ${String(parameters.entityId)}`);
+    }
+    if (pending.length === 0)
+        return fixes;
+    const fields = await resolver.entityFields(root);
+    const idBySlug = new Map(fields.map(field => [field.slug, field.id]));
+    const joinAliases = collectJoinAliases(parameters.joins, new Set());
+    const declaredAlias = String(parameters.alias ?? '').trim();
+    const rootAlias = declaredAlias === '' ? root.slug : declaredAlias;
+    const fill = (entry, where) => {
+        const slug = typeof entry.fieldSlug === 'string' ? entry.fieldSlug : undefined;
+        const alias = String(entry.alias ?? '').trim();
+        if (slug === undefined || typeof entry.fieldId === 'string')
+            return;
+        // Kök girdi: alias yok, kök alias'ı, ya da hiçbir join'e ait değil — `normalize.fillRootAlias`
+        // kök alias'ı tam da bu çıkarımla buluyor; ikisi ayrışırsa filtre sessizce fieldId'siz gider.
+        if (alias !== '' && alias !== rootAlias && joinAliases.has(alias))
+            return;
+        const id = idBySlug.get(slug);
+        if (id === undefined) {
+            throw new RefResolveError(`'${slug}' diye bir alan '${root.slug}' entity'sinde yok (${where}). Mevcut alanlar: ${[...idBySlug.keys()].join(', ')}`);
+        }
+        entry.fieldId = id;
+        fixes.push(`${where}.fieldSlug '${slug}' → ${id}`);
+    };
+    for (const key of fieldCarriers) {
+        entries(parameters[key]).forEach((entry, index) => fill(entry, `${key}[${index}]`));
+    }
+    const walkFilters = (list, prefix) => {
+        entries(list).forEach((entry, index) => {
+            fill(entry, `${prefix}[${index}]`);
+            walkFilters(entry.children, `${prefix}[${index}].children`);
+        });
+    };
+    walkFilters(parameters.filters, 'filters');
+    return fixes;
+}

package/dist/knowledge/languageCodes.js

@@ -0,0 +1,36 @@
+import { PlatformApiError } from '../platform/errors.js';
+const ISO_639_1 = /^[a-z]{2}$/;
+/**
+ * Platformun tek dil kodu biçimi ISO 639-1 küçük harftir (sözleşme D2). Dışarıdan gelen BCP-47
+ * değer ('tr-TR', 'en_US') birincil alt etikete indirgenir ve bölge saklanmaz — backend de aynısını
+ * yapar (`LanguageContext.RequestedLanguages`). İndirgeme SESSİZ yapılmaz: 'pt-BR' gönderip 'pt'
+ * kaydedildiğini bilmeyen çağıran, bölge ayrımının platformda hiç olmadığını fark etmiyor.
+ */
+export function normalizeLanguageCode(input, field) {
+    const code = (input.trim().split(/[-_]/)[0] ?? '').toLowerCase();
+    if (!ISO_639_1.test(code)) {
+        throw new PlatformApiError(`'${field}' alanındaki '${input}' geçerli bir dil kodu değil. Platform ISO 639-1 küçük harf iki harfli kod tutar ('tr', 'en', 'de'); bölgeli değer ('tr-TR') kabul edilir ve indirgenir ama '${input}' indirgendiğinde de iki harfe inmiyor.`, 400);
+    }
+    return code === input ? { code } : { code, note: `${field}: '${input}' → '${code}' (platform ISO 639-1 küçük harf kod tutar, bölge bilgisi saklanmaz).` };
+}
+export function normalizeLanguageCodes(inputs, field) {
+    const results = inputs.map(input => normalizeLanguageCode(input, field));
+    return {
+        codes: results.map(result => result.code),
+        notes: results.flatMap(result => result.note ? [result.note] : [])
+    };
+}
+export const DATA_LANGUAGE_HEADER = 'X-Data-Language';
+/**
+ * Yürütme araçlarının `language` parametresini backend'in istek dili başlığına çevirir. Başlık
+ * gönderilmezse backend `Accept-Language`'a, o da yoksa projenin varsayılan diline düşer
+ * (sözleşme D3) — yani parametreyi atlamak bir hata değil, "projenin varsayılanı" demektir.
+ */
+export function languageHeader(input, notes) {
+    if (input === undefined)
+        return {};
+    const { code, note } = normalizeLanguageCode(input, 'language');
+    if (note)
+        notes.push(note);
+    return { [DATA_LANGUAGE_HEADER]: code };
+}