@appaflytech/zeyrek-ai-mcp 0.0.35 → 0.0.37

package/dist/knowledge/connectDataDefinition.js

@@ -0,0 +1,344 @@
+import { z } from 'zod';
+/**
+ * Connect Data tanımı (`{ type: 'connectData', ref, data }` değerinin `ref`'i) — backend
+ * `ConnectDataDefinitionModel`'in ve screen-builder `connect-data.types.ts`'in aynası. Anahtar kümesi
+ * `test/connect-data-parity.test.ts` ile üç yerde eşit tutulur. Şema `strict`tir: platform bilinmeyen
+ * anahtarı `ConnectDataDefinitionInvalidException` ile reddeder, gateway aynı kararı istek gitmeden verir.
+ */
+export const CONNECT_DATA_SOURCE_KINDS = ['entity', 'query', 'view', 'workflow', 'microservice', 'datasource'];
+export const CONNECT_DATA_OPERATORS = ['eq', 'neq', 'lt', 'lte', 'gt', 'gte', 'contains', 'icontains', 'in', 'notin', 'startswith', 'endswith', 'istartswith', 'iendswith', 'isnull', 'isnotnull'];
+export const CONNECT_DATA_EXPAND_DEPTH_LIMIT = 2;
+export const CONNECT_DATA_PAGE_LIMIT_MAX = 1000;
+/**
+ * Backend tanımı null alanlarıyla yazar (`field: null`, `children: null`, `rawSql: null`); okunan tanım
+ * değiştirilip geri gönderilebilsin diye bu null'lar kabul edilir. `rawSql`/`rawBindings` YALNIZ null
+ * olabilir: istemci tanımı ham SQL taşıyamaz (connect-data-filter-invalid).
+ */
+const filterSchema = z.lazy(() => z.object({
+    filterType: z.enum(['single', 'group']).optional(),
+    field: z.string().nullable().optional(),
+    operator: z.enum(CONNECT_DATA_OPERATORS).optional(),
+    value: z.unknown().optional(),
+    conditionType: z.enum(['and', 'or']).optional(),
+    children: z.array(filterSchema).nullable().optional(),
+    isParentRequired: z.boolean().optional(),
+    rawSql: z.null().optional(),
+    rawBindings: z.null().optional()
+}).strict());
+const sortSchema = z.object({ field: z.string(), ascending: z.boolean(), rawSql: z.null().optional() }).strict();
+const pageSchema = z.object({ mode: z.enum(['offset', 'cursor', 'client']), limit: z.number().int() }).strict();
+const behaviorSchema = z.object({
+    filterable: z.array(z.string()).nullable().optional(),
+    searchable: z.array(z.string()).nullable().optional(),
+    edit: z.object({
+        create: z.boolean().optional(),
+        update: z.boolean().optional(),
+        delete: z.boolean().optional(),
+        bulk: z.boolean().optional(),
+        saveMode: z.string().nullable().optional(),
+        editable: z.array(z.string()).nullable().optional(),
+        defaults: z.record(z.unknown()).nullable().optional(),
+        writeMode: z.enum(['atomic', 'partial']).optional()
+    }).strict().nullable().optional(),
+    refresh: z.object({ afterWrite: z.string().nullable().optional(), poll: z.number().nullable().optional() }).strict().nullable().optional()
+}).strict();
+export const lookupSchema = z.lazy(() => z.object({
+    fields: z.array(fieldSchema).nullable().optional(),
+    behavior: behaviorSchema.nullable().optional(),
+    sort: z.array(sortSchema).nullable().optional(),
+    page: pageSchema.nullable().optional(),
+    mode: z.string().nullable().optional()
+}).strict());
+const fieldSchema = z.lazy(() => z.object({
+    id: z.string().uuid().nullable().optional(),
+    slug: z.string(),
+    expand: z.array(fieldSchema).nullable().optional(),
+    lookup: lookupSchema.nullable().optional()
+}).strict());
+export const connectDataDefinitionSchema = z.object({
+    version: z.number().int(),
+    source: z.object({ kind: z.enum(CONNECT_DATA_SOURCE_KINDS), id: z.string().uuid(), slug: z.string().nullable().optional() }).strict().nullable(),
+    fields: z.array(fieldSchema),
+    filter: filterSchema.nullable().optional(),
+    sort: z.array(sortSchema).nullable().optional(),
+    page: pageSchema.nullable().optional(),
+    language: z.string().nullable().optional(),
+    mapping: z.object({ roles: z.record(z.string()).nullable().optional(), columns: z.array(z.record(z.unknown())).nullable().optional() }).strict().nullable().optional(),
+    behavior: behaviorSchema.nullable().optional(),
+    params: z.record(z.unknown()).nullable().optional(),
+    expressions: z.record(z.string()).nullable().optional(),
+    lookup: lookupSchema.nullable().optional()
+}).strict();
+/** Tanımın seçtiği yollar: `ad`, `sube`, `sube.ad`; expand iki seviyeye kadar. */
+export function selectedPaths(definition) {
+    const paths = [];
+    const collect = (fields, prefix, depth) => {
+        for (const field of fields ?? []) {
+            if (!field?.slug?.trim())
+                continue;
+            const path = prefix === null ? field.slug : `${prefix}.${field.slug}`;
+            if (!paths.includes(path))
+                paths.push(path);
+            if (depth < CONNECT_DATA_EXPAND_DEPTH_LIMIT)
+                collect(field.expand, path, depth + 1);
+        }
+    };
+    collect(definition.fields, null, 0);
+    return paths;
+}
+/**
+ * Backend `ConnectDataDefinitionValidator`'ın kuralları (aynı `rule` adları). Önce zod şekli: şekil
+ * düşerse kural kontrolü koşmaz — anahtar adı yanlış bir tanımda alt küme hatası yanıltıcı olurdu.
+ */
+export function connectDataShapeIssues(ref, path = 'ref') {
+    const parsed = connectDataDefinitionSchema.safeParse(ref);
+    if (!parsed.success) {
+        return parsed.error.issues.map(issue => ({
+            code: 'PAGE-035',
+            rule: 'connect-data-definition-invalid',
+            path: [path, ...issue.path].join('.'),
+            message: issue.message
+        }));
+    }
+    const definition = parsed.data;
+    const issues = [];
+    const shape = (rule, issuePath, message) => { issues.push({ code: 'PAGE-035', rule, path: issuePath, message }); };
+    const subset = (rule, issuePath, message) => { issues.push({ code: 'CD-004', rule, path: issuePath, message }); };
+    const paths = selectedPaths(definition);
+    const roots = [...new Set(definition.fields.map(field => field.slug).filter(slug => slug?.trim()))];
+    if (definition.version !== 1)
+        shape('connect-data-version-unsupported', `${path}.version`, `Tanım sürümü ${definition.version} desteklenmiyor; version: 1 yazın.`);
+    if (!definition.source)
+        shape('connect-data-source-missing', `${path}.source`, "Tanımda kaynak yok: source { kind, id } verin (kaynaklar connect_data_sources ile listelenir).");
+    if (definition.fields.length === 0 || definition.fields.some(field => !field.slug?.trim()))
+        shape('connect-data-field-missing', `${path}.fields`, 'En az bir alan seçin; her alan slug taşır.');
+    const seen = new Set();
+    for (const field of definition.fields) {
+        if (field.slug && seen.has(field.slug))
+            shape('connect-data-field-duplicate', `${path}.fields`, `'${field.slug}' birden fazla seçilmiş.`);
+        seen.add(field.slug);
+    }
+    const checkExpand = (fields, fieldPath, depth) => {
+        for (const field of fields ?? []) {
+            if (field.lookup?.fields?.length)
+                checkExpand(field.lookup.fields, `${fieldPath}.${field.slug}.lookup.fields`, depth + 1);
+            if (!field.expand?.length)
+                continue;
+            if (depth >= CONNECT_DATA_EXPAND_DEPTH_LIMIT) {
+                subset('connect-data-expand-too-deep', `${fieldPath}.${field.slug}`, `'${field.slug}' altındaki expand ${CONNECT_DATA_EXPAND_DEPTH_LIMIT} seviyeyi aşıyor.`);
+                continue;
+            }
+            checkExpand(field.expand, `${fieldPath}.${field.slug}`, depth + 1);
+        }
+    };
+    checkExpand(definition.fields, `${path}.fields`, 0);
+    const checkFilter = (filter, filterPath) => {
+        if (!filter)
+            return;
+        if (filter.filterType === 'group') {
+            if (!filter.children?.length)
+                shape('connect-data-filter-invalid', filterPath, 'Filtre grubu en az bir çocuk ister.');
+            filter.children?.forEach((child, index) => checkFilter(child, `${filterPath}.children.${index}`));
+            return;
+        }
+        if (!filter.field?.trim())
+            shape('connect-data-filter-invalid', filterPath, 'Tekil filtre field ister.');
+        const isParameter = typeof filter.value === 'string' && filter.value.startsWith('$');
+        if ((filter.operator === 'in' || filter.operator === 'notin') && !Array.isArray(filter.value) && !isParameter) {
+            shape('connect-data-filter-invalid', filterPath, `'${filter.field}' in/notin kullanıyor; değer liste ya da $parametre olmalı.`);
+        }
+    };
+    checkFilter(definition.filter, `${path}.filter`);
+    for (const sort of definition.sort ?? []) {
+        if (!paths.includes(sort.field))
+            subset('connect-data-sort-not-selected', `${path}.sort`, `Sıralama alanı '${sort.field}' seçili değil. Seçili: ${paths.join(' · ')}`);
+    }
+    if ((definition.sort ?? []).length > 1) {
+        shape('connect-data-sort-single-key', `${path}.sort`, `Motor tek sıralama anahtarı okur: ${(definition.sort ?? []).length} anahtar verildi, runtime 422 ConnectDataFilterNotAllowed 'sort' döner.`);
+    }
+    if (definition.page && (definition.page.limit < 1 || definition.page.limit > CONNECT_DATA_PAGE_LIMIT_MAX)) {
+        shape('connect-data-page-limit', `${path}.page.limit`, `page.limit 1…${CONNECT_DATA_PAGE_LIMIT_MAX} arasında olmalı.`);
+    }
+    if (definition.language && !/^(request|default|[a-z]{2})$/.test(definition.language)) {
+        shape('connect-data-enum-invalid', `${path}.language`, `language '${definition.language}' geçersiz: request · default · iki harfli dil kodu.`);
+    }
+    const behavior = definition.behavior;
+    for (const item of [...new Set([...(behavior?.filterable ?? []), ...(behavior?.searchable ?? [])])].filter(entry => !paths.includes(entry))) {
+        subset('connect-data-filterable-not-selected', `${path}.behavior`, `'${item}' filtrelenebilir/aranabilir ama seçili değil. Seçili: ${paths.join(' · ')}`);
+    }
+    for (const editable of behavior?.edit?.editable ?? []) {
+        if (!roots.includes(editable))
+            subset('connect-data-editable-not-selected', `${path}.behavior.edit.editable`, `'${editable}' düzenlenebilir ama seçili bir KÖK alan değil (expand yolu yazılamaz).`);
+    }
+    const kind = definition.source?.kind;
+    if (kind === 'query' || kind === 'view' || kind === 'workflow' || kind === 'microservice') {
+        const filtersOnServer = kind === 'microservice';
+        const unsupported = [
+            ...(definition.filter && !filtersOnServer ? ['filter'] : []),
+            ...(definition.sort?.length && !filtersOnServer ? ['sort'] : []),
+            ...(behavior?.filterable?.length && !filtersOnServer ? ['behavior.filterable'] : []),
+            ...(behavior?.searchable?.length && !filtersOnServer ? ['behavior.searchable'] : []),
+            ...(behavior?.edit?.create || behavior?.edit?.update || behavior?.edit?.delete ? ['behavior.edit'] : []),
+            ...(definition.page?.mode === 'cursor' ? ['page.mode'] : []),
+            ...definition.fields.filter(field => field.expand?.length).map(field => `fields.${field.slug}.expand`),
+            ...definition.fields.filter(field => field.lookup).map(field => `fields.${field.slug}.lookup`),
+            ...(definition.lookup ? ['lookup'] : [])
+        ];
+        for (const feature of unsupported) {
+            const searchHint = feature === 'behavior.searchable' && kind === 'view'
+                ? ' Arama view kaynağında searchable ile değil, istekteki search ile sunucuda çalışır (describe source.textSearch).'
+                : '';
+            issues.push({ code: 'CD-013', rule: 'connect-data-source-feature-unsupported', path: `${path}.${feature}`, message: `${kind} kaynağında '${feature}' yok: bu kaynak tanımda ${filtersOnServer ? 'yazma, expand ve lookup' : 'filtre, sıralama, searchable, yazma, expand ve lookup'} taşımaz${feature === 'page.mode' ? '; cursor sayfalama yalnız entity kaynağında' : ''}.${searchHint}` });
+        }
+    }
+    if (Object.keys(definition.params ?? {}).length && (kind === 'entity' || kind === 'view')) {
+        issues.push({ code: 'CD-013', rule: 'connect-data-source-feature-unsupported', path: `${path}.params`, message: `${kind} kaynağı parametre almaz: params yalnız query, workflow ve microservice kaynağında; entity/view için filter değerinde $ad kullanın.` });
+    }
+    for (const [name, value] of Object.entries(definition.params ?? {})) {
+        if (typeof value === 'string' && value.length > 1 && value.startsWith('$') && !/^\$[A-Za-z_][A-Za-z0-9_]*$/.test(value)) {
+            shape('connect-data-definition-invalid', `${path}.params.${name}`, `params.${name} = '${value}' sayfa durumu referansı değil: $ ardından harf/rakam/_ ile değişken adı (rakamla başlamaz).`);
+        }
+    }
+    if (behavior?.edit?.saveMode && !['row', 'cell', 'batch'].includes(behavior.edit.saveMode))
+        shape('connect-data-enum-invalid', `${path}.behavior.edit.saveMode`, "saveMode yalnız 'row', 'cell' ya da 'batch'.");
+    if (behavior?.refresh?.afterWrite && !['reload', 'merge'].includes(behavior.refresh.afterWrite))
+        shape('connect-data-enum-invalid', `${path}.behavior.refresh.afterWrite`, "afterWrite yalnız 'reload' ya da 'merge'.");
+    for (const [role, fieldPath] of Object.entries(definition.mapping?.roles ?? {})) {
+        if (fieldPath?.trim() && !paths.includes(fieldPath))
+            subset('connect-data-role-not-selected', `${path}.mapping.roles.${role}`, `'${role}' rolü seçili olmayan '${fieldPath}' alanına eşlenmiş.`);
+    }
+    const lookups = [
+        ...definition.fields.filter(field => field.lookup).map(field => ({ lookup: field.lookup, lookupPath: `${path}.fields.${field.slug}.lookup`, owner: field.slug })),
+        ...(definition.lookup ? [{ lookup: definition.lookup, lookupPath: `${path}.lookup`, owner: definition.source?.slug ?? 'kaynak' }] : [])
+    ];
+    for (const { lookup, lookupPath, owner } of lookups) {
+        if ((lookup.fields ?? []).some(item => item.lookup))
+            issues.push({ code: 'CD-011', rule: 'connect-data-lookup-nested', path: lookupPath, message: `'${owner}' lookup'ı içinde başka lookup olamaz.` });
+        if (lookup.mode && !['drawer', 'modal'].includes(lookup.mode))
+            shape('connect-data-enum-invalid', `${lookupPath}.mode`, "lookup.mode yalnız 'drawer' ya da 'modal'.");
+        if (lookup.page && (lookup.page.limit < 1 || lookup.page.limit > CONNECT_DATA_PAGE_LIMIT_MAX))
+            shape('connect-data-page-limit', `${lookupPath}.page.limit`, `lookup.page.limit 1…${CONNECT_DATA_PAGE_LIMIT_MAX} arasında olmalı.`);
+    }
+    return issues;
+}
+/** İndeksli prop yolunun joker hâli: `series.1.data` → `series[].data`. */
+export function toWildcardPath(propPath) {
+    const segments = [];
+    for (const segment of propPath.split('.')) {
+        if (/^\d+$/.test(segment) && segments.length > 0)
+            segments[segments.length - 1] = `${segments[segments.length - 1]}[]`;
+        else
+            segments.push(segment);
+    }
+    return segments.join('.');
+}
+/**
+ * Şemada veri kaynağına bağlı prop yolları: `<elementId>.<yol>` — kök prop (`tbl1.rows`) ve statik nesne/dizi öğesi
+ * içindeki bağlı prop (`chart1.series.1.data`, D-22).
+ */
+export function connectedPropKeys(nodes, into = new Set()) {
+    const collect = (elementId, value, path) => {
+        if (value?.type === 'connectData') {
+            into.add(`${elementId}.${path}`);
+            return;
+        }
+        if (value?.type !== 'static' || !value.data || typeof value.data !== 'object')
+            return;
+        const entries = Array.isArray(value.data)
+            ? value.data.flatMap((item, index) => (item && typeof item === 'object' && !Array.isArray(item) ? Object.entries(item).map(([key, child]) => [`${index}.${key}`, child]) : []))
+            : Object.entries(value.data);
+        for (const [key, child] of entries)
+            collect(elementId, child, `${path}.${key}`);
+    };
+    for (const node of nodes ?? []) {
+        const props = node.props && typeof node.props === 'object' ? node.props : {};
+        if (typeof node.elementId === 'string') {
+            for (const [prop, value] of Object.entries(props))
+                collect(node.elementId, value, prop);
+        }
+        connectedPropKeys(Array.isArray(node.children) ? node.children : [], into);
+    }
+    return into;
+}
+/**
+ * `set_connect_data` / `remove_connect_data` gövde ön kontrolü ve bağlı prop'a `replace_prop` ile tanım
+ * yazma reddi (CD-005). Platformun kesin 422'lerinin aynasıdır; istek gitmeden `rejectedOps` üretir.
+ * `connectedProps` (`connectedPropKeys`) verilirse bağlantıya bakan kurallar da koşar: bağlı prop'u — ya da içinde
+ * bağlı prop taşıyan üst prop'u (`series` ⊃ `series.1.data`) — ezen yazma ve bağlı olmayan prop'ta
+ * `remove_connect_data` (platform `prop-not-connected`). Verilmezse (ağaç okunmadı) yalnız gövde denetlenir.
+ */
+export function connectDataOpIssues(op, connectedProps = null) {
+    const name = String(op.op ?? '');
+    const label = `'${String(op.target ?? '?')}.${String(op.path ?? op.prop ?? '?')}'`;
+    const key = `${String(op.target ?? '')}.${String(op.prop ?? '')}`;
+    const isConnected = connectedProps?.has(key) ?? false;
+    const holdsConnected = [...(connectedProps ?? [])].some(item => item.startsWith(`${key}.`));
+    const overwrite = { code: 'CD-005', message: `${label} veri kaynağına bağlı${holdsConnected && !isConnected ? ' bir prop taşıyor (iç içe yol)' : ''}: set_binding / set_prop_type / sarmallı replace_prop bağlantıyı ezer (connect-data-prop-connected). Önce remove_connect_data; yalnız örnek satırları değiştirmek için replace_prop { value: [ham satırlar] }.` };
+    if (name === 'replace_prop') {
+        const value = op.value;
+        const isWrapped = Boolean(value) && typeof value === 'object' && !Array.isArray(value) && typeof value?.type === 'string';
+        if (isWrapped && value?.type === 'connectData') {
+            return [{ code: 'CD-005', message: `${label}: connectData değeri replace_prop ile yazılmaz — set_connect_data { target, path, ref } kullanın; bağlantıyı kaldırmak için remove_connect_data.` }];
+        }
+        return (isWrapped && isConnected) || holdsConnected ? [overwrite] : [];
+    }
+    if ((name === 'set_binding' || name === 'set_prop_type') && (isConnected || holdsConnected))
+        return [overwrite];
+    if (name !== 'set_connect_data' && name !== 'remove_connect_data')
+        return [];
+    const issues = [];
+    if (name === 'remove_connect_data' && connectedProps && typeof op.target === 'string' && typeof op.path === 'string' && !connectedProps.has(`${op.target}.${op.path}`)) {
+        issues.push({ code: 'PAGE-035', message: `${label} veri kaynağına bağlı değil; kaldırılacak bağlantı yok (prop-not-connected). Bağlı prop'lar connect_data_get ya da page_schema_get ile görülür.` });
+    }
+    if (typeof op.target !== 'string' || !op.target)
+        issues.push({ code: 'PAGE-035', message: `${name}: 'target' (elementId) zorunlu.` });
+    if (typeof op.path !== 'string' || !op.path)
+        issues.push({ code: 'PAGE-035', message: `${name}: 'path' zorunlu — düz prop ('rows'), nesne içi ('config.series') ya da dizi öğesi ('series.1.data').` });
+    if (name === 'set_connect_data') {
+        const reference = op.ref;
+        const isMicroserviceReference = Boolean(reference) && typeof reference === 'object' && !Array.isArray(reference) && reference?.source === undefined && reference?.microserviceId !== undefined;
+        if (isMicroserviceReference) {
+            // Platform kısa biçimi ÜÇ şartla tanır (`ConnectDataDefinitionModel.ReferencedMicroserviceId`):
+            // tam iki alan, `version` VAR (sayı ya da metin) ve `microserviceId` GUID olarak ayrıştırılabiliyor.
+            // Guard bunu birebir aynalar; aksi hâlde platform tam tanım dalına düşüp anlamsız bir 'missing-ref' verir.
+            const keys = Object.keys(reference ?? {}).filter(key => key !== 'version' && key !== 'microserviceId');
+            const guid = /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/;
+            if (typeof reference?.microserviceId !== 'string' || !guid.test(reference.microserviceId))
+                issues.push({ code: 'PAGE-035', message: `${label}.ref.microserviceId: microservice'e çevrilmiş prop'un kısa biçiminde 'microserviceId' bir GUID metni olmalı (connect-data-definition-invalid).` });
+            if (reference?.version === undefined || reference.version === null)
+                issues.push({ code: 'PAGE-035', message: `${label}.ref.version: kısa biçim 'version' alanını taşımak zorunda (connect-data-definition-invalid).` });
+            else if (typeof reference.version !== 'number' && typeof reference.version !== 'string')
+                issues.push({ code: 'PAGE-035', message: `${label}.ref.version: kısa biçimde 'version' sayı ya da metin olmalı (connect-data-definition-invalid).` });
+            if (keys.length > 0)
+                issues.push({ code: 'PAGE-035', message: `${label}.ref: microservice kısa biçimi yalnız 'version' ve 'microserviceId' taşır; fazladan alan: ${keys.join(', ')} (connect-data-definition-invalid).` });
+        }
+        else {
+            for (const issue of connectDataShapeIssues(op.ref, `${label}.ref`))
+                issues.push({ code: issue.code, message: `${issue.path}: ${issue.message} (${issue.rule})` });
+        }
+    }
+    return issues;
+}
+/**
+ * CD-005'in akış ayağı: setter adımı veri kaynağına bağlı prop'a yazamaz. Runtime setter bağlı prop'u
+ * atlar (flow `setNodeProperty` guard'ı, D-17) — adım koşar, hata vermez, bileşene hiçbir şey yazılmaz.
+ * Barındırıcının şeması okunduğu için istek gitmeden bloklanır; şema okunamadıysa sessiz kalır.
+ */
+export function connectedSetterFindings(steps, errorSteps, hostNodes) {
+    const connected = connectedPropKeys(Array.isArray(hostNodes) ? hostNodes : []);
+    if (connected.size === 0)
+        return [];
+    const findings = [];
+    const asSteps = (value) => (Array.isArray(value) ? value : []).filter((step) => Boolean(step) && typeof step === 'object' && step.type === 'setter');
+    for (const step of [...asSteps(steps), ...asSteps(errorSteps)]) {
+        const iteratees = (step.args ?? {}).iteratees;
+        for (const iteratee of Array.isArray(iteratees) ? iteratees : []) {
+            const element = typeof iteratee.element === 'string' ? iteratee.element : '';
+            const property = typeof iteratee.property === 'string' ? iteratee.property.split('.')[0] ?? '' : '';
+            if (!element || !property || !connected.has(`${element}.${property}`))
+                continue;
+            findings.push({ ruleId: 'CD-005', severity: 'block', message: `'${String(step.name ?? step.stepId)}' setter adımı '${element}.${property}' prop'una yazıyor ama prop veri kaynağına bağlı: runtime setter'ı atlar ve bileşene hiçbir şey yazılmaz. Satırları bağlantı okur; setter'ı kaldırın ya da önce remove_connect_data ile bağlantıyı kaldırın (platform_guide('page') §Kural 1c-3).` });
+        }
+    }
+    return findings;
+}

