@appaflytech/zeyrek-ai-mcp 0.0.2 → 0.0.4

package/dist/knowledge/componentEvents.js

@@ -21,12 +21,53 @@ export const componentEventContracts = {
     'qm-card': { click: NO_DATA },
     form: { mount: NO_DATA, submit: NO_DATA },
     container: { mount: NO_DATA },
+    aibox: { mount: NO_DATA },
+    box: { mount: NO_DATA },
+    'box-section': { mount: NO_DATA },
+    divider: {},
+    spacer: {},
+    popover: {
+        open: { payload: { isOpen: 'boolean (true)' }, reads: 'setter: self.isOpen da yazılır — akış paneli isOpen prop’unu değiştirerek de açıp kapatabilir' },
+        close: { payload: { isOpen: 'boolean (false)' }, reads: 'setter: self.isOpen da yazılır' }
+    },
+    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' }
+    },
+    filterbuilder: {
+        mount: NO_DATA,
+        change: {
+            payload: { value: 'FilterGroup (iç içe and/or kural ağacı)', jexl: 'string (aynı ağacın hazır jexl ifadesi)' },
+            reads: "setter yalnız `value`yi self’e yazar; `jexl` YALNIZ event.data’dadır (params) — sorguya bağlayacağın alan odur"
+        }
+    },
+    comments: {
+        mount: NO_DATA,
+        submit: {
+            payload: { text: 'string', parentId: "string (yanıtsa üst yorumun id’si, kök yorumda '')", mentions: 'string[] (metinden çözülmüş @kişi listesi)', author: 'string (currentUser)' },
+            reads: 'Komponent yorumu ANINDA iyimser olarak listeye ekler (bekleyen katman); kalıcılık akışın işidir — rows tazelenmezse bekleyen satır bir sonraki içerik değişiminde kaybolur'
+        },
+        like: { payload: { id: 'string', liked: 'boolean (yeni durum)', author: 'string' }, reads: 'beğeni de iyimserdir; sayaç rows tazelenene kadar yerel' },
+        edit: { payload: { id: 'string', text: 'string (yeni metin)', author: 'string' } },
+        delete: { payload: { id: 'string', author: 'string' }, reads: 'satır listeden hemen çıkarılır; uca yazmak akışın işidir' }
+    },
     'auth-layout': { mount: NO_DATA, primaryClick: NO_DATA, secondaryClick: NO_DATA },
     layout: { mount: NO_DATA, logout: NO_DATA },
+    'layout-shell': {
+        mount: NO_DATA,
+        // LayoutShell.svelte toggle(): dispatch('emit', { name, data, params }) — `params` VERİLDİĞİ
+        // için bu olay istisnadır: sidebarOpen hem self.sidebarOpen'dan hem event.data'dan okunur.
+        toggle: { payload: { sidebarOpen: 'boolean (panelin YENİ durumu)' }, reads: 'self.sidebarOpen; params verildiği için event.data.sidebarOpen de dolar' }
+    },
+    '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 },
-    numberinput: { mount: NO_DATA, change: valueChange('number'), 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 },
     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') },
