@appaflytech/zeyrek-ai-mcp 0.0.30 → 0.0.32

package/dist/knowledge/platform/web.js

@@ -1,39 +0,0 @@
-import { ENGINE_STEP_TYPES, STEP_ALIASES } from './profile.js';
-import { pageContainerNode } from '../normalize.js';
-/**
- * Web profili = gateway'in profil öncesi davranışı. Buradaki her değer bugün kodda bir yerde
- * örtük olarak vardı; `test/platform-profile.test.ts` golden'ı bu profilin çıktıyı değiştirmediğini
- * kilitler. Değer değiştirmek web davranışını değiştirir — golden kırmızıya döner.
- */
-export const webProfile = Object.freeze({
-    platform: 'web',
-    catalogType: 'web',
-    layout: {
-        modes: new Set(['grid', 'flex', 'cssgrid']),
-        blocksMeaningful: true,
-        rootContainer: pageContainerNode,
-        orderBy: 'block-position'
-    },
-    appearance: {
-        ignoredKeys: new Set(),
-        sizeUnits: new Set(['px', '%', 'em', 'rem', 'calc'])
-    },
-    style: { freeStyle: true, hoverStyle: true, resolver: 'css' },
-    steps: {
-        registered: new Set([...ENGINE_STEP_TYPES, 'alert', 'confirm', 'redirect', 'download', 'storage', 'setcookie', 'share', 'haptic', 'location', 'notification-permission', 'notification-schedule', 'notification-cancel']),
-        aliases: STEP_ALIASES,
-        infoOnly: new Set()
-    },
-    shell: {
-        components: new Set(['navigations', 'sidebar', 'header']),
-        suggestions: {},
-        legacyShellNodes: new Set()
-    },
-    externalComponents: true,
-    state: { storageKinds: new Set() },
-    capture: {
-        target: 'studio-web',
-        devices: { desktop: { width: 1280, height: 800, dpr: 1 } },
-        defaultDevice: 'desktop'
-    }
-});

package/dist/knowledge/process.js