package/dist/knowledge/connectDataExecute.js

@@ -0,0 +1,93 @@
+export const CONNECT_DATA_WRITE_OPS = ['create', 'update', 'delete'];
+export const CONNECT_DATA_EXECUTE_OPS = ['list', 'describe', 'lookup', ...CONNECT_DATA_WRITE_OPS];
+/** Tek istekteki satır/kimlik tavanı (b-22): gateway bölmez, bileşen de bölmez. */
+export const CONNECT_DATA_WRITE_ROW_LIMIT = 1000;
+const LOCALIZATIONS_KEY = 'localizations';
+/**
+ * `connect_data_execute`'un istek gitmeden bildirdiği CD-012 bulguları: motorun kesin reddedeceği yazma
+ * istekleri (tanımda kapalı op → 403, bulk kapalıyken çok satır → 403, editable dışı ya da expand alanı → 422,
+ * anahtarsız update → 422, tanım atomikken `mode: partial` → 422) ve boş gövde. Kısmi kipte (`mode` ya da tanımın
+ * `writeMode`'u `partial`) anahtarsız satır isteği düşürmez, satır hatası olur → warn. Okuma op'larında bulgu yok; lookup `field` ister.
+ * `keyField` kaynağın birincil anahtarıdır (describe `source.primaryKey`); motor aynı kuralları o alanla uygular.
+ * `capability` verilirse describe'a dayanan kesin retler de bildirilir: sistem kaynağı (403), dosya alanı (422) ve dizi
+ * olmayan m2m değeri (atomic 422, kısmi kipte satır hatası → warn).
+ */
+export function executeFindings(input, definition, keyField = 'id', capability) {
+    const findings = [];
+    const block = (message) => { findings.push({ ruleId: 'CD-012', severity: 'block', message }); };
+    const warn = (message) => { findings.push({ ruleId: 'CD-012', severity: 'warn', message }); };
+    if (input.op === 'lookup' && !input.field && !definition?.lookup)
+        block("op: 'lookup' için 'field' (seçili ilişki alanının slug'ı) gerekli; alansız lookup yalnız tanımın kök lookup'ı açıkken (seçim bileşeni, kendi kaynak) çalışır — platform yoksa 422 ConnectDataLookupOff döner. Açmak için connect_data_bind { lookup: { fields: [] } }.");
+    if (!CONNECT_DATA_WRITE_OPS.includes(input.op))
+        return findings;
+    const op = input.op;
+    const edit = (definition?.behavior?.edit) ?? {};
+    const count = op === 'delete' ? (input.ids?.length ?? 0) : (input.rows?.length ?? 0);
+    const bulkCount = Math.max(input.rows?.length ?? 0, input.ids?.length ?? 0);
+    if (edit[op] !== true)
+        block(`Tanımda edit.${op} kapalı: platform ConnectDataWriteDisabled (403) döner. Açmak için connect_data_bind { edit: { ${op}: true } }.`);
+    if (count === 0)
+        block(`op: '${op}' için ${op === 'delete' ? 'ids' : 'rows'} boş.`);
+    if (bulkCount > 1 && edit.bulk !== true)
+        block(`Tanımda edit.bulk kapalı ama ${bulkCount} satır/kimlik gönderiliyor: platform 403 döner. Tek tek gönderin ya da connect_data_bind { edit: { bulk: true } }.`);
+    if (input.mode === 'partial' && edit.writeMode !== 'partial')
+        block("Tanımın edit.writeMode'u atomic ama istek mode: 'partial': platform ConnectDataWriteModeNotAllowed (422) döner. Kısmi yazma için connect_data_bind { edit: { writeMode: 'partial' } }.");
+    const isPartial = edit.writeMode === 'partial' && input.mode !== 'atomic';
+    const fields = capability?.fields ?? [];
+    if (capability?.source?.isSystem === true)
+        block("Kaynak platformun yönettiği bir sistem tablosu: bağlantı ucu yazmaz, platform ConnectDataWriteDisabled (403) döner.");
+    if ((input.rows?.length ?? 0) > 0) {
+        const writable = new Set([...(edit.editable ?? []), keyField]);
+        const outside = [...new Set((input.rows ?? []).flatMap(writtenKeys).filter(key => key.includes('.') || !writable.has(key)))];
+        if (outside.length > 0) {
+            block(`Tanımın edit.editable listesinde olmayan alan yazılamaz (expand yolu da yazılamaz): ${outside.join(', ')} — platform ConnectDataFieldNotEditable (422). Editable: ${(edit.editable ?? []).join(' · ') || '(boş)'}.`);
+        }
+        const files = [...new Set((input.rows ?? []).flatMap(writtenKeys).filter(key => fields.some(field => field.slug === key && (field.type === 'file' || !!field.file))))];
+        if (files.length > 0)
+            block(`Dosya alanı bağlantı ucundan yazılmaz: ${files.join(', ')} — platform ConnectDataFieldNotEditable (422). Dosyayı file_upload ile yükleyip satırı row_update ile güncelleyin.`);
+        const notListIn = (slugs) => (input.rows ?? []).findIndex(row => Object.entries(row ?? {}).some(([key, value]) => slugs.has(key) && value !== null && value !== undefined && !Array.isArray(value)));
+        const manyToMany = new Set(fields.filter(field => field.relation?.kind === 'm2m' && !field.slug.includes('.')).map(field => field.slug));
+        // Çoklu seçim enum'u ilişki değildir (relation yok) ama motor onu da diziyle yazar; dize 422 BulkRowFailed alır (39/M-16).
+        const multiValued = new Set(fields.filter(field => field.isMultiple === true && !field.relation && field.type !== 'file' && !field.file && !field.slug.includes('.')).map(field => field.slug));
+        const notList = notListIn(manyToMany);
+        const notMulti = notListIn(multiValued);
+        if (notList >= 0 && isPartial)
+            warn(`satır ${notList}: m2m alanı dizi değil — kısmi kipte o satır errors[]'a düşer. m2m değeri ['<id>', …] tam listedir.`);
+        else if (notList >= 0)
+            block(`satır ${notList}: m2m alanı dizi değil — platform BulkRowFailed (422, rowIndex ${notList}) döner. m2m değeri ['<id>', …] tam listedir.`);
+        if (notMulti >= 0 && isPartial)
+            warn(`satır ${notMulti}: çoklu değerli alan dizi değil — kısmi kipte o satır errors[]'a düşer. Çoklu seçim enum'u ['<değer>', …] tam listedir.`);
+        else if (notMulti >= 0)
+            block(`satır ${notMulti}: çoklu değerli alan dizi değil — platform BulkRowFailed (422, rowIndex ${notMulti}) döner. Çoklu seçim enum'u ['<değer>', …] tam listedir.`);
+    }
+    if (op === 'update') {
+        const keyless = (input.rows ?? []).findIndex(row => row?.[keyField] === undefined || row?.[keyField] === null);
+        if (keyless >= 0 && isPartial)
+            warn(`update satırı ${keyless} anahtar alanı '${keyField}' taşımıyor: kısmi kipte o satır errors[]'a düşer, diğerleri yazılır.`);
+        else if (keyless >= 0)
+            block(`update satırı ${keyless} anahtar alanı '${keyField}' taşımıyor: platform BulkRowFailed (422, rowIndex ${keyless}) döner.`);
+    }
+    return findings;
+}
+/** Satırın yazdığı alan adları: kök anahtarlar ve `localizations` içindeki her dilin alanları (motor ikisini de editable'a karşı denetler). */
+function writtenKeys(row) {
+    const { [LOCALIZATIONS_KEY]: localizations, ...values } = row ?? {};
+    const languages = localizations && typeof localizations === 'object' ? Object.values(localizations) : [];
+    return [...Object.keys(values), ...languages.flatMap(language => language && typeof language === 'object' ? Object.keys(language) : [])];
+}
+/** Satırın kısa özeti: anahtar varsa `id=…`, yoksa ilk alan. */
+export function rowSummary(row, keyField = 'id') {
+    if (!row)
+        return undefined;
+    if (row[keyField] !== undefined && row[keyField] !== null)
+        return `${keyField}=${String(row[keyField])}`;
+    const [first] = Object.entries(row);
+    return first ? `${first[0]}=${typeof first[1] === 'object' ? JSON.stringify(first[1]) : String(first[1])}` : undefined;
+}
+/** Yanıtın `errors[]` öğelerine (kısmi yazma, b-22) gönderilen satırın özeti eklenir. */
+export function enrichRowErrors(errors, rows, keyField = 'id') {
+    return (errors ?? []).map(error => {
+        const summary = rowSummary(rows?.[error.row], keyField);
+        return summary ? { ...error, rowSummary: summary } : error;
+    });
+}

