@appaflytech/zeyrek-ai-mcp 0.0.7 → 0.0.9

package/dist/knowledge/rules.js

@@ -4,6 +4,7 @@ import { reservedTenantTables } from './reservedTables.js';
 import { headersAccessNames, isHeadersAccessGuarded } from './flowGuards.js';
 import { callsItself, functionCallRefs, isValidParameterName, mentionsAwait, nameProblem, sourceOf, callPrefix } from './functionGuards.js';
 import { backendPolicyRules } from './backendConstraints.js';
+import { themePolicyRules } from './themeRules.js';
 const terminalStepTypes = new Set(['response', 'convert', 'revert']);
 const DESCRIPTION_EXEMPT_STEPS = new Set(['start']);
 const stepKindMatrix = {
@@ -125,7 +126,7 @@ const conditionRuleIdPattern = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}
 // Runtime.svelte'de HAM verilir (`argument: step.args`), yani bu alanlarda ifade değerlendirilmez.
 const flowLiteralTextFields = new Map([
     ['alert', ['message', 'description']],
-    ['confirm', ['message']]
+    ['confirm', ['message', 'title', 'confirmText', 'cancelText']]
 ]);
 const flowExpressionLooking = /\$\{|\b(?:Steps|Page|Row|Widget|LocalStorage|state|self|item|event|error|cookie)\s*(?:\?\.|\.|\[)/;
 // Barındırıcıya özel tipler (`navigate` web'de, `confirm`/`download` mobilde register edilmez)
@@ -235,7 +236,7 @@ export function flowExpressionSites(step) {
     }
     return sites;
 }
-const writeOperations = new Set(['create', 'update', 'delete', 'upsert']);
+const writeOperations = new Set(['create', 'update', 'delete', 'upsert', 'bulk-create', 'bulk-update', 'bulk-delete']);
 /** Built-in `roles` entity'si ve slug alanı — SeedData her projeye SABİT id'lerle açar (EntityConstants.cs). */
 const rolesEntityId = '01917ede-88a2-72ea-8397-2619e5d5dca0';
 const rolesSlugFieldId = '0199c35d-cfc8-77d4-9c20-29b857153147';
@@ -346,6 +347,38 @@ function unreadSelectFields(step, steps) {
         .map(field => String(field.fieldSlug ?? field.slug ?? ''))
         .filter(slug => slug.length > 0 && !new RegExp(`\\b${escapeForPattern(slug)}\\b`).test(usage));
 }
+const SQL_COMMENT_PATTERN = /--[^\n]*|\/\*[\s\S]*?\*\//g;
+const QUERY_PARAMETER_TOKEN = String.raw `(?:\{\{\s*([A-Za-z_]\w*)\s*\}\}|(?<![:@\w'])@([A-Za-z_]\w*))(?:\s*::\s*\w+)*`;
+const EMPTY_STRING_COMPARISON_PATTERN = new RegExp(`${QUERY_PARAMETER_TOKEN}\\s*=\\s*(?<!')''(?!')|(?<!')''\\s*=\\s*${QUERY_PARAMETER_TOKEN}`, 'g');
+/**
+ * `rawQuery`'de bir parametreyi boş string'le EŞİTLİK üzerinden karşılaştıran yerlerin parametre
+ * adları (`@p = ''`, `@p::text = ''`, `'' = {{p}}`). Yorumlar önce atılır — platform da yorum
+ * içindeki belirteci parametre saymıyor. Yalnız `=` aranır: `@p <> ''` boş değerde NULL (yanlış)
+ * verir ve "doluysa" niyetiyle yazıldığında sonuç zaten doğrudur.
+ */
+function emptyStringComparisons(rawQuery) {
+    if (typeof rawQuery !== 'string')
+        return [];
+    const names = new Set();
+    for (const match of rawQuery.replace(SQL_COMMENT_PATTERN, ' ').matchAll(EMPTY_STRING_COMPARISON_PATTERN)) {
+        const name = match[1] ?? match[2] ?? match[3] ?? match[4];
+        if (name !== undefined)
+            names.add(name);
+    }
+    return [...names];
+}
+/** `rawQuery`'nin başvurduğu parametre adları (`@p`, `{{p}}`), yorumlar atılarak; ilk görülme sırasıyla. */
+export function rawQueryParameterNames(rawQuery) {
+    if (typeof rawQuery !== 'string')
+        return [];
+    const names = new Set();
+    for (const match of rawQuery.replace(SQL_COMMENT_PATTERN, ' ').matchAll(new RegExp(QUERY_PARAMETER_TOKEN, 'g'))) {
+        const name = match[1] ?? match[2];
+        if (name !== undefined)
+            names.add(name);
+    }
+    return [...names];
+}
 const isRecord = (value) => Boolean(value) && typeof value === 'object' && !Array.isArray(value);
 const functionsGuide = 'ngapps://guides/functions';
 export const policyRules = [
@@ -418,7 +451,7 @@ export const policyRules = [
         id: 'MS-016',
         module: 'microservice',
         appliesTo: ['create', 'update', 'preview'],
-        sourceRef: "İK koşusu M-3: operation 'upsert' olan uçta expression'la yazılan alan UPDATE yolunda yeniden değerlendiriliyor; Incremental sicil alanı EMP-0005 → EMP-0006 diye sessizce değişti. Platformda alan bazlı writeOn (create|update|always) YOK — bu kural o gelene kadarki tek uyarı",
+        sourceRef: "İK koşusu M-3: operation 'upsert' olan uçta expression'la yazılan alan UPDATE yolunda yeniden değerlendiriliyor; Incremental sicil alanı EMP-0005 → EMP-0006 diye sessizce değişti. Alan bazlı writeOn (create|update|always) 2026-09-04'te eklendi (B-12), bu yüzden kural artık çözümü söyler ve writeOn:'create' taşıyan alanda susar",
         check: definition => {
             const parameters = (definition.sourceParameters ?? {});
             if (String(parameters.operation ?? '') !== 'upsert')
@@ -426,13 +459,14 @@ export const policyRules = [
             const generated = asArray(parameters.fields)
                 .map(entry => entry)
                 .filter(field => String(field.source ?? '') === 'expression')
+                .filter(field => String(field.writeOn ?? 'always').toLowerCase() !== 'create')
                 .map(field => String(field.alias ?? field.fieldId ?? '?'));
             if (generated.length === 0)
                 return [];
             return [{
                     ruleId: 'MS-016',
                     severity: 'warn',
-                    message: `upsert ucunda expression kaynaklı alan var (${generated.join(', ')}): upsert UPDATE yolunda da bu ifadeyi yeniden değerlendirir, yani sicil/kod gibi ÜRETİLEN bir değer güncellemede sessizce değişir. Alanı yalnız oluşturmada yazmak istiyorsanız create ve update için iki ayrı uç kurun — platformda alan bazlı 'yalnız create'te yaz' ifadesi henüz yok.`,
+                    message: `upsert ucunda expression kaynaklı alan var (${generated.join(', ')}): upsert UPDATE yolunda da bu ifadeyi yeniden değerlendirir, yani sicil/kod gibi ÜRETİLEN bir değer güncellemede sessizce değişir. Alan yalnız oluşturmada yazılacaksa fields[] öğesine writeOn: 'create' koyun — upsert'in UPDATE dalı o alanı satıra hiç koymaz ve bu uyarı susar. writeOn yalnız operation:'upsert' ucunda geçerlidir (MS-017) ve bir 'kısmi güncelleme' bayrağı DEĞİLDİR: listelenen alan gövdede gelmezse yine NULL yazılır.`,
                     guide: 'ngapps://guides/microservice'
                 }];
         }
@@ -451,6 +485,23 @@ export const policyRules = [
                     guide: 'ngapps://guides/microservice'
                 }]
     },
+    {
+        id: 'QRY-007',
+        module: 'query',
+        appliesTo: ['create', 'update', 'preview'],
+        sourceRef: "2026-09-15 bulgusu: pano sorgusu '(@tech = '' OR w.technician_id::text = @tech)' ile 0 satır döndü, hata yok. Kök neden Query.PrepareQueryParameters / NormalizePreviewParameters: boş ya da yalnız boşluktan oluşan değer NULL bağlanır, bu yüzden '@p = ''' hiçbir değerle doğru olmaz. Bulgunun 'dokunulmamış dropdown null gönderiyor' teşhisi yanlıştı — '' gönderen form da aynı sonucu alır. warn: kalıp hatalı ama yazmayı durdurmak gerekmiyor",
+        check: definition => {
+            const names = emptyStringComparisons(definition.rawQuery);
+            if (names.length === 0)
+                return [];
+            return [{
+                    ruleId: 'QRY-007',
+                    severity: 'warn',
+                    message: `rawQuery parametreyi boş string'le karşılaştırıyor (${names.map(name => `@${name} = ''`).join(', ')}): platform boş ya da yalnız boşluktan oluşan parametre değerini NULL bağlar, NULL = '' hiçbir zaman doğru olmaz ve 'filtre boşsa hepsini getir' dalı ASLA çalışmaz — filtre boş geldiğinde sorgu hatasız 0 satır döner. Değerin form bileşeninden null ya da '' gelmesi fark etmez. Şöyle yazın: (@${names[0]} IS NULL OR kolon::text = @${names[0]}).`,
+                    guide: 'ngapps://guides/microservice'
+                }];
+        }
+    },
     {
         id: 'MS-018',
         module: 'microservice',
@@ -2215,7 +2266,7 @@ export const policyRules = [
         id: 'FLOW-022',
         module: 'flow',
         appliesTo: ['create', 'update'],
-        sourceRef: "alert.ts `const { message, alertType, description } = task.argument` → toast.error(message, { description }) / dialog.alert(message); confirm.ts `dialog.confirm(task.argument.message)`. Argüman Runtime.svelte'de HAM geçer (`argument: step.args`) — bu alanlarda hiçbir ifade değerlendirilmez, yazılan metin ekranda harfi harfine görünür (2026-09-06·2 koşusu S-13'ün ikinci turu: rehber hata mesajını göstermek için alert adımını öneriyordu)",
+        sourceRef: "alert.ts `const { message, alertType, description } = task.argument` → toast.error(message, { description }) / dialog.alert(message); confirm.ts `dialog.confirm(message, { title, confirmText, cancelText })` (boş çerçeve metni dialog.functions.ts resolveDialogFrame'de sabit metne düşer). Argüman Runtime.svelte'de HAM geçer (`argument: step.args`) — bu alanlarda hiçbir ifade değerlendirilmez, yazılan metin ekranda harfi harfine görünür (2026-09-06·2 koşusu S-13'ün ikinci turu: rehber hata mesajını göstermek için alert adımını öneriyordu)",
         check: definition => flowAllSteps(definition)
             .flatMap((step) => {
             const type = String(step.type ?? '');
@@ -2666,7 +2717,7 @@ export const policyRules = [
         id: 'WF-021',
         module: 'workflow',
         appliesTo: ['create', 'update'],
-        sourceRef: "IStep.cs:74-86 bağlanmamış/eksik fail dalını global-error dalına yönlendirir; ikisi de yoksa ActivityContext.cs:176-183 ham exception mesajını 500 gövdesine basar. automation'da 'response' adımı yasak (stepKindMatrix) olduğu için gateway bu tipte enjeksiyon yapmaz — errorPath.ts",
+        sourceRef: "IStep.cs:88-104 bağlanmamış/eksik fail dalını global-error dalına yönlendirir; ikisi de yoksa canlıda WorkflowStepFailedException fırlatılır (2026-09-16), önizlemede ActivityContext.SetUnhandledError 500 gövdesi kurar. automation'da 'response' adımı yasak (stepKindMatrix) olduğu için gateway bu tipte enjeksiyon yapmaz — errorPath.ts",
         check: (definition, context) => {
             if (context.workflowKind !== 'automation')
                 return [];
@@ -2738,6 +2789,7 @@ export const policyRules = [
     },
     // Backend doğrulayıcılarının aynası (ENT-015…018, MS-017, WF-026, QRY/VIEW/DTO/ROW/DS/PRJ/TR/FLD/FILE/EXT):
     // tek liste `backendConstraints.ts`'te durur, buradan yalnız politika motoruna katılır.
+    ...themePolicyRules,
     ...backendPolicyRules()
 ];
 /**
@@ -2821,3 +2873,58 @@ export async function microfunctionStepFindings(platform, project, environment,
     }
     return applyPolicyMode(platform.config, findings, policyOverride);
 }
+const partialWriteOperations = new Set(['create', 'update', 'upsert']);
+const inputReferencePattern = /\binput\.([A-Za-z_$][\w$]*)/g;
+function inputReferencesOf(rule) {
+    return asArray(rule.fields)
+        .filter((field) => Boolean(field) && typeof field === 'object')
+        .flatMap(field => [...String(field.value ?? '').matchAll(inputReferencePattern)].map(match => match[1]))
+        .filter((name) => typeof name === 'string');
+}
+/**
+ * WF-031 — yazma adımı, akışın giriş DTO'sunda OLMAYAN bir `input.x` alanını yazıyorsa uyarır.
+ * Böyle bir ifade çalışma anında `undefined` döner, `Parse` onu `null` yapar ve platform kolonu
+ * NULL yazar: satırdaki mevcut değer silinir, yanıt yine 200'dür (risk uygulaması Kanban taşıma
+ * bulgusu, 2026-09-15 — `{ id, status }` gövdesi `title`/`owner_id`/`due_date`'i sildi).
+ *
+ * Kural yalnız DTO'da HİÇ olmayan alanı sayar: "DTO'da var ama çağıran göndermedi" vakası
+ * tanımdan görülemez, onu rehber anlatır. DTO şeması okunamazsa (404/erişim) kural susar —
+ * bir okuma hatası yazma çağrısını engellememelidir.
+ */
+export async function undefinedInputFieldFindings(platform, project, environment, definition, kind, policyOverride = false) {
+    if (platform.config.policyMode === 'off')
+        return [];
+    const body = workflowBody(definition, kind);
+    if (!hasText(body.parameterDtoId))
+        return [];
+    const candidates = workflowSteps(body)
+        .filter(step => step.type === 'table' && step.rule)
+        .filter(step => partialWriteOperations.has(String(step.rule.operation ?? '').toLowerCase()))
+        .map(step => ({ step, references: [...new Set(inputReferencesOf(step.rule))] }))
+        .filter(candidate => candidate.references.length > 0);
+    if (candidates.length === 0)
+        return [];
+    let dtoFieldNames;
+    try {
+        const payload = await platform.tenant('GET', project, `/datatransferobjects/${String(body.parameterDtoId)}/scheme`, { environment });
+        const items = asArray(payload?.data ?? payload).filter((item) => Boolean(item) && typeof item === 'object');
+        dtoFieldNames = new Set(items.map(item => String(item.name ?? '')));
+    }
+    catch (error) {
+        if (error instanceof PlatformApiError)
+            return [];
+        throw error;
+    }
+    const findings = candidates.flatMap(({ step, references }) => {
+        const missing = references.filter(name => !dtoFieldNames.has(name));
+        return missing.length > 0
+            ? [{
+                    ruleId: 'WF-031',
+                    severity: 'warn',
+                    message: `'${stepLabel(step)}' adımı ${missing.map(name => `input.${name}`).join(', ')} alanlarını yazıyor ama akışın giriş DTO'sunda bu alanlar YOK: ifade undefined döner, platform kolonu NULL yazar ve satırdaki mevcut değer SİLİNİR (yanıt yine 200). Yazma adımında SET listesi fields[]'tir, gövde değil — 'göndermediğim alan değişmez' (REST PATCH) sezgisi burada geçmez. İki doğru çıkış: (1) adımı EYLEM BAŞINA daraltın, fields[] yalnız bu eylemin gerçekten yazdığı alanları listelesin (kanban taşıma: yalnız status); (2) alanı DTO'ya ekleyin VE çağıranın her istekte gönderdiğinden emin olun — DTO'ya eklemek yalnız izin verir, göndermeyi garanti etmez. Alan kümesi ancak çağrı anında belliyse akışta oku-birleştir: önce table get, sonra "typeof input.x !== 'undefined' && input.x !== null ? input.x : read_row.data.x" (bedeli fazladan okuma ve son-yazan-kazanır).`,
+                    guide: 'ngapps://guides/workflow'
+                }]
+            : [];
+    });
+    return applyPolicyMode(platform.config, findings, policyOverride);
+}

package/dist/knowledge/styleResolve.js

@@ -22,6 +22,12 @@
  * `TYPED_STYLE_COMPONENTS` kaydına eklenir — başka hiçbir yer değişmez.
  */
 export const STYLE_PRESET_KEY = '$preset';
+/**
+ * Düğümün hangi BİLEŞEN PRESETİ versiyonundan kurulduğunu anan işaret (frontend
+ * `style-presets.ts` kopyası). Kaskad katmanı değildir: versiyonun prop'ları düğüm oluşturulurken
+ * zaten yazılır, bu anahtar yalnız seçicinin hangi satırı seçili göstereceğini söyler.
+ */
+export const STYLE_COMPONENT_PRESET_KEY = '$componentPreset';
 /**
  * Satır yüksekliği ÜÇ yazımı da kabul eder: oran (1.4), yüzde ('140%') ve CSS
  * uzunluğu ('24px'). Çıplak sayı ikircikli tek durumdur — eski panel YÜZDE
@@ -53,17 +59,24 @@ export const deepMergeStyle = (base, override) => {
 };
 export const resolveNodeStyleLayers = (style, source, nodeType) => {
     const styleObject = isPlainObject(style) ? style : undefined;
-    const { [STYLE_PRESET_KEY]: presetName, ...own } = styleObject ?? {};
+    // İKİ sihirli anahtar da düşer. `$componentPreset` bir kaskad katmanı DEĞİLDİR: bileşen preseti
+    // versiyonu düğüm kurulurken prop'lara materialize edilir, bu anahtar yalnız "hangi versiyondan
+    // geldi"yi anar (`style-presets.ts:180-184`, 2026-09-07). Ayıklanmazsa emotion onu çöp bir CSS
+    // kuralına çevirir ve `resolvedStyle` ajana stil diye '$componentPreset: V1' gösterir (S-2).
+    const { [STYLE_PRESET_KEY]: presetName, [STYLE_COMPONENT_PRESET_KEY]: componentPreset, ...own } = styleObject ?? {};
     const componentStyle = nodeType && isPlainObject(source?.componentStyles?.[nodeType]) ? source.componentStyles[nodeType] : undefined;
     const preset = typeof presetName === 'string' && isPlainObject(source?.presets?.[presetName]) ? source.presets[presetName] : undefined;
     let theme;
     if (componentStyle || preset) {
         theme = deepMergeStyle(componentStyle ?? {}, preset ?? {});
+        // Preset'in KENDİSİ de işaret taşıyabilir: tema JSON'u elle düzenlenmişse.
         delete theme[STYLE_PRESET_KEY];
+        delete theme[STYLE_COMPONENT_PRESET_KEY];
     }
+    const version = typeof componentPreset === 'string' && componentPreset ? componentPreset : undefined;
     if (!styleObject && typeof style === 'string' && style)
-        return { theme, own: style };
-    return { theme, own: Object.keys(own).length ? own : undefined };
+        return { theme, own: style, componentPreset: version };
+    return { theme, own: Object.keys(own).length ? own : undefined, componentPreset: version };
 };
 export const resolveNodeStyle = (style, source, nodeType) => {
     if (!isPlainObject(style) && style !== undefined && style !== null)
@@ -308,6 +321,23 @@ export const applyLegacyTextProps = (input, root) => {
                 : `var(${STATUS_COLOR_VARS[color] ?? STATUS_COLOR_VARS.primary})`;
     }
 };
+/* ---- button: emekli kind:'custom' takma adı (frontend `button-style-logic.ts` kopyası) ---- */
+export const BUTTON_LEGACY_CUSTOM_COLOR_VAR = '--ng-btn-custom-color';
+/**
+ * `button`'ın EMEKLİ `kind: 'custom'` + `customColor` ikilisi (Dalga 4, 2026-09-14) kayıtlı
+ * sayfalarda aynen çizilir: Surface › Background BOŞSA köke eski `--ng-btn-custom-color`
+ * değişkeni yazılır, bileşenin `.ng-button--custom` bloğu okur. Bilerek `background` DEĞİL
+ * değişken: eski custom outline/text butonlar zemin değil kenarlık/yazı rengi alıyordu.
+ */
+export const applyLegacyButtonProps = (input, root) => {
+    if (root.background !== undefined)
+        return;
+    if (input.kind !== 'custom')
+        return;
+    if (!isRenderableColorLike(input.customColor))
+        return;
+    root[BUTTON_LEGACY_CUSTOM_COLOR_VAR] = String(input.customColor).trim();
+};
 /* ---- container: başlık bölgesi (frontend `container-style-logic.ts` kopyası) ---- */
 const CONTAINER_HEADER_SELECTOR = '&__header';
 const CONTAINER_TITLE_SELECTOR = '&__title';
@@ -419,6 +449,20 @@ export const TYPED_STYLE_COMPONENTS = {
         // Taşma hedefi olmayan komponentte contentOverflow ölü kural üretirdi.
         omit: { surfaceStyle: ['contentOverflow'] }
     },
+    button: {
+        groups: ['surfaceStyle'],
+        ext: { extra: applyLegacyButtonProps },
+        // `kind` emekli değil; takma ad yalnız eski 'custom' değerini okur.
+        legacyProps: ['kind', 'customColor'],
+        // Kaydırılan içeriği yok; taşma alanı ölü kural üretirdi.
+        omit: { surfaceStyle: ['contentOverflow'] }
+    },
+    form: {
+        // Çerçeve <form> KÖKÜNDE: yüzey köke, taşma gövdeye (S-19, 2026-09-15).
+        // Genel düğüm yüzeyi yolu değeri kökün dışındaki kutuya yazıp ikinci çerçeve çiziyordu.
+        groups: ['surfaceStyle'],
+        ext: { overflowTarget: '&__body' }
+    },
     icon: {
         // Yalnız hover: surface çipin (chipShape/chipColor), typography da boyutun
         // (size) ve rengin (color) çift kanalı olurdu — görsel kararlar semantik
@@ -439,7 +483,6 @@ export const TYPED_STYLE_COMPONENTS = {
 export const NODE_SURFACE_TYPES = new Set([
     'table',
     'datatable',
-    'form',
     'collapsible-container',
     'drawer',
     'modal',
@@ -511,12 +554,16 @@ export function resolveNodeStyleReport(node, source) {
     const ownStyle = rawProp(props, 'style');
     const config = node.type ? TYPED_STYLE_COMPONENTS[node.type] : undefined;
     const presetName = isPlainObject(ownStyle) ? ownStyle[STYLE_PRESET_KEY] : undefined;
+    const versionName = isPlainObject(ownStyle) ? ownStyle[STYLE_COMPONENT_PRESET_KEY] : undefined;
     const typedGroups = config ? config.groups.filter(name => isPlainObject(rawProp(props, name))) : [];
+    const magicKeys = [STYLE_PRESET_KEY, STYLE_COMPONENT_PRESET_KEY];
     const layers = {
         typedGroups,
         componentStyle: Boolean(node.type && isPlainObject(source?.componentStyles?.[node.type])),
         preset: typeof presetName === 'string' && presetName ? presetName : null,
-        own: isPlainObject(ownStyle) ? Object.keys(ownStyle).filter(key => key !== STYLE_PRESET_KEY).length > 0 : Boolean(ownStyle)
+        componentPreset: typeof versionName === 'string' && versionName ? versionName : null,
+        // İşaretler stil DEĞİLDİR: yalnız onları taşıyan düğüm "kendi stili var" sayılmamalı.
+        own: isPlainObject(ownStyle) ? Object.keys(ownStyle).filter(key => !magicKeys.includes(key)).length > 0 : Boolean(ownStyle)
     };
     if (!config) {
         // Kayıtsız tip: eski birleşik kaskad. Kap tiplerinde tipli yüzey grubu