@@ -70,8 +111,11 @@ export const componentEventContracts = {
     video: { mount: NO_DATA, click: NO_DATA, play: NO_DATA, pause: NO_DATA, ended: NO_DATA },
     // — 2026-08-25 eşleme turu: ng-apps-ui'da olay YAYAN ama burada kaydı olmayan komponentler.
     // Yükler kaynaktaki dispatch('emit', { name, data }) / machine.onEmit(id, { event, data })
-    // çağrılarından birebir çıkarıldı. Olay yaymayan komponentler (badge · breadcrumb · jsonviewer ·
-    // notification · progress · qrcode · slot · tags · text) bilinçli olarak kayıtsızdır.
+    // çağrılarından birebir çıkarıldı. Olay yaymayan komponentler (breadcrumb · qrcode · slot · tags ·
+    // text) bilinçli olarak kayıtsızdır. `notification` bu listede
+    // YANLIŞLIKLA yer almıştı — Notification.svelte hem timeout'ta hem kapatma tıklamasında
+    // dispatch('emit', { name:'toggled', data:{isHidden:true}, setter:true }) çağırıyor (düzeltme
+    // 2026-08-25c, `docs/20-komponent-bilgi-katmani.md` §9).
     autocomplete: {
         mount: NO_DATA,
         change: valueChange('string (YAZILAN metin — option değeri değil)'),
@@ -82,6 +126,8 @@ export const componentEventContracts = {
         blur: NO_DATA
     },
     avatar: { click: NO_DATA },
+    badge: { click: NO_DATA },
+    icon: { click: NO_DATA },
     'breadcrumb-title': {
         mount: NO_DATA,
         clickItem: { payload: { currentItem: '{ text, flow, isHidden } — tıklanan iz öğesi' } },
@@ -103,22 +149,46 @@ export const componentEventContracts = {
         refresh: NO_DATA,
         retry: NO_DATA
     },
-    checkboxgroup: { mount: NO_DATA, change: valueChange('string[] (seçili değerler)') },
+    checkboxgroup: { mount: NO_DATA, change: valueChange('string[] (seçili değerler)'), focus: NO_DATA, blur: NO_DATA },
     emptystate: { actionClick: { payload: { text: 'string (aksiyonun metni)', index: 'number' }, reads: "aksiyonun kendi flow'u zaten doğrudan çalışır" } },
-    iframe: { mount: NO_DATA },
+    iframe: { mount: NO_DATA, load: NO_DATA, error: NO_DATA },
+    jsonviewer: {
+        nodeClick: {
+            payload: {
+                path: "string (nokta/köşeli-parantez yolu — 'user.roles[0].name'; kökte boş)",
+                key: 'string (düğümün anahtarı; dizi öğesinde indeks)',
+                kind: "'object' | 'array' | 'string' | 'number' | 'boolean' | 'null'",
+                value: 'düğümün ham değeri (object/array için alt ağacın tamamı)'
+            }
+        },
+        copy: {
+            payload: {
+                path: "string (kopyalanan düğümün yolu; araç çubuğundan TÜMÜNÜ kopyalamada boş + kind:'root')",
+                kind: "'root' | 'object' | 'array' | 'string' | 'number' | 'boolean' | 'null'",
+                value: 'kopyalanan değer (tümünü kopyalamada normalize edilmiş TÜM veri)'
+            }
+        }
+    },
     'language-selector': { change: { payload: { value: 'string (dil kodu)' }, reads: 'runtime ayrıca machine.setLanguage(value) çağırır' } },
+    notification: { toggled: { payload: { isHidden: 'boolean' } } },
     otpinput: {
         mount: NO_DATA,
         change: valueChange('string (birleşik kod)'),
-        complete: { payload: { value: 'string (tüm haneler dolduğunda)' } }
+        complete: { payload: { value: 'string (tüm haneler dolduğunda)' } },
+        resend: NO_DATA,
+        focus: NO_DATA,
+        blur: NO_DATA
     },
     pagination: { mount: NO_DATA, change: { payload: { offset: 'number', limit: 'number' }, reads: 'self.offset · self.limit (sorguyu bunlara bağla)' } },
-    rating: { mount: NO_DATA, change: valueChange('number (0..max; allowHalf ile yarım)') },
+    progress: { complete: NO_DATA },
+    rating: { mount: NO_DATA, change: valueChange('number (0..max; allowHalf ile yarım)'), focus: NO_DATA, blur: NO_DATA },
     result: { actionClick: { payload: { text: 'string (aksiyonun metni)', index: 'number' }, reads: "aksiyonun kendi flow'u zaten doğrudan çalışır" } },
     slider: {
         mount: NO_DATA,
         change: valueChange('number (sürüklerken sürekli)'),
-        changed: valueChange('number (tutamak bırakıldığında — pahalı akışı buna bağla)')
+        changed: valueChange('number (tutamak bırakıldığında — pahalı akışı buna bağla)'),
+        focus: NO_DATA,
+        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') },
@@ -127,7 +197,7 @@ export const componentEventContracts = {
         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 '')") },
+    timepicker: { mount: NO_DATA, change: valueChange("string 'HH:mm' (temizlenince '')"), focus: NO_DATA, blur: NO_DATA },
     toast: {
         open: NO_DATA,
         close: NO_DATA,
@@ -144,12 +214,84 @@ export const componentEventContracts = {
         searchResultClick: { payload: {}, reads: "tıklanan kayıt yalnız emit params'ında (item) taşınır ve ifade kapsamına GİRMEZ — kayıt id'si gerekiyorsa aramayı kendi komponentinle kur" }
     },
     'qm-sidebar': { mount: NO_DATA, collapsed: { payload: {}, reads: "daralma durumu emit'in value alanındadır; motor yalnız data'yı prop'a yazdığı için akışa ULAŞMAZ" } },
-    'qm-content': { mount: NO_DATA }
+    'qm-content': { mount: NO_DATA },
+    // — 2026-08-27 eşleme turu: components-new kuşağı (docs/20-komponent-bilgi-katmani.md §10).
+    // Bu komponentler emit'e params DA geçirir, dolayısıyla akışta event.data DOLU gelir
+    // (eski kuşakta boştu). kanban ve eventcalendar üst düzey data'yı BİLİNÇLİ göndermez —
+    // yükleri self'e hiç yazılmaz, yalnız event.data ile okunur. detailview'ün TEK olayı mount'tur
+    // (tıklama yaymaz — tıklanabilirlik gerekiyorsa kapsayıcıya sarılır).
+    detailview: { mount: NO_DATA },
+    eventcalendar: {
+        mount: NO_DATA,
+        monthChange: {
+            payload: { month: 'number (1-TABANLI)', year: 'number' },
+            reads: "yük self'e YAZILMAZ — event.data ile oku; gezinme okları/Bugün ile her görünümde yayılır, ilk mount'ta yayılmaz"
+        },
+        viewChange: { payload: { view: "'month' | 'week' | 'day'" }, reads: "self'e yazılmaz — event.data ile oku" },
+        dateClick: {
+            payload: { date: "string 'yyyy-MM-dd'" },
+            reads: "yalnız AY görünümünde ve isCreatable KAPALIYKEN; self'e yazılmaz — event.data ile oku"
+        },
+        eventCreate: {
+            payload: { start: "string (ay tıklaması: 'yyyy-MM-dd' · saat slotu: ISO)", end: 'string (slotta start+60dk)', allDay: 'boolean' },
+            reads: "self'e yazılmaz — event.data ile oku"
+        },
+        eventClick: {
+            payload: { id: 'string', title: 'string', row: 'kaynak satırın TAMAMI' },
+            reads: "self'e yazılmaz — event.data ile oku"
+        },
+        eventMove: {
+            payload: { id: 'string', row: 'kaynak satırın TAMAMI', start: 'string (ISO)', end: 'string (ISO)', previousStart: 'string (ISO)', previousEnd: 'string (ISO)' },
+            reads: "self'e yazılmaz — event.data ile oku; akış kalıcılaştırıp rows'u tazelemezse taşınan etkinlik geri döner"
+        }
+    },
+    importwizard: {
+        mount: NO_DATA,
+        complete: {
+            payload: {
+                rows: 'Record<string,string>[] (TEMİZ satırlar; değerler hep string)',
+                errors: 'Array<{ rowIndex, field, message, raw }>',
+                fileName: 'string',
+                total: 'number (temiz satır + hata KAYDI sayısı)'
+            },
+            reads: "hem self.rows/self.errors/… hem event.data dolu gelir (params kuşağı); satırları uca yazmak complete akışının işidir"
+        },
+        cancel: NO_DATA
+    },
+    kanban: {
+        mount: NO_DATA,
+        cardMove: {
+            payload: { id: 'string', row: 'kaynak satırın TAMAMI', from: 'string (kaynak kolon value)', to: 'string (hedef kolon value)' },
+            reads: "BİLİNÇLİ olarak self'e yazılmaz — event.data ile oku; yeni kolonu uca yaz + rows'u tazele, yoksa kart geri döner"
+        },
+        cardClick: { payload: { id: 'string', row: 'kaynak satırın TAMAMI' }, reads: "self'e yazılmaz — event.data ile oku" }
+    },
+    signature: {
+        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'
+        },
+        clear: { payload: {}, reads: "temizlemede önce change('') yayılır, sonra clear — değeri change'ten oku" }
+    },
+    stepper: {
+        mount: NO_DATA,
+        stepChange: {
+            payload: { currentStep: 'number (hedef adım, 0 tabanlı)', previous: 'number (önceki adım)' },
+            reads: "currentStep self'e yazılır; event.data da dolu gelir"
+        },
+        finish: { payload: { currentStep: 'number (son adımın indeksi)' }, reads: 'adımı değiştirmez; yalnız son adımda kapı açıkken yayılır' },
+        validationFail: {
+            payload: { currentStep: 'number (engellenen adım)', previous: 'number (aynı değer)' },
+            reads: 'YALNIZ İleri düğmesinden yayılır; engellenen başlık tıklaması sessiz kalır'
+        }
+    }
 };
 export const eventPayloadNote = "Olay yükü motorda komponentin KENDİ prop'una yazılır (FlowMachine.onEmit → setNode) ve akışta " +
     "self.<anahtar> ile okunur — payload anahtarları aynı zamanda o prop'ların adıdır. " +
-    "event.data komponent olaylarında BOŞ gelir: motor akışı emit'in params'ıyla başlatır ve " +
-    "event.data = params.data'dır (yalnız html actions/fireEvent bu yoldan doldurur). " +
+    "event.data ESKİ kuşak komponent olaylarında BOŞ gelir: motor akışı emit'in params'ıyla başlatır ve " +
+    "event.data = params.data'dır (html actions/fireEvent ile 2026-08-27 kuşağı — eventcalendar · " +
+    "importwizard · kanban · signature · stepper — bu yoldan doldurur; ayrım tekil sözleşme notlarında). " +
     "payload boşsa olay veri taşımaz; 'reads' verilmişse değer yükte değil komponentin başka bir prop'undadır. " +
     "self yerine value { type:'property', ref:{ source:'component', element:'<elementId>', property:'<prop>' } } de kullanılabilir. " +
     "payload alanı yoksa yük sözlüğe henüz işlenmemiştir; tahmin etmeyin.";

package/dist/knowledge/errorPath.js

@@ -0,0 +1,64 @@
+import { randomUUID } from 'node:crypto';
+const ERROR_STEP_NAME = 'gatewayOnError';
+const INJECTED_KINDS = new Set(['workflow', 'middleware']);
+function asSteps(value) {
+    return (Array.isArray(value) ? value : []).filter((step) => Boolean(step) && typeof step === 'object');
+}
+function availableName(steps) {
+    const used = new Set(steps.map(step => String(step.name ?? '')));
+    if (!used.has(ERROR_STEP_NAME))
+        return ERROR_STEP_NAME;
+    let suffix = 2;
+    while (used.has(`${ERROR_STEP_NAME}${suffix}`))
+        suffix += 1;
+    return `${ERROR_STEP_NAME}${suffix}`;
+}
+/**
+ * Global-error dalı yalnız START adımında aranır ve tek olmalıdır
+ * (WorkflowRuntimeCacheDto.cs:37-38, WorkflowService.cs:454-459 → HTTP 400). Bağlanmamış ya da
+ * hiç olmayan fail dalları bu dala kendiliğinden yönlendiği için (IStep.cs:74-86) fail dallarını
+ * ayrıca bağlamak gerekmez. Enjekte edilen response adımı global-error modunda ReturnDto'yu
+ * atladığı için (ResponseStep.cs:62-64) mevcut sözleşmeyi bozmaz. `automation` dışarıda: o tipte
+ * `response` adımı yasak ve tek terminal olan `revert` tetikleyen işlemi geri alır.
+ */
+export function ensureWorkflowErrorPath(definition, kind) {
+    if (!kind || !INJECTED_KINDS.has(kind) || !Array.isArray(definition.steps))
+        return [];
+    const steps = asSteps(definition.steps);
+    const startStep = steps.find(step => step.type === 'start');
+    if (!startStep)
+        return [];
+    // Start DIŞI bir adımda global-error dalı varsa dokunma: enjeksiyon start'a ikinci bir dal
+    // eklerdi ve WF-022 önce "2 adet 'global-error' dalı var … Tek dal bırakın" derdi — çağıranın
+    // hiç yazmadığı dalı suçlayan, yanlış onarıma çağıran bir bulgu. Dokunmayınca WF-022 yalnız
+    // gerçek hatayı ("dal start dışı adımda") bildirir.
+    if (steps.some(step => step !== startStep && (Array.isArray(step.branches) ? step.branches : []).some(branch => branch?.type === 'global-error')))
+        return [];
+    const branches = Array.isArray(startStep.branches) ? startStep.branches : [];
+    if (branches.some(branch => branch?.type === 'global-error' && branch.nextStepId))
+        return [];
+    const name = availableName(steps);
+    const errorStepId = randomUUID();
+    const unwired = branches.find(branch => branch?.type === 'global-error');
+    definition.steps.push({
+        id: errorStepId,
+        name,
+        type: 'response',
+        description: "Gateway'in eklediği hata yolu: akışın herhangi bir adımı patlarsa buraya düşer ve 500 ile { code, message } döner. Kendi hata gövdeni istiyorsan bu adımın bodyExpression'ını değiştir.",
+        caution: "Bu adımı gateway ekledi; silersen akışın hata yolu kaybolur ve patlayan adım istemciye ham hata döndürür.",
+        rule: {
+            stepType: 'response',
+            httpStatusCode: 500,
+            bodyExpression: '({ code: error.code, message: error.message })'
+        },
+        branches: []
+    });
+    if (unwired) {
+        unwired.nextStepId = errorStepId;
+    }
+    else {
+        branches.push({ id: randomUUID(), name: 'global-error', type: 'global-error', nextStepId: errorStepId });
+    }
+    startStep.branches = branches;
+    return [`hata yolu eklendi: start adımına 'global-error' dalı + '${name}' response adımı (500, { code, message }). Hata yolu olmayan akış patladığında platform ham exception mesajını 500 gövdesine basar; bu adım çıktıyı denetim altına alır. Kendi hata gövdenizi istiyorsanız bu adımın bodyExpression'ını değiştirin.`];
+}

package/dist/knowledge/normalize.js

@@ -1,4 +1,5 @@
 import { logStep } from '../observability/trace.js';
+import { ensureWorkflowErrorPath } from './errorPath.js';
 const SORT_DEFAULT = { name: 'sortField', type: 'sortType', source: 'query-string' };
 const LIMIT_DEFAULT = { name: 'limit', offset: 'offset', source: 'query-string' };
 function asArray(value) {
@@ -164,6 +165,7 @@ export function normalizeWorkflowDefinition(definition) {
     const fixes = [];
     const bodies = [definition, definition.automation];
     fillDtoBehaviors(definition, fixes);
+    fixes.push(...ensureWorkflowErrorPath(definition, definition.type));
     for (const body of bodies) {
         if (!body || typeof body !== 'object')
             continue;
@@ -588,17 +590,26 @@ export function clampBlockSizes(nodes, maxSizes) {
  * ajanın tahmin ettiği `h` bir üst SINIRA dönüşüyor, kartların içi kırpılmış görünüyordu
  * (ürün sahibi ekran görüntüsü, 2026-08-19: randevu sayfasında üç kartın da içi kesik).
  *
+ * Üçüncü değer `fill` ("kalanı doldur", 2026-08-28): yükseklik ne içerikten ne satır
+ * sayısından gelir, ebeveynin bıraktığı yerden gelir — ızgarada `height: 100%`, flex
+ * sütununda `flex: 1 1 auto`, flex satırında `align-self: stretch`. Tam ekran yerleşim
+ * kabuğunun (kök kap ekranı doldurur, yan menü tam boy, slot artan alan) tek kurucu
+ * parçası budur, bu yüzden burada **korunmalıdır**: auto'ya çevrilirse kabuk sessizce
+ * içeriğine çöker. `zeyrek-frontend`: `packages/ng-apps-screen-builder/src/flex-layout.ts`
+ * (`getFlexChildStyle`), `packages/ng-apps-ui/src/shared/render/render.functions.ts`.
+ *
  * Ajanın açıkça verdiği `appearance.heightType` korunur; katalogda bulunmayan tip auto sayılır —
  * platformun kendi varsayılanı odur ve `fixed` tahmininin bedeli kırpma, `auto` tahmininin
  * bedeli yalnız fazladan yükseklik.
  */
+const HEIGHT_TYPES = new Set(['auto', 'fixed', 'fill']);
 export function normalizeHeightTypes(nodes, autoHeights) {
     const stamped = [];
     for (const node of asObjects(nodes)) {
         const appearance = (node.appearance && typeof node.appearance === 'object' && !Array.isArray(node.appearance)
             ? node.appearance
             : {});
-        if (appearance.heightType !== 'auto' && appearance.heightType !== 'fixed') {
+        if (!HEIGHT_TYPES.has(String(appearance.heightType ?? ''))) {
             const heightType = autoHeights.get(String(node.type ?? '')) === false ? 'fixed' : 'auto';
             appearance.heightType = heightType;
             node.appearance = appearance;

package/dist/knowledge/outlines.js

@@ -6,6 +6,8 @@ export function workflowOutline(definition) {
         id: definition.id,
         slug: definition.slug,
         name: definition.name,
+        description: definition.description ?? null,
+        caution: definition.caution ?? null,
         type: definition.type,
         parameterDtoId: definition.parameterDtoId ?? null,
         returnDtoId: definition.returnDtoId ?? null,
@@ -13,6 +15,8 @@ export function workflowOutline(definition) {
         steps: asArray(definition.steps).map(step => ({
             id: step.id,
             name: step.name,
+            description: step.description ?? null,
+            caution: step.caution ?? null,
             type: step.type,
             branches: asArray(step.branches).map(branch => ({
                 name: branch.name,
@@ -30,6 +34,8 @@ export function microserviceOutline(definition) {
         id: definition.id,
         slug: definition.slug,
         name: definition.name,
+        description: definition.description ?? null,
+        caution: definition.caution ?? null,
         type: definition.type,
         httpMethod: definition.httpMethod,
         source: definition.source,
@@ -64,10 +70,11 @@ export function entityOutline(definition) {
             dbType: field.dbType,
             nullable: field.nullable,
             relationType: field.relationType ?? 'none',
-            relationId: field.relationId ?? null
+            relationId: field.relationId ?? null,
+            isLocalized: Boolean(field.isLocalized)
         })),
         view: 'outline',
-        hint: "Bir alanın tam gövdesi için view:'part', part:'fields[slug=<slug>]'; değişiklik için entity_patch."
+        hint: "Bir alanın tam gövdesi için view:'part', part:'fields[slug=<slug>]'; değişiklik için entity_patch. isLocalized alanlar için platform_guide('entity') §'Çoklu dilli alan'."
     };
 }
 const segmentPattern = /^(\w+)(?:\[(?:(\d+)|(\w+)=([^\]]+))\])?$/;

package/dist/knowledge/rules.js

@@ -1,5 +1,6 @@
 import { reservedTenantTables } from './reservedTables.js';
 const terminalStepTypes = new Set(['response', 'convert', 'revert', 'end']);
+const DESCRIPTION_EXEMPT_STEPS = new Set(['start', 'end']);
 const stepKindMatrix = {
     start: ['workflow', 'automation', 'middleware'],
     condition: ['workflow', 'automation', 'middleware'],
@@ -34,9 +35,41 @@ function workflowBody(definition, kind) {
 function workflowSteps(definition) {
     return asArray(definition.steps).filter((step) => Boolean(step) && typeof step === 'object');
 }
+function hasText(value) {
+    return typeof value === 'string' && value.trim() !== '';
+}
 function stepLabel(step) {
     return step.name || step.type || step.id || '?';
 }
+/**
+ * Start'tan başlayıp `global-error` dalları HARİÇ tüm dalları izleyerek erişilen adımlar.
+ * Gateway her `workflow`/`middleware` tanımına global-error dalının ucunda bir `response` adımı
+ * enjekte ettiği için (`errorPath.ts`, normalize evaluatePolicy'den ÖNCE koşar) "hiç response
+ * adımı var mı?" sorusu artık her zaman evet; anlamlı olan soru "BAŞARILI çağrıya bir şey
+ * dönüyor mu?" — o da yalnız bu küme üzerinden yanıtlanabilir.
+ */
+function successPathSteps(steps) {
+    const start = steps.find(step => step.type === 'start');
+    if (!start)
+        return [];
+    const byId = new Map(steps.filter(step => step.id).map(step => [String(step.id), step]));
+    const reached = new Set([start]);
+    const queue = [start];
+    while (queue.length > 0) {
+        const step = queue.pop();
+        for (const branch of asArray(step.branches)) {
+            const candidate = branch;
+            if (!candidate || candidate.type === 'global-error' || !candidate.nextStepId)
+                continue;
+            const next = byId.get(String(candidate.nextStepId));
+            if (!next || reached.has(next))
+                continue;
+            reached.add(next);
+            queue.push(next);
+        }
+    }
+    return [...reached];
+}
 /**
  * "Guard'lı mı?" sorusunun tek doğru cevabı YAZIM BİÇİMİ DEĞİL, SIRA: kökün kendisine (üye
  * erişimi olmadan) bir kez dokunulduğu an — `Page.user &&`, `Page.user || {}`, `!Page.user`,
@@ -206,6 +239,33 @@ function tableSelectionFindings(ruleId, owner, parameters, guide) {
     }
     return [];
 }
+function escapeForPattern(value) {
+    return value.replace(/[^A-Za-z0-9_]/g, '\\$&');
+}
+/**
+ * `selectFields` disiplininin ikinci yarısı: BOŞ seçim tüm alanları getirir (WF-007), FAZLA seçim
+ * ise okunmayan alanları her satırda taşır. Bu ikincisi yalnız workflow'da ölçülebilir — table
+ * adımının çıktısını akışın KENDİSİ tüketir (microservice'te seçim ucun sözleşmesidir, dışarıda
+ * kimin ne okuduğu bilinmez). Ölçüm metinseldir: adımın dışındaki tüm gövde tek metne çevrilir,
+ * her adımın kendi `selectFields` BİLDİRİMİ elenir (bildirim kullanım değildir) ve alan slug'ı bu
+ * metinde hiç geçmiyorsa okunmuyor sayılır. Adımın çıktısı bütün olarak geçiriliyorsa
+ * (`{ list: rows.data }` — `.data`'dan sonra alan erişimi yok) her alan meşrudur, adım ölçülmez.
+ */
+function unreadSelectFields(step, steps) {
+    const name = String(step.name ?? '').trim();
+    if (name === '')
+        return [];
+    const escapedName = escapeForPattern(name);
+    const usage = JSON.stringify(steps.filter(other => other !== step), (key, value) => (key === 'selectFields' ? undefined : value)) ?? '';
+    if (!new RegExp(`\\b${escapedName}\\b`).test(usage))
+        return [];
+    if (new RegExp(`\\b${escapedName}\\s*\\.\\s*data(?!\\s*[.[])`).test(usage))
+        return [];
+    return asArray(step.rule?.selectFields)
+        .filter((field) => Boolean(field) && typeof field === 'object')
+        .map(field => String(field.fieldSlug ?? field.slug ?? ''))
+        .filter(slug => slug.length > 0 && !new RegExp(`\\b${escapeForPattern(slug)}\\b`).test(usage));
+}
 export const policyRules = [
     {
         id: 'MS-001',
@@ -226,6 +286,20 @@ export const policyRules = [
             return [];
         }
     },
+    {
+        id: 'MS-014',
+        module: 'microservice',
+        appliesTo: ['create', 'update'],
+        sourceRef: "WF-024'ün microservice karşılığı: uç listesinde ad ve slug var, 'bu uç ne işe yarar' yok. Alan: Microservice.Description (nullable, çalışma zamanı okumaz)",
+        check: definition => hasText(definition.description)
+            ? []
+            : [{
+                    ruleId: 'MS-014',
+                    severity: 'block',
+                    message: "Ucun 'description' alanı boş. 1-2 cümleyle bu ucun ne işe yaradığını yazın — Studio'da servis formunda görünür ve ucu devralan geliştiricinin ilk okuduğu şeydir. Çağıranın ne elde ettiğini yazın ('anket başlığı + sorularını tek çağrıda kaydeder'), kaynağın şeklini değil ('workflow kaynaklı POST ucu').",
+                    guide: 'ngapps://guides/microservice'
+                }]
+    },
     {
         id: 'MS-002',
         module: 'microservice',
@@ -321,15 +395,18 @@ export const policyRules = [
         id: 'WF-004',
         module: 'workflow',
         appliesTo: ['create', 'update'],
-        sourceRef: 'UI WORKFLOW_STEPS: Response modülleri workflow+middleware',
+        sourceRef: "UI WORKFLOW_STEPS: Response modülleri workflow+middleware. Erişilebilirlik global-error dalını dışlar: o dalın ucundaki response YALNIZ hata yolunda çalışır (ResponseStep.cs:62-64 orada ReturnDto'yu atlar) ve gateway'in kendi enjeksiyonu da oraya bağlanır (errorPath.ts)",
         check: (definition, context) => {
             const body = workflowBody(definition, context.workflowKind);
             const kind = context.workflowKind ?? body.type;
-            if (kind === 'workflow' && !workflowSteps(body).some(step => step.type === 'response')) {
+            const steps = workflowSteps(body);
+            if (kind !== 'workflow' || !steps.some(step => step.type === 'start'))
+                return [];
+            if (!successPathSteps(steps).some(step => step.type === 'response')) {
                 return [{
                         ruleId: 'WF-004',
                         severity: 'warn',
-                        message: "type='workflow' ama response step'i yok — akış yanıt döndürmeyecek. Bilinçli değilse akışın sonuna response step'i bağlayın.",
+                        message: "type='workflow' ama BAŞARI yolunda response step'i yok — akış başarıyla biten çağrıya yanıt döndürmeyecek. Yalnız 'global-error' dalının ucunda response bulunması yetmez: o adım sadece akış patladığında çalışır. Start'tan erişilebilen bir dalın sonuna response step'i bağlayın (adım tanımlı ama hiçbir dalın 'nextStepId' hedefi değilse de bu uyarı çıkar).",
                         guide: 'ngapps://guides/workflow'
                     }];
             }
@@ -402,6 +479,56 @@ export const policyRules = [
                 .map(finding => ({ ...finding, severity: 'warn' })));
         }
     },
+    {
+        id: 'WF-023',
+        module: 'workflow',
+        appliesTo: ['create', 'update', 'preview'],
+        sourceRef: "MS-001/WF-007'nin ikinci yarısı ('yalnız ihtiyaç duyulan alanlar seçilir'): boş seçimi WF-007 yakalıyordu, FAZLA seçim denetimsizdi. Yalnız okuma operasyonlarında ve yalnız workflow'da — write step'te platform selectFields'i zaten yok sayar, microservice'te ise seçim ucun sözleşmesidir",
+        check: (definition, context) => {
+            const steps = workflowSteps(workflowBody(definition, context.workflowKind));
+            return steps
+                .filter(step => step.type === 'table' && isReadOperation(step.rule))
+                .flatMap((step) => {
+                const unread = [...new Set(unreadSelectFields(step, steps))];
+                return unread.length > 0
+                    ? [{
+                            ruleId: 'WF-023',
+                            severity: 'warn',
+                            message: `'${stepLabel(step)}' table step'i şu alanları seçiyor ama akışın hiçbir yerinde okunmuyor: ${unread.join(', ')} — seçilen her alan sorguya ve taşınan satıra maliyet ekler, join'li adımda bu maliyet katlanır. selectFields'ta yalnız gerçekten kullanılan alanları bırakın. (Satırları alan adı yazmadan dolaşan bir code adımı varsa uyarı yanlış pozitiftir; tespit metinseldir.)`,
+                            guide: 'ngapps://guides/workflow'
+                        }]
+                    : [];
+            });
+        }
+    },
+    {
+        id: 'WF-024',
+        module: 'workflow',
+        appliesTo: ['create', 'update'],
+        sourceRef: "Studio kanvası adım adını gösterir, ne yaptığını göstermez: 11 satırlık bir code adımının işini anlamak için ifadeyi satır satır okumak gerekiyordu. Açıklamayı üreten taraf (bu gateway) biliyor ama hiçbir yere yazmıyordu. Alan: Step.Description / Workflow.Description (nullable, motor okumaz). 'preview' dışarıda: kaydedilmeyen bir koşumu açıklama eksikliği yüzünden durdurmak yazımı yavaşlatır, kalıcı kayıt üretmez",
+        check: (definition, context) => {
+            const body = workflowBody(definition, context.workflowKind);
+            const undescribed = workflowSteps(body)
+                .filter(step => !DESCRIPTION_EXEMPT_STEPS.has(String(step.type)))
+                .filter(step => !hasText(step.description))
+                .map(stepLabel);
+            const flowMissing = !hasText(definition.description);
+            if (undescribed.length === 0 && !flowMissing)
+                return [];
+            const parts = [
+                undescribed.length > 0
+                    ? `şu adımlarda 'description' yok: ${undescribed.join(', ')}`
+                    : '',
+                flowMissing ? "akışın kendi açıklaması ('description') boş" : ''
+            ].filter(Boolean);
+            return [{
+                    ruleId: 'WF-024',
+                    severity: 'block',
+                    message: `Açıklama eksik — ${parts.join('; ')}. Her adıma ve akışın kendisine 1-2 cümle 'description' yazın: Studio kanvasında adımın yanında ⓘ ikonu olarak görünür ve akışı devralan geliştiricinin tek okuma kaynağıdır. NE YAPTIĞINI değil NEDEN olduğunu yazın: 'assignments tablosunu status=Aktif ile okur' mekanizmadır ve zaten koddan okunuyor; 'kullanıcının asal pozisyonunu seçer, birden fazla aktif atama varsa is_primary olanı tercih eder' niyettir. start/end adımları muaftır.`,
+                    guide: 'ngapps://guides/workflow'
+                }];
+        }
+    },
     {
         id: 'WF-008',
         module: 'workflow',
@@ -1700,6 +1827,60 @@ export const policyRules = [
             });
         }
     },
+    {
+        id: 'WF-022',
+        module: 'workflow',
+        appliesTo: ['create', 'update', 'preview'],
+        sourceRef: "WorkflowService.cs:454-459 — birden fazla global-error dalı MultipleGlobalErrorBranchException, start dışı dal GlobalErrorBranchMustBeOnStartStepException (ikisi de HTTP 400: ExceptionHandler.cs:145-146). Runtime dalı yalnız start adımında arar: WorkflowRuntimeCacheDto.cs:37-38",
+        check: (definition, context) => {
+            const body = workflowBody(definition, context.workflowKind);
+            const steps = workflowSteps(body);
+            const findings = [];
+            const carriers = steps.filter(step => asArray(step.branches).some(branch => branch?.type === 'global-error'));
+            const total = carriers.reduce((count, step) => count + asArray(step.branches).filter(branch => branch?.type === 'global-error').length, 0);
+            if (total > 1) {
+                findings.push({
+                    ruleId: 'WF-022',
+                    severity: 'block',
+                    message: `${total} adet 'global-error' dalı var (${carriers.map(stepLabel).join(', ')}); platform tek dal kabul eder, fazlasını 400 ile reddeder. Tek dal bırakın — hata yolu zaten TEK bir noktadan başlar, dallanmayı hedef adımın içinde yapın.`,
+                    guide: 'ngapps://guides/workflow'
+                });
+            }
+            const misplaced = carriers.filter(step => step.type !== 'start');
+            if (misplaced.length > 0) {
+                findings.push({
+                    ruleId: 'WF-022',
+                    severity: 'block',
+                    message: `'global-error' dalı start dışı adımda: ${misplaced.map(stepLabel).join(', ')}. Runtime bu dalı YALNIZ start adımında arar; başka adımda duran dal 400 ile reddedilir (kayıt olsa bile hiç çalışmazdı). Dalı start adımının branches[] dizisine taşıyın; adım bazlı hata yakalamak için o adımın 'fail' dalını bağlayın.`,
+                    guide: 'ngapps://guides/workflow'
+                });
+            }
+            return findings;
+        }
+    },
+    {
+        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",
+        check: (definition, context) => {
+            if (context.workflowKind !== 'automation')
+                return [];
+            const steps = workflowSteps(workflowBody(definition, context.workflowKind));
+            const wired = steps.some(step => asArray(step.branches).some(branch => {
+                const candidate = branch;
+                return (candidate?.type === 'global-error' || candidate?.type === 'fail') && Boolean(candidate.nextStepId);
+            }));
+            if (wired)
+                return [];
+            return [{
+                    ruleId: 'WF-021',
+                    severity: 'warn',
+                    message: "Automation'ın hiç bağlı hata yolu yok. Gateway workflow/middleware'e otomatik hata adımı ekler ama automation'da 'response' adımı YASAKTIR, bu yüzden hata yolunu siz yazmalısınız: start adımına { type: 'global-error', nextStepId: <adım> } dalı koyup hedefe 'revert' (tetikleyen satır işlemini geri alır) ya da 'email'/'table' adımı bağlayın. Hata yolu yokken adım patladığında automation sessizce durur ve geriye iz kalmaz.",
+                    guide: 'ngapps://guides/workflow'
+                }];
+        }
+    },
     {
         id: 'MW-003',
         module: 'workflow',