package/dist/knowledge/connectDataRules.js

@@ -0,0 +1,128 @@
+export const connectDataRuleCatalog = [
+    {
+        id: 'CD-001',
+        severity: 'block',
+        rule: "Bağlama yalnız bileşenin bağlanabilir prop'una yapılır (component_get.connectData.props; joker series[].data ↔ series.1.data) ve zorunlu roller eşlenir.",
+        enforcedBy: 'connect_data_bind — connectDataBind.ts buildDefinition',
+        source: 'Katalog definition.connectData (b-16); PageSchemaValidator connect-data-prop-not-connectable'
+    },
+    {
+        id: 'CD-002',
+        severity: 'block',
+        rule: "Filtrede alan süzülebilir ve işleç describe listesinde olmalı; runtime/önizleme filtresinde alan behavior.filterable'da olmalı. Korumalı alanda yalnız eq · neq · in · notin.",
+        enforcedBy: 'connect_data_preview ve connect_data_execute (istek filtresi; lookup filtresi hedefe uygulandığı için hariç), connect_data_bind (filterable/searchable, tanım filtresi) — filterFindings',
+        source: 'ConnectDataService EnsureFilterAllowed → ConnectDataFilterNotAllowedException (422); ConnectDataCapabilityResolver ProtectedOperators'
+    },
+    {
+        id: 'CD-003',
+        severity: 'block',
+        rule: 'Sistem tablosunda ekleme, güncelleme ve silme anahtarları açılamaz (platform yalnız bu üçünü reddeder).',
+        enforcedBy: 'connect_data_bind — buildDefinition',
+        source: 'Defaults.SystemManagedEntityIds; describe source.isSystem'
+    },
+    {
+        id: 'CD-004',
+        severity: 'block',
+        rule: 'Davranış, rol ve sıralama seçili alanların alt kümesidir; editable yalnız seçili kök alan; expand ≤ 2 seviye.',
+        enforcedBy: 'set_connect_data op gövdesi (page_schema_patch, layout/component yamaları) — connectDataShapeIssues; connect_data_bind',
+        source: 'ConnectDataDefinitionValidator connect-data-*-not-selected, connect-data-expand-too-deep'
+    },
+    {
+        id: 'CD-005',
+        severity: 'block',
+        rule: "Bağlı prop'a set_binding, set_prop_type, sarmallı replace_prop ya da flow setter yazılmaz.",
+        enforcedBy: "page_schema_patch — connectDataOpIssues; flow_create · flow_update · flow_patch — connectedSetterFindings",
+        source: 'PageSchemaMicroOpApplier connect-data-prop-connected; flow setNodeProperty guard (D-17)'
+    },
+    {
+        id: 'CD-006',
+        severity: 'warn',
+        rule: "Tanımda açık düzenleme eylemine ya da edit.editable alanına politika izin vermiyorsa ayar etkisizdir (runtime 403).",
+        enforcedBy: 'connect_data_bind — buildDefinition (gateway kimliği) ve asUserId verilirse o kullanıcının gözüyle userEyeFindings (38/M-13); connect_data_get (asUserId ile o kullanıcının gözüyle) — editFindings; Studio çekmecesi policyBlockedActions',
+        source: 'ConnectDataCapabilityResolver write { create, update, delete, bulk }'
+    },
+    {
+        id: 'CD-007',
+        severity: 'warn',
+        rule: "page.mode 'client' kaynakta (sayfalama parametresi olmayan query, workflow, limit parametresi olmayan microservice) sunucu sayfalamaz: runtime satırları tek okumada (en çok 1000) alır, süzme/arama/sayfalama tarayıcıda (f-33); 1000'den büyük sonuç eksik görünür.",
+        enforcedBy: 'connect_data_bind — buildDefinition (describe source.pageMode)',
+        source: 'b-31/b-32 ConnectDataSourceMetaModel.PageMode; ConnectDataPageMode.Client'
+    },
+    {
+        id: 'CD-008',
+        severity: 'warn',
+        rule: "Kaynaktan silinmiş alan tanımda kalırsa uyarı; connect_data_bind fixDrift: true ile düşürür. Kimliksiz (yalnız slug'lı) tanım alanı kaynakta yoksa da drift { fieldId: null, was: <slug>, removed: true } gelir (39/03 U-10). Yeniden adlanan alan list/preview yanıtının meta.drift'inde de { was, now } olarak bildirilir (39/03 U-9).",
+        enforcedBy: 'connect_data_bind — var olan bağlantıda kayıtlı tanımla describe edilir, buildDefinition uyarır; connect_data_get drift[]',
+        source: 'ConnectDataCapabilityResolver drift (fieldId ile)'
+    },
+    {
+        id: 'CD-009',
+        severity: 'warn',
+        rule: "Ağaç bileşeni (children rolü = üst kayıt alanı) tüm satırları tek istekte okur, tavan 1000; daha büyük tabloda ağaç eksik çizilir.",
+        enforcedBy: 'connect_data_bind — buildDefinition (roles.children varsa warn)',
+        source: 'f-32 treeQueryState / toTree (ng-apps-flow)'
+    },
+    {
+        id: 'CD-010',
+        severity: 'warn',
+        rule: "Aynı sayfada aynı entity'ye 5+ bağlantı: sayfa açılışında o kadar istek.",
+        enforcedBy: 'connect_data_bind — sameSourceFindings (okunan sayfa şemasında aynı source.id taşıyan bağlı proplar, iç içe yol dahil; bu bağlantı bir kez sayılır)',
+        source: 'Runtime ConnectDataBinding (bağlantı başına bir istek)'
+    },
+    {
+        id: 'CD-011',
+        severity: 'block+warn',
+        rule: "fields[].lookup yalnız ilişki alanında, lookup.fields hedefin alanları; tanımın kök lookup'ı (seçim bileşeni, ADR 0007) kaynağın kendi alanlarıyla ve yalnız entity kaynağında; lookup içinde lookup yok (block); hedef okunamıyorsa lookup tanımı etkisiz (warn).",
+        enforcedBy: 'set_connect_data op gövdesi — connect-data-lookup-nested (block); lookup.fields hedefin alanları ve ilişki alanı şartı platform 422; hedef okunamıyorsa connect_data_bind — lookupReadabilityFindings (warn; gateway kimliği yönetici olduğundan yalnız asUserId ile o kullanıcının gözünde çıkar, 38/M-13)',
+        source: 'ConnectDataDefinitionValidator connect-data-lookup-nested (alan + kök lookup aynı döngü); ConnectDataService.ValidateSourcesAsync connect-data-lookup-not-relation, connect-data-lookup-field-missing (kök lookup: props.<prop>.ref.lookup.fields.<alan>)'
+    },
+    {
+        id: 'CD-012',
+        severity: 'block',
+        rule: "connect_data_execute isteği motorun kesin reddedeceği şekildeyse gönderilmez: tanımda kapalı op (403), bulk kapalıyken 2+ satır ya da kimlik (403), editable dışı ya da expand alanı — localizations içindeki alanlar dahil (422), kaynağın birincil anahtarını taşımayan update satırı (422; kısmi kipte satır hatası → warn), tanımın writeMode'u atomic iken mode partial (422), boş rows/ids; describe'dan sistem kaynağı (403), dosya alanı (422), dizi olmayan m2m ya da çoklu enum (isMultiple; atomic 422, kısmi warn — 39/M-16); lookup field ister.",
+        enforcedBy: 'connect_data_execute — connectDataExecute.executeFindings (istek gönderilmez)',
+        source: 'b-21 ConnectDataService.WriteAsync gate sırası'
+    },
+    {
+        id: 'CD-013',
+        severity: 'block',
+        rule: "query, view ve workflow kaynağında filter, sort, behavior.filterable/searchable, açık edit, expand ve lookup yok; microservice kaynağında edit, expand ve lookup yok (filtre/sıralama/arama uç destekliyorsa describe canFilter/sortable ile açılır; arama yalnız içerir işleçli korumasız metin alanında — dinamik filtreye OR içerir koşulu olarak iner, 2026-10-02). page.mode 'cursor' yalnız entity kaynağında (b-35 A).",
+        enforcedBy: 'set_connect_data op gövdesi ve connect_data_bind — connectDataShapeIssues; connect_data_bind params adları describe source.parameters\'a karşı (buildDefinition)',
+        source: 'b-31/b-32 ConnectDataDefinitionValidator connect-data-source-feature-unsupported (422); f-33 ConnectDataService.ValidateSourcesAsync ref.params.<ad>'
+    },
+    {
+        id: 'CD-014',
+        severity: 'warn',
+        rule: "Tanımın filtre değerlerindeki ve params'ındaki $ad sayfa/uygulama değişkenlerinde (page_state) tanımlı olmalı; yoksa runtime null gönderir. Önizleme $ad'ı sayfa durumundan doldurmaz: request.params.<ad> verilmezse null bağlanır ve sonuç sessizce boş döner.",
+        enforcedBy: 'connect_data_bind — stateReferenceFindings (GET variables sayfa + uygulama); connect_data_preview — previewStateFindings (request.params içinde karşılığı olmayan $ad; sayfa değişkeni okunabildiyse başlangıç değeri önerilir, 38/M-8)',
+        source: 'f-33 ng-apps-flow ConnectDataBinding requestParams (getState page → app)'
+    },
+    {
+        id: 'CD-015',
+        severity: 'warn',
+        rule: "Rol eşlemesi bileşenin çizim ayarlarını kapsamaz: kategori + değer rolü olan bileşende (grafik ailesi) ham satırlar kategoriyi satır başına tekrar eder; toplama bileşenin kendi 'aggregate' ayarıdır (varsayılan 'none') ve bağlama onu yazmaz.",
+        enforcedBy: 'connect_data_bind — buildDefinition (category + value rolü, fieldsFrom olmayan bileşen)',
+        source: 'koşu bulgusu S-6 ng-apps-ui chart data-shape mergeSeriesSources/aggregateRows'
+    },
+    {
+        id: 'CD-016',
+        severity: 'warn',
+        rule: "Rol eşlemesinde alanın tipi rolün tipini besleyebilmeli (component_get.connectData.props.<prop>.roles): metin rolü skaler alan (ilişki/dosya nesnesi değil), sayı/boolean/tarih rolü kendi tipinde alan, üst kayıt rolü anahtar tipinde alan ister. Uymayan eşleme kaydedilir ama bileşen değeri beklediği gibi çizmez.",
+        enforcedBy: 'connect_data_bind — buildDefinition (roleTypeMismatch); Studio sihirbaz/çekmece eşleme adımı aynı kuralla uyarır',
+        source: 'S9 denetimi B-3 (b-16/b-38 rol tipi uyarısı hiçbir katmanda yoktu; backend doğrulama kanalı yalnız hata taşır)'
+    },
+    {
+        id: 'CD-017',
+        severity: 'warn',
+        rule: "Anonim sayfada (page isAnonymous) yazmaya açık bağlantı oturumsuz ziyaretçiye yazma verir: backend yazmada kimliği yalnız anonim olmayan sayfada ister. Basit projede her zaman, kompleks projede politika anonim özneye izin veriyorsa yazılır.",
+        enforcedBy: 'connect_data_bind — anonymousWriteFindings (sayfa GET isAnonymous ∧ behavior.edit create/update/delete); Studio çekmece/sihirbaz düzenleme bölümü aynı koşulla uyarır',
+        source: 'S9 denetimi Y-5 (b-23 sapma 1 f-16 notu); backend ExecuteConnectDataBehavior'
+    },
+    {
+        id: 'CD-018',
+        severity: 'block',
+        rule: "Dosya alanı (describe type 'file') edit.editable'a konamaz: bağlı bileşen dosyayı satır içinde yazmaz. edit açıkken editable verilmezse gateway'in önerdiği yazılabilir alanlar da dosya alanını dışarıda bırakır.",
+        enforcedBy: 'connect_data_bind — buildDefinition (dryRun dahil, istek gitmeden)',
+        source: "38/M-4; ConnectDataService.ValidateSourcesAsync ConnectDataRules.EditableFile 'connect-data-editable-file' (422, kayıtta)"
+    }
+];