@@ -1,510 +0,0 @@
-import { resolvePatchOperations } from './outlines.js';
-import fastJsonPatch from 'fast-json-patch';
-function asRecords(value) {
-    return Array.isArray(value) ? value.filter((entry) => Boolean(entry) && typeof entry === 'object' && !Array.isArray(entry)) : [];
-}
-function hasText(value) {
-    if (typeof value === 'string')
-        return value.trim() !== '';
-    if (value && typeof value === 'object' && !Array.isArray(value))
-        return Object.values(value).some(entry => typeof entry === 'string' && entry.trim() !== '');
-    return false;
-}
-/** Backend `AssigneeModelConverter.Parse` ile aynı kısa biçim çözümü: `rule:arg of ref@unit:code`. */
-export function parseProcessAssignee(shorthand) {
-    const assignee = {};
-    let text = shorthand.trim();
-    const ofIndex = text.indexOf(' of ');
-    if (ofIndex >= 0) {
-        assignee.of = text.slice(ofIndex + 4).trim();
-        text = text.slice(0, ofIndex).trim();
-    }
-    const unitIndex = text.indexOf('@unit:');
-    if (unitIndex >= 0) {
-        assignee.unit = text.slice(unitIndex + 6).trim();
-        text = text.slice(0, unitIndex).trim();
-    }
-    if (typeof assignee.of === 'string' && assignee.of.includes('@unit:')) {
-        const ofUnitIndex = assignee.of.indexOf('@unit:');
-        assignee.unit = assignee.of.slice(ofUnitIndex + 6).trim();
-        assignee.of = assignee.of.slice(0, ofUnitIndex).trim();
-    }
-    if (text === 'chain:until-authority')
-        return { ...assignee, rule: 'chain-until-authority' };
-    const separatorIndex = text.indexOf(':');
-    assignee.rule = separatorIndex < 0 ? text : text.slice(0, separatorIndex);
-    if (separatorIndex >= 0)
-        assignee.arg = text.slice(separatorIndex + 1);
-    return assignee;
-}
-/** Backend `AssigneeModelConverter.Read` nesne dalının aynası: `chain` + `until-authority` ve `rule` içindeki kısa biçim. */
-function assigneeRule(value) {
-    if (typeof value === 'string')
-        return String(parseProcessAssignee(value).rule);
-    if (Array.isArray(value))
-        return 'list';
-    if (!value || typeof value !== 'object')
-        return undefined;
-    const { rule, arg } = value;
-    if (typeof rule !== 'string')
-        return undefined;
-    if (rule === 'chain' && arg === 'until-authority')
-        return 'chain-until-authority';
-    if (arg === undefined && rule.includes(':'))
-        return String(parseProcessAssignee(rule).rule);
-    return rule;
-}
-/**
- * Backend `DefinitionValidator` bölge sınırının okuduğu kurallar: atamanın kendi kuralı ve `items` kalemlerinin
- * kuralları; kalem listesi varken `list` sayılmaz (dizi kısa biçimi `list` + kalemlerdir).
- */
-function assigneeRules(value) {
-    const items = Array.isArray(value) ? value : Array.isArray(value?.items) ? value.items : null;
-    return [Array.isArray(value) ? 'list' : assigneeRule(value), ...(items ?? []).map(assigneeRule)]
-        .filter((rule) => !!rule && (rule !== 'list' || items === null));
-}
-function walkNodes(nodes, visit, region) {
-    for (const node of asRecords(nodes)) {
-        visit(node, region);
-        if (node.type === 'region')
-            walkNodes(node.nodes, visit, node);
-    }
-}
-/**
- * Kısa biçimleri platformun sakladığı tam biçime çevirir; backend de aynısını yapar ama gateway
- * önceden çevirince writeDiff sahte "düştü" satırı üretmez (M0 §3 `gatewayNormalized`).
- */
-export function normalizeProcessDefinition(definition) {
-    const fixes = [];
-    const plainTextKeys = ['name', 'description'];
-    const localizedKeys = ['caution'];
-    const normalizeEdges = (owner, label) => {
-        if (!Array.isArray(owner.edges))
-            return;
-        owner.edges = owner.edges.map((edge, index) => {
-            if (!Array.isArray(edge))
-                return edge;
-            fixes.push(`${label}edges[${index}]: [from, to] kısa biçimi { from, to } nesnesine çevrildi`);
-            return { from: edge[0], to: edge[1] };
-        });
-    };
-    const normalizeLocalized = (owner, key, label) => {
-        if (typeof owner[key] !== 'string')
-            return;
-        owner[key] = { default: owner[key] };
-        fixes.push(`${label}${key}: düz metin { default } çok dilli biçimine çevrildi`);
-    };
-    const normalizePlainText = (owner, key, label) => {
-        const value = owner[key];
-        if (!value || typeof value !== 'object' || Array.isArray(value))
-            return;
-        const texts = value;
-        const text = [texts.default, ...Object.values(texts)].find(candidate => typeof candidate === 'string' && candidate.trim() !== '');
-        if (typeof text !== 'string')
-            return;
-        owner[key] = text;
-        fixes.push(`${label}${key}: çok dilli nesne düz metne çevrildi (süreç ve düğüm adı/açıklaması tek dillidir)`);
-    };
-    const normalizeAssignee = (owner, key, label) => {
-        if (typeof owner[key] !== 'string')
-            return;
-        owner[key] = parseProcessAssignee(owner[key]);
-        fixes.push(`${label}${key}: kısa biçim atama nesnesine çözüldü (${JSON.stringify(owner[key])})`);
-    };
-    const normalizeSla = (owner, label) => {
-        if (typeof owner.sla === 'string') {
-            owner.sla = [{ duration: owner.sla }];
-            fixes.push(`${label}sla: "${String(owner.sla[0]?.duration)}" tek sayaç kısa biçimi [{ duration }] listesine çevrildi`);
-        }
-        else if (owner.sla && typeof owner.sla === 'object' && !Array.isArray(owner.sla)) {
-            owner.sla = [owner.sla];
-            fixes.push(`${label}sla: tek sayaç nesnesi [{ … }] listesine çevrildi`);
-        }
-    };
-    const normalizeTemplate = (owner, label) => {
-        const template = owner.template;
-        if (!template || typeof template !== 'object' || Array.isArray(template))
-            return;
-        normalizeLocalized(template, 'subject', `${label}template.`);
-        normalizeLocalized(template, 'body', `${label}template.`);
-    };
-    const normalizeHandlers = (owner, label) => {
-        asRecords(owner.on).forEach((handler, index) => {
-            const target = handler.handler;
-            if (!target || typeof target !== 'object' || Array.isArray(target))
-                return;
-            const handlerLabel = `${label}on[${index}].handler.`;
-            normalizeAssignee(target, 'to', handlerLabel);
-            normalizeAssignee(target, 'assignee', handlerLabel);
-            normalizeTemplate(target, handlerLabel);
-        });
-    };
-    for (const key of plainTextKeys) {
-        normalizePlainText(definition, key, '');
-    }
-    for (const key of localizedKeys) {
-        normalizeLocalized(definition, key, '');
-    }
-    normalizeSla(definition, '');
-    normalizeHandlers(definition, '');
-    normalizeEdges(definition, '');
-    walkNodes(definition.nodes, node => {
-        const label = `nodes[id=${String(node.id)}]`;
-        for (const key of plainTextKeys) {
-            normalizePlainText(node, key, `${label}.`);
-        }
-        for (const key of localizedKeys) {
-            normalizeLocalized(node, key, `${label}.`);
-        }
-        for (const key of ['assignee', 'to']) {
-            normalizeAssignee(node, key, `${label}.`);
-        }
-        normalizeSla(node, `${label}.`);
-        normalizeTemplate(node, `${label}.`);
-        normalizeHandlers(node, `${label}.`);
-        asRecords(node.actions).forEach((action, index) => normalizeLocalized(action, 'label', `${label}.actions[${index}].`));
-        if (node.type === 'region')
-            normalizeEdges(node, `${label}.`);
-    });
-    return fixes;
-}
-const commonFields = {
-    id: "kebab-case, tanımda benzersiz; kenarların anahtarıdır, ifadede okunmaz — user-task/approval sonucu snake_case resultKey ile noktayla okunur (vars.tasks.ik_kaydi.action), vars.tasks['ik-kaydi'] değil",
-    type: 'düğüm türü',
-    name: 'çok dilli ad ({ tr, en } ya da düz metin)',
-    description: 'ZORUNLU (BPM-002): düğümün ne işe yaradığı, 1-2 cümle',
-    caution: 'opsiyonel tuzak notu',
-    analysis: "ZORUNLU (BPM-023): { what, data, why, example } — her biri { en, tr }; iş diliyle 1-3 cümle: bu adımda ne yapılır, hangi değerler kullanılır, neden gerekir, gerçek hayattan küçük bir örnek (platform_guide('bpm', section: 'Analiz dokümanı'))",
-    editable: 'locked | params | open (open yalnız region, BPM-003)',
-    writeBack: '{ alan: "<Jint>" } — düğüm çıkışında iş satırına yazılır'
-};
-export const processNodeSchemas = [
-    { type: 'start', purpose: 'Sürecin giriş noktası; tanımda üst düzeyde tam bir tane', required: ['id', 'type', 'description'], fields: { ...commonFields, trigger: 'row-event | manual | api | schedule | sub-process | message | signal', entity: 'row-event için entity slug', operation: 'create | update | delete', condition: 'Jint (row, previousRow)' }, example: { id: 'baslangic', type: 'start', description: 'Satır oluşunca başlar.', trigger: 'row-event', entity: 'gorevler', operation: 'create' } },
-    { type: 'user-task', purpose: 'İnsan görevi; kutuya düşer', required: ['id', 'type', 'description', 'assignee'], fields: { ...commonFields, resultKey: 'sonucun adı: motor görev sonucunu { outcome, action, completedBy, payload } olarak vars.tasks.<resultKey> altına yazar (yoksa id snake_case yazılır: ik-kaydi → vars.tasks.ik_kaydi; eski ifadeler için kebab-case id altına da yazılır). Her user-task düğümüne snake_case verin (teslimat_kontrol) — kebab-case/slug değil: tire kabul edilmez, aynı tipte benzersizdir. Geçit vars.tasks.teslimat_kontrol.action === "sorunlu" diye okur; yazılmamış bir ad (vars.tasks.teslimatKontrol) undefined döner', form: '{ dtoId } görev formunun DTO kimliği (dto_list) — { pageId } sayfa formu, { formKey } dış form anahtarı. SLUG KABUL EDİLMEZ: dtoSlug yazmak sessizce düşer (BPM-021)', assignee: 'atama sözlüğü (ör. "subject-field:atanan_id", "role:finans")', mode: 'claim (varsayılan) | individual', join: 'all | any | force-complete (individual)', actions: '[{ id, label, completes, emits, evidence }]', completeOn: '{ trigger: row-event, operation, condition }', sla: '"P2D" ya da [{ name, duration, onBreach }]', requestInfo: 'bool', allowReassign: 'bool', external: 'bool — dış kullanıcı görevi', revisionBound: 'bool — bölge yeniden başlarsa eski görev superseded', undoWindow: 'ISO süre', assessment: '{ questionBank { entity, where, questionField, optionsField, answerField }, count, passScore (1..count, BPM-020), attempts, random, completeAction } — okuma kanıtından önce sınav' }, example: { id: 'gorevi-yap', type: 'user-task', resultKey: 'gorevi_yap', description: 'Atanan görevi yapar.', assignee: 'subject-field:atanan_id', sla: 'P3D' } },
-    { type: 'approval', purpose: 'Onay görevi ve politika kararı', required: ['id', 'type', 'description', 'assignee'], fields: { ...commonFields, resultKey: 'kararın adı: motor sonucu vars.approvals.<resultKey> altına yazar (yoksa id snake_case yazılır: yonetici-onayi → vars.approvals.yonetici_onayi). Her approval düğümüne snake_case verin (yonetici_onayi) — kebab-case/slug değil: tire kabul edilmez, aynı tipte benzersizdir', form: '{ dtoId } görev formunun DTO kimliği (dto_list) — { pageId } sayfa formu, { formKey } dış form anahtarı. SLUG KABUL EDİLMEZ: dtoSlug yazmak sessizce düşer (BPM-021)', assignee: 'atama sözlüğü', policy: 'sequential | all | any | quorum(n) | majority | weighted(0.6)', rejectPolicy: 'any-reject | quorum(n) | majority', onReject: 'end | back-to:<düğüm> | restart', commentRequired: 'bool ya da Jint ("outcome === \'rejected\'")', selfApproval: 'escalate | skip | allow', weights: '{ "role:x": 2 }', veto: '["role:yk-baskani"]', abstain: 'bool', countAs: 'vars yolu' }, example: { id: 'kontrol-onay', type: 'approval', resultKey: 'kontrol_onay', description: 'Birim yöneticisi onaylar.', assignee: 'unit-manager of subject-field:atanan_id', policy: 'any', onReject: 'back-to:iade' } },
-    { type: 'service', purpose: 'Workflow, bağlayıcı, dış motor ya da AI çağrısı (yan etkili iş)', required: ['id', 'type', 'description'], fields: { ...commonFields, workflowId: 'workflow GUID — workflowId | workflowSlug | connector | externalEngine | ai alanlarından biri zorunlu', connector: '{ name, operation, credentialRef, input }', externalEngine: '{ engine: camunda8 | camunda7 | flowable, processKey, credentialRef, input }', input: '{ ad: "<Jint>" }', output: 'vars yolu ("vars.seviye")', retry: '{ count, backoff, delay }', runAs: 'system ise caution zorunlu (BPM-005)', ai: '{ operation: summarize | classify | extract | suggest-assignee | suggest-decision, labels, schema, files, input, instructions, autonomy: suggest | act-in-adhoc (BPM-019) } — öneri output yoluna yazılır, karar vermez' }, example: { id: 'seviye-hesapla', type: 'service', description: 'Tutardan onay seviyesini hesaplar.', workflowId: '<guid>', input: { tutar: 'row.tutar' }, output: 'vars.seviye' } },
-    { type: 'notify', purpose: 'Bildirim (kutu, e-posta outbox)', required: ['id', 'type', 'description', 'to'], fields: { ...commonFields, to: 'atama sözlüğü', channels: '["inbox", "email"]', template: '{ subject, body } — {{row.x}} yer tutucuları', ackRequired: 'bool' }, example: { id: 'bildir', type: 'notify', description: 'Yöneticiye bildirim.', to: 'unit-manager of subject-field:atanan_id', channels: ['inbox'] } },
-    { type: 'gateway', purpose: 'Dallanma ve birleşme', required: ['id', 'type', 'description', 'kind'], fields: { ...commonFields, kind: 'exclusive | parallel | inclusive (koşulu tutan her dal; birleşmede hâlâ ulaşabilecek dallar beklenir) | event-based (yalnız wait/timer düğümlerine gider; ilk gelen olay kazanır, diğer bekleyişler iptal)', default: 'exclusive/inclusive için hiçbir koşul tutmazsa gidilen hedef' }, example: { id: 'butce-karari', type: 'gateway', kind: 'exclusive', description: 'Bütçe uygun mu?', default: 'reddedildi' } },
-    { type: 'timer', purpose: 'Süre ya da tarih bekleme', required: ['id', 'type', 'description'], fields: { ...commonFields, duration: 'ISO süre', until: 'Jint tarih ifadesi', calendar: 'iş takvimi slug' }, example: { id: 'bekle', type: 'timer', description: 'Bir gün bekler.', duration: 'P1D' } },
-    { type: 'wait', purpose: 'Mesaj ya da sinyal bekleme', required: ['id', 'type', 'description'], fields: { ...commonFields, message: '{ name, correlationKey } — tamponda bekleyen eşleşen mesaj varsa hemen tüketilir', output: 'mesaj gövdesinin yazılacağı vars yolu', signal: '<ad> ya da signal:<ad> — POST bpm/signals ile gelir', link: 'aynı kapsamdaki send { link } düğümünün sıçradığı yakalama noktası (gelen kenarı olmaz); studio bu kipte adımı "Bağlantı noktası" diye adlandırır (BPMN link catch event)' }, example: { id: 'odeme-bekle', type: 'wait', description: 'Ödeme mesajını bekler.', message: { name: 'odeme-alindi', correlationKey: 'vars.siparisNo' } } },
-    { type: 'send', purpose: 'Mesaj atar (kuyruktan korelasyon) ya da link ile aynı kapsamdaki yakalamaya sıçrar. BPMN intermediate throw event; bildirim (notify) DEĞİLDİR, e-posta göndermez (e-posta notify channels email işidir). Studio adı kipine göre: message → "Mesaj gönder", link → "Bağlantıya atla"; palette kutucuğu "Mesaj". Kullanıcıya bu adlarla anlat, "Gönder adımı" deme', required: ['id', 'type', 'description'], fields: { ...commonFields, message: '{ name, correlationKey: "<Jint>" } — link yoksa zorunlu', input: '{ ad: "<Jint>" } — mesaj gövdesi', timeout: 'ISO süre — alıcı yoksa mesajın tamponda bekleyeceği süre (en çok P1D)', link: 'aynı kapsamda wait { link } düğümüne sıçrar' }, example: { id: 'odeme-bildir', type: 'send', description: 'Ödeme mesajını sipariş sürecine atar.', message: { name: 'odeme-alindi', correlationKey: 'vars.siparisNo' }, input: { tutar: 'row.tutar' }, timeout: 'PT10M' } },
-    { type: 'manual', purpose: 'Sistem dışı iş; görev satırı açmaz, yönetici atlatana (process_instance_update skip) kadar bekler', required: ['id', 'type', 'description'], fields: { ...commonFields, sla: 'bekleme SLA süresi; skipOnDeadline ile süre dolunca geçer', skipOnDeadline: 'bool' }, example: { id: 'arsivle', type: 'manual', description: 'Kâğıt dosyayı arşive kaldır.' } },
-    { type: 'script', purpose: 'Jint betiği; vars değiştirir, dosya/HTTP/CLR erişimi yok (2 sn, 10 000 deyim)', required: ['id', 'type', 'description', 'code'], fields: { ...commonFields, code: 'Jint kodu — vars, row, previousRow, initiator okunur; vars.x = … yazılır', output: 'son ifadenin değerinin yazılacağı vars yolu' }, example: { id: 'toplam-hesapla', type: 'script', description: 'Kalemleri toplar.', code: 'vars.toplam = vars.a + vars.b; vars.toplam', output: 'vars.sonuc' } },
-    { type: 'sub-process', purpose: 'Alt süreç (farklı iş nesnesi, forEach partili)', required: ['id', 'type', 'description', 'processSlug'], fields: { ...commonFields, processSlug: 'çocuk tanımın slug\'ı', subject: '{ rowId: "<Jint>" }', input: '{ ad: "<Jint>" }', output: 'vars yolu', binding: 'latest (varsayılan) | deployed | v:<n>', forEach: '{ entity, where: "item.x === …", batch }' }, example: { id: 'tedarikci-degerlendir', type: 'sub-process', description: 'Tedarikçi değerlendirmesi.', processSlug: 'tedarikci-degerlendirme', subject: { rowId: 'vars.tedarikciId' } } },
-    { type: 'case', purpose: 'Yayındaki CMMN vakasını başlatır ve beklemez (akış sürer); vaka kimliği output yoluna, defterde case-started', required: ['id', 'type', 'description', 'caseSlug'], fields: { ...commonFields, caseSlug: "yayındaki vaka tanımının slug'ı (yoksa 422 CaseUnknown; platform_guide('case'))", input: '{ vakaDosyasıÖğesi: "<Jint>" } — vaka dosyası başlangıç değerleri', output: 'vaka kimliğinin yazılacağı vars yolu' }, example: { id: 'sikayet-ac', type: 'case', description: 'Şikâyet vakasını açar.', caseSlug: 'musteri-sikayeti', input: { musteriCevabi: "'yok'" }, output: 'vars.sikayetVakasi' } },
-    { type: 'region', purpose: 'Uyarlanabilir blok ve olay kapsamı', required: ['id', 'type', 'description', 'nodes'], fields: { ...commonFields, nodes: 'iç düğümler (start yok; girişler gelen kenarı olmayanlar)', edges: 'iç kenarlar', limits: '{ maxSteps, nodeTypes, assigneeRules } (BPM-004)', on: '[{ event, interrupt, handler: { type: sub-process | notify | append-task }, afterHandlers, restartWhen, restartIf, restartScope, cancelStale }]' }, example: { id: 'kontrol-bolgesi', type: 'region', description: 'Onay zinciri.', editable: 'open', limits: { maxSteps: 3, assigneeRules: ['unit-manager', 'role'] }, nodes: [], edges: [] } },
-    { type: 'end', purpose: 'Bitiş; bölge içindeyse yalnız o kolu kapatır', required: ['id', 'type', 'description'], fields: { ...commonFields, outcome: 'sonuç adı', kind: 'terminate (bütün dallar iptal, onCancel koşar, sonuç "terminated"; bölgede yalnız o bölge) | error (code ile; en yakın bölgenin on[] "error:<code>" + afterHandlers exit-region işleyicisine, yoksa süreç "error:<code>" sonucuyla biter — üst sürecin sub-process düğümü aynı işleyiciyle yakalar, yoksa faulted)', code: 'kind error için hata kodu', reopenWindow: 'ISO süre — process_instance_update { operation: reopen }' }, example: { id: 'onaylandi', type: 'end', description: 'Onaylandı.', outcome: 'approved', writeBack: { durum: "'onaylandi'" } } }
-];
-export function processPolicyRules() {
-    return [
-        {
-            id: 'BPM-002',
-            module: 'process',
-            appliesTo: ['create', 'update'],
-            sourceRef: "DefinitionValidator description zorunluluğu; WF-024 emsali. Tasarımcı ve kutu 'bu adım ne işe yarar' metnini buradan okur",
-            check: definition => {
-                const findings = [];
-                if (!hasText(definition.description)) {
-                    findings.push({ ruleId: 'BPM-002', severity: 'block', message: "Tanımın 'description' alanı boş. Sürecin ne işe yaradığını 1-2 cümleyle yazın.", guide: 'ngapps://guides/bpm' });
-                }
-                const undescribed = [];
-                walkNodes(definition.nodes, node => {
-                    if (!hasText(node.description))
-                        undescribed.push(String(node.id ?? '?'));
-                });
-                if (undescribed.length > 0) {
-                    findings.push({ ruleId: 'BPM-002', severity: 'block', message: `Açıklamasız düğüm: ${undescribed.join(', ')}. Her düğüm 'description' taşır — kutuda ve tasarımcıda görevin ne istediğini anlatır.`, guide: 'ngapps://guides/bpm' });
-                }
-                return findings;
-            }
-        },
-        {
-            id: 'BPM-023',
-            module: 'process',
-            appliesTo: ['create', 'update'],
-            sourceRef: "Studio Analiz dokümanı sekmesi (zeyrek-backend/docs/adr/0007): AI'ın yazdığı süreçte her adım 'ne / hangi değer / neden' sorusunu iki dilde cevaplar; kullanıcının çizdiği süreç şablonla dolar",
-            check: definition => {
-                const missing = [];
-                const requireTexts = (owner, keys, label) => {
-                    const analysis = owner && typeof owner === 'object' && !Array.isArray(owner) ? owner : {};
-                    for (const key of keys) {
-                        const texts = analysis[key] && typeof analysis[key] === 'object' && !Array.isArray(analysis[key]) ? analysis[key] : {};
-                        for (const language of ['en', 'tr']) {
-                            if (!hasText(texts[language]))
-                                missing.push(`${label}analysis.${key}.${language}`);
-                        }
-                    }
-                };
-                requireTexts(definition.analysis, ['purpose', 'summary'], '');
-                walkNodes(definition.nodes, node => requireTexts(node.analysis, ['what', 'data', 'why', 'example'], `nodes[id=${String(node.id ?? '?')}].`));
-                return missing.length === 0
-                    ? []
-                    : [{ ruleId: 'BPM-023', severity: 'block', message: `Analiz dokümanı eksik: ${missing.slice(0, 12).join(', ')}${missing.length > 12 ? ` ve ${missing.length - 12} alan daha` : ''}. Süreç 'analysis: { purpose, summary }', her düğüm 'analysis: { what, data, why, example }' taşır; her metin { en, tr } — iş diliyle, teknik ad yazmadan; example bu adımın gerçek hayattan küçük bir vakası. Studio'nun Analiz dokümanı sekmesi bunları gösterir.`, guide: 'ngapps://guides/bpm' }];
-            }
-        },
-        {
-            id: 'BPM-003',
-            module: 'process',
-            appliesTo: ['create', 'update'],
-            sourceRef: 'DefinitionValidator: editable open yalnız region düğümünde geçerli',
-            check: definition => {
-                const offenders = [];
-                walkNodes(definition.nodes, node => {
-                    if (node.editable === 'open' && node.type !== 'region')
-                        offenders.push(String(node.id ?? '?'));
-                });
-                return offenders.length === 0
-                    ? []
-                    : [{ ruleId: 'BPM-003', severity: 'block', message: `'editable: open' yalnız bölgede geçerli; bölge dışı düğüm: ${offenders.join(', ')}. Düğümü bir 'region' içine alın ya da 'params' kullanın.`, guide: 'ngapps://guides/bpm' }];
-            }
-        },
-        {
-            id: 'BPM-004',
-            module: 'process',
-            appliesTo: ['create', 'update'],
-            sourceRef: 'DefinitionValidator RuleNotAllowed: bölgedeki atama kuralı limits.assigneeRules kümesinden seçilir',
-            check: definition => {
-                const offenders = [];
-                walkNodes(definition.nodes, (node, region) => {
-                    const allowedRules = asRecords([region?.limits])[0]?.assigneeRules;
-                    if (!Array.isArray(allowedRules) || allowedRules.length === 0)
-                        return;
-                    for (const rule of [...assigneeRules(node.assignee), ...assigneeRules(node.to)]) {
-                        if (!allowedRules.includes(rule))
-                            offenders.push(`${String(node.id)} (${rule})`);
-                    }
-                });
-                return offenders.length === 0
-                    ? []
-                    : [{ ruleId: 'BPM-004', severity: 'block', message: `Bölgenin limits.assigneeRules kümesi dışında atama kuralı: ${offenders.join(', ')}. Platform 422 RuleNotAllowed döner.`, guide: 'ngapps://guides/bpm' }];
-            }
-        },
-        {
-            id: 'BPM-005',
-            module: 'process',
-            appliesTo: ['create', 'update'],
-            sourceRef: "ACC-004 emsali: runAs system satır kapsamını atlar; gerekçe düğümün caution'ında durur",
-            check: definition => {
-                const offenders = [];
-                walkNodes(definition.nodes, node => {
-                    if (node.type === 'service' && node.runAs === 'system' && !hasText(node.caution))
-                        offenders.push(String(node.id ?? '?'));
-                });
-                return offenders.length === 0
-                    ? []
-                    : [{ ruleId: 'BPM-005', severity: 'warn', message: `'runAs: system' gerekçesiz: ${offenders.join(', ')}. Satır kapsamı atlanır; nedenini düğümün 'caution' alanına yazın.`, guide: 'ngapps://guides/bpm' }];
-            }
-        },
-        {
-            id: 'BPM-019',
-            module: 'process',
-            appliesTo: ['create', 'update'],
-            sourceRef: "DefinitionValidator: ai.autonomy 'act-in-adhoc' yalnız süreç adHoc: blocking | non-blocking iken geçerli (b-105); motor ad-hoc iş yürütmediği için öneriden öteye geçmez",
-            check: definition => {
-                const offenders = [];
-                if (definition.adHoc === 'blocking' || definition.adHoc === 'non-blocking')
-                    return [];
-                walkNodes(definition.nodes, node => {
-                    if (asRecords([node.ai])[0]?.autonomy === 'act-in-adhoc')
-                        offenders.push(String(node.id ?? '?'));
-                });
-                return offenders.length === 0
-                    ? []
-                    : [{ ruleId: 'BPM-019', severity: 'block', message: `'ai.autonomy: act-in-adhoc' ad-hoc işe izin vermeyen süreçte: ${offenders.join(', ')}. Tanıma adHoc: blocking | non-blocking yazın ya da autonomy'yi 'suggest' bırakın; platform 422 DefinitionInvalid döner.`, guide: 'ngapps://guides/bpm' }];
-            }
-        },
-        {
-            id: 'BPM-020',
-            module: 'process',
-            appliesTo: ['create', 'update'],
-            sourceRef: 'DefinitionValidator: assessment.passScore 1 ile soru sayısı (count) arasında, count ≥ 1 (b-103)',
-            check: definition => {
-                const offenders = [];
-                walkNodes(definition.nodes, node => {
-                    const assessment = asRecords([node.assessment])[0];
-                    if (!assessment)
-                        return;
-                    const count = typeof assessment.count === 'number' ? assessment.count : undefined;
-                    const passScore = typeof assessment.passScore === 'number' ? assessment.passScore : undefined;
-                    if ((passScore !== undefined && passScore < 1) || (count !== undefined && count < 1) || (passScore !== undefined && count !== undefined && passScore > count)) {
-                        offenders.push(`${String(node.id ?? '?')} (passScore ${String(passScore)}, count ${String(count)})`);
-                    }
-                });
-                return offenders.length === 0
-                    ? []
-                    : [{ ruleId: 'BPM-020', severity: 'block', message: `Değerlendirmede ulaşılamaz geçme puanı: ${offenders.join(', ')}. passScore 1 ile count arasında olmalı; aksi hâlde kimse okuma kanıtını veremez ve platform 422 DefinitionInvalid döner.`, guide: 'ngapps://guides/bpm' }];
-            }
-        },
-        {
-            id: 'BPM-021',
-            module: 'process',
-            appliesTo: ['create', 'update'],
-            sourceRef: 'FormModel yalnız pageId · dtoId · formKey taşır; başka anahtar komut şemasında yok ve platform onu hata vermeden yok sayar (ölçüldü 2026-09-21, S-3 koşusu I-2)',
-            check: definition => {
-                const offenders = [];
-                walkNodes(definition.nodes, node => {
-                    const form = asRecords([node.form])[0];
-                    if (!form)
-                        return;
-                    const unknownKeys = Object.keys(form).filter(key => !['pageId', 'dtoId', 'formKey'].includes(key));
-                    if (unknownKeys.length > 0)
-                        offenders.push(`${String(node.id ?? '?')} (${unknownKeys.join(', ')})`);
-                });
-                return offenders.length === 0
-                    ? []
-                    : [{ ruleId: 'BPM-021', severity: 'block', message: `Görev formunda tanınmayan anahtar: ${offenders.join(', ')}. form yalnız { dtoId } (dto_list kimliği), { pageId } ya da { formKey } taşır — dtoSlug gibi bir anahtar platformda SESSİZCE düşer ve görev formsuz yayınlanır.`, guide: 'ngapps://guides/bpm' }];
-            }
-        }
-    ];
-}
-const lockedOverrideFields = new Set(['id', 'type', 'editable', 'editableParams', 'limits']);
-function recordAt(value, index) {
-    const entry = Array.isArray(value) && Number.isInteger(index) ? value[index] : undefined;
-    return entry && typeof entry === 'object' && !Array.isArray(entry) ? entry : undefined;
-}
-function hasNoDegree(node) {
-    return node.editable === undefined || node.editable === null;
-}
-/** Backend `OverrideMergeService.FindLock` aynası: seçicileri çözülmüş (sayısal) yolun kilit kodu, izinliyse undefined. */
-function overrideLockCode(document, operation) {
-    const op = String(operation.op ?? '');
-    if (op === 'move' || op === 'copy')
-        return 'RegionLocked';
-    const segments = String(operation.path ?? '').slice(1).split('/');
-    const step = asRecords([operation.value])[0];
-    const isPlainStep = !!step
-        && !('editable' in step) && !('editableParams' in step) && !('limits' in step)
-        && (step.nodes === undefined || step.nodes === null)
-        && (step.edges === undefined || step.edges === null)
-        && step.type !== 'region';
-    if (segments[0] === 'params') {
-        const param = segments.length > 2 ? asRecords([document.params?.[segments[1]]])[0] : undefined;
-        return (param?.editable === 'params' || param?.editable === 'open') && segments[2] === 'default' ? undefined : 'ParamNotEditable';
-    }
-    if (segments[0] !== 'nodes' || segments.length < 3 || !/^\d+$/.test(segments[1]))
-        return 'RegionLocked';
-    let node = recordAt(document.nodes, Number(segments[1]));
-    let region;
-    let index = 2;
-    while (node?.type === 'region' && (segments[index] === 'nodes' || segments[index] === 'edges')) {
-        const isRegionOpen = node.editable === 'open';
-        if (segments[index] === 'edges')
-            return isRegionOpen ? undefined : 'RegionLocked';
-        if (index + 1 >= segments.length)
-            return 'RegionLocked';
-        if (segments[index + 1] === '-')
-            return isRegionOpen && op === 'add' && isPlainStep ? undefined : 'RegionLocked';
-        const child = /^\d+$/.test(segments[index + 1]) ? recordAt(node.nodes, Number(segments[index + 1])) : undefined;
-        if (!child)
-            return 'RegionLocked';
-        if (index + 2 >= segments.length) {
-            const isSameStep = isPlainStep && step.id === child.id && step.type === child.type;
-            return isRegionOpen && (hasNoDegree(child) || child.editable === 'open') && (op === 'remove' || isSameStep) ? undefined : 'RegionLocked';
-        }
-        region = node;
-        node = child;
-        index += 2;
-    }
-    if (!node || lockedOverrideFields.has(segments[index]) || segments[index] === 'nodes' || segments[index] === 'edges')
-        return 'RegionLocked';
-    if (node.editable === 'params')
-        return (Array.isArray(node.editableParams) ? node.editableParams : []).includes(segments[index]) ? undefined : 'ParamNotEditable';
-    return hasNoDegree(node) && region?.editable === 'open' ? undefined : 'RegionLocked';
-}
-/**
- * Uyarlama patch'inin istek gitmeden denetimi (g-31): BPM-010 kilitli yol (backend `FindLock` aynası),
- * BPM-011 bölgenin izin vermediği atama kuralı, BPM-012 bölge adım sayısı ve düğüm türü sınırı.
- * Patch temel (aktif sürüm) modeline sırayla uygulanır; yerelde çözülemeyen yol denetimi durdurur ve
- * notlara yazılır — karar platform 422'sine kalır.
- */
-export function overridePatchFindings(baseModel, patch) {
-    const document = structuredClone(baseModel);
-    const findings = [];
-    const notes = [];
-    for (const operation of patch) {
-        const originalPath = typeof operation.path === 'string' ? operation.path : '';
-        let resolved;
-        try {
-            resolved = resolvePatchOperations(document, [structuredClone(operation)], 'process_override_get').operations[0];
-        }
-        catch (error) {
-            notes.push(`uyarlama denetimi '${originalPath}' yolunda durdu (yol yerelde çözülemedi: ${error instanceof Error ? error.message : String(error)}); platform doğrulaması yine çalışır`);
-            return { findings, notes };
-        }
-        const lockCode = overrideLockCode(document, resolved);
-        if (lockCode) {
-            findings.push({ ruleId: 'BPM-010', severity: 'block', message: `Uyarlama kilitli yola dokunuyor: '${originalPath}' (${lockCode}). Düzenlenebilir kapsamlar process_override_get yanıtının editableScopes alanında; platform 422 ${lockCode} döner.`, guide: 'ngapps://guides/bpm' });
-            continue;
-        }
-        try {
-            fastJsonPatch.applyOperation(document, resolved, false, true);
-        }
-        catch (error) {
-            notes.push(`uyarlama denetimi '${originalPath}' işleminde durdu (yerelde uygulanamadı: ${error instanceof Error ? error.message : String(error)}); platform doğrulaması yine çalışır`);
-            return { findings, notes };
-        }
-    }
-    walkNodes(document.nodes, (node, region) => {
-        const limits = asRecords([node.limits])[0];
-        const maxSteps = typeof limits?.maxSteps === 'number' ? limits.maxSteps : undefined;
-        const stepCount = asRecords(node.nodes).length;
-        if (node.type === 'region' && maxSteps !== undefined && stepCount > maxSteps) {
-            findings.push({ ruleId: 'BPM-012', severity: 'block', message: `Bölge '${String(node.id)}' adım sınırını aşıyor: ${stepCount} > ${maxSteps} (limits.maxSteps). Platform 422 MaxStepsExceeded döner.`, guide: 'ngapps://guides/bpm' });
-        }
-        const regionLimits = asRecords([region?.limits])[0];
-        if (!regionLimits)
-            return;
-        const nodeTypes = Array.isArray(regionLimits.nodeTypes) ? regionLimits.nodeTypes : [];
-        if (nodeTypes.length > 0 && !nodeTypes.includes(node.type)) {
-            findings.push({ ruleId: 'BPM-012', severity: 'block', message: `Bölge '${String(region?.id)}' bu düğüm türüne izin vermiyor: ${String(node.id)} (${String(node.type)}). İzinli türler: ${nodeTypes.join(', ')}. Platform 422 NodeTypeNotAllowed döner.`, guide: 'ngapps://guides/bpm' });
-        }
-        const allowedRules = Array.isArray(regionLimits.assigneeRules) ? regionLimits.assigneeRules : [];
-        if (allowedRules.length === 0)
-            return;
-        for (const rule of [...assigneeRules(node.assignee), ...assigneeRules(node.to)]) {
-            if (!allowedRules.includes(rule)) {
-                findings.push({ ruleId: 'BPM-011', severity: 'block', message: `Bölge '${String(region?.id)}' bu atama kuralına izin vermiyor: ${String(node.id)} (${rule}). İzinli kurallar: ${allowedRules.join(', ')}. Platform 422 RuleNotAllowed döner.`, guide: 'ngapps://guides/bpm' });
-            }
-        }
-    });
-    return { findings, notes };
-}
-const ZEYREK_BPMN_NAMESPACE = 'https://zeyrek.dev/bpmn';
-const BPMN_FLOW_ELEMENTS = /<(?:[\w.-]+:)?(?:task|userTask|manualTask|serviceTask|sendTask|receiveTask|scriptTask|businessRuleTask|callActivity|subProcess|transaction|adHocSubProcess|startEvent|endEvent|intermediateCatchEvent|intermediateThrowEvent|exclusiveGateway|parallelGateway|inclusiveGateway|eventBasedGateway|complexGateway)[\s/>]/g;
-/**
- * BPM-016 (g-71): `zeyrek:` uzantısı taşımayan akış öğeleri (başka modelleyiciden) öğe türünden türetilir:
- * derece `locked`, insan adımının ataması yer tutucu `initiator`, SLA/politika boş (backend `BpmnXmlConverter`
- * uzantısız yol). Uzantı önekle değil ad alanı URI'siyle tanınır; uzantılı ve uzantısız öğeler karışık olabilir.
- */
-export function bpmnExtensionFindings(xml) {
-    const prefix = new RegExp(`xmlns:([\\w.-]+)\\s*=\\s*["']${ZEYREK_BPMN_NAMESPACE.replace(/[./]/g, match => `\\${match}`)}["']`).exec(xml)?.[1];
-    const flowElementCount = xml.match(BPMN_FLOW_ELEMENTS)?.length ?? 0;
-    const extendedCount = prefix ? xml.match(new RegExp(`<${prefix}:node[\\s>]`, 'g'))?.length ?? 0 : 0;
-    const missingCount = prefix ? Math.max(flowElementCount - extendedCount, 0) : flowElementCount;
-    if (prefix && missingCount === 0)
-        return [];
-    return [{
-            ruleId: 'BPM-016',
-            severity: 'warn',
-            message: `${prefix ? `${missingCount} akış öğesi` : "XML'deki akış öğeleri"} zeyrek: uzantısı (${ZEYREK_BPMN_NAMESPACE}) taşımıyor (başka modelleyiciden). Bu düğümler öğe türünden türetilir: derece locked (uyarlamaya kapalı), insan adımının ataması yer tutucu 'initiator', SLA/politika boş. process_definition_get { view: 'outline' } ile okuyun, atamaları process_definition_patch ile düzeltip process_definition_preview ile doğrulayın.`,
-            guide: 'ngapps://guides/bpm'
-        }];
-}
-/**
- * BPM-015 (g-71): yayından önce taslak sağlamasında yeşil koşmamış senaryo. Backend kapısı yalnız
- * `requireGreenScenarios: true` tanımda 422 `ScenarioFailed` döner; diğerlerinde gateway uyarır.
- */
-export function staleScenarioFindings(definition, scenarios) {
-    const draft = asRecords(definition.versions).find(version => version.state === 'draft');
-    if (!draft)
-        return [];
-    const stale = asRecords(scenarios).filter(scenario => scenario.lastRunPassed !== true || scenario.lastRunChecksum !== draft.checksum);
-    if (stale.length === 0)
-        return [];
-    return [{
-            ruleId: 'BPM-015',
-            severity: 'warn',
-            message: `Taslak v${String(draft.number)} için yeşil koşmamış ${stale.length} senaryo var: ${stale.slice(0, 5).map(scenario => `'${String(scenario.name)}' (${scenario.lastRunPassed === false && scenario.lastRunChecksum === draft.checksum ? 'kırmızı' : 'bu taslakta koşulmadı'})`).join(', ')}. Önce process_scenario_execute { definitionId } koşun; tanımda requireGreenScenarios: true ise yayın 422 ScenarioFailed döner.`,
-            guide: 'ngapps://guides/bpm'
-        }];
-}

package/dist/knowledge/rowFilter.js

@@ -1,43 +0,0 @@
-import { readFileSync } from 'node:fs';
-import { dirname, join } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { z } from 'zod';
-const FALLBACK = {
-    operators: ['eq', 'neq', 'lt', 'lte', 'gt', 'gte', 'contains', 'icontains', 'in', 'notin', 'startswith', 'endswith', 'istartswith', 'iendswith', 'isnull', 'isnotnull'],
-    filterTypes: ['single', 'group'],
-    conditions: ['and', 'or']
-};
-/**
- * Platform `Filter` gövdesinin enumları paketlenmiş şemadan (`resources/schemas/Filter.json`, `refresh-schemas`):
- * işleç sözlüğü backend enum'undan tek kaynakla gelir (K-9). Dosya okunamazsa (bozuk paket) bugünkü enum.
- */
-export function rowFilterEnums(schemaPath = join(dirname(fileURLToPath(import.meta.url)), '..', 'resources', 'schemas', 'Filter.json')) {
-    try {
-        const schemas = JSON.parse(readFileSync(schemaPath, 'utf8')).components?.schemas ?? {};
-        const enumOf = (suffix, fallback) => {
-            const values = Object.entries(schemas).find(([name]) => name.endsWith(`.${suffix}`))?.[1]?.enum;
-            return values && values.length > 0 ? values : fallback;
-        };
-        return { operators: enumOf('OperatorType', FALLBACK.operators), filterTypes: enumOf('FilterType', FALLBACK.filterTypes), conditions: enumOf('ConditionType', FALLBACK.conditions) };
-    }
-    catch {
-        return FALLBACK;
-    }
-}
-/**
- * `row_list` / `row_export` filtresi: tekil koşul (`field` + `operator` + `value`) ya da `children`'lı grup
- * (`conditionType` and/or). Ham SQL alanları (`rawSql`, `rawBindings`) kabul edilmez — platformun iç alanlarıdır.
- */
-export function rowFilterSchema(enums = rowFilterEnums()) {
-    const node = z.lazy(() => z.object({
-        filterType: z.enum(enums.filterTypes).optional(),
-        field: z.string().min(1).nullable().optional(),
-        // Sözlük dışı işleç şemada değil araçta reddedilir (`filterOperatorError`): ret aynı, istek yine gitmez, ama mesaj doğru adı önerir.
-        operator: z.string().min(1).optional().describe(`İşleç: ${enums.operators.join(' · ')}`),
-        value: z.unknown().optional(),
-        conditionType: z.enum(enums.conditions).optional(),
-        children: z.array(node).nullable().optional(),
-        isParentRequired: z.boolean().optional()
-    }).strict());
-    return node;
-}