@appaflytech/zeyrek-ai-mcp 0.0.6 → 0.0.7

package/dist/tools/automations.js

@@ -2,7 +2,7 @@ import { guid, entityRef, resolveEntityId, withResolved, projectParam, environme
 import { RefResolver } from '../platform/refs.js';
 import { normalizeWorkflowDefinition, withNormalization } from '../knowledge/normalize.js';
 import { evaluatePolicy, enforcePolicy, attachFindings } from '../knowledge/policy.js';
-import { policyRules } from '../knowledge/rules.js';
+import { policyRules, microfunctionStepFindings } from '../knowledge/rules.js';
 import { languageHeader } from '../knowledge/languageCodes.js';
 import { handle } from '../platform/responses.js';
 import { z } from 'zod';
@@ -38,7 +38,10 @@ export function registerAutomationTools(server, platform) {
         annotations: writes
     }, handle(config, async ({ project, environment, entityId, definition, policyOverride }) => {
         const normalized = normalizeWorkflowDefinition(definition);
-        const findings = enforcePolicy(evaluatePolicy(config, policyRules, 'workflow', definition, { operation: 'create', workflowKind: 'automation' }, policyOverride));
+        const findings = enforcePolicy([
+            ...evaluatePolicy(config, policyRules, 'workflow', definition, { operation: 'create', workflowKind: 'automation' }, policyOverride),
+            ...await microfunctionStepFindings(platform, project, environment, definition, 'automation', policyOverride)
+        ]);
         const resolver = new RefResolver(platform, project, environment);
         const resolvedEntityId = await resolveEntityId(resolver, entityId);
         const payload = await platform.tenant('POST', project, `/entities/${resolvedEntityId}/automation`, { environment, body: definition });
@@ -51,7 +54,10 @@ export function registerAutomationTools(server, platform) {
         annotations: updates
     }, handle(config, async ({ project, environment, entityId, id, definition, policyOverride }) => {
         const normalized = normalizeWorkflowDefinition(definition);
-        const findings = enforcePolicy(evaluatePolicy(config, policyRules, 'workflow', definition, { operation: 'update', workflowKind: 'automation' }, policyOverride));
+        const findings = enforcePolicy([
+            ...evaluatePolicy(config, policyRules, 'workflow', definition, { operation: 'update', workflowKind: 'automation' }, policyOverride),
+            ...await microfunctionStepFindings(platform, project, environment, definition, 'automation', policyOverride)
+        ]);
         const resolver = new RefResolver(platform, project, environment);
         const resolvedEntityId = await resolveEntityId(resolver, entityId);
         const payload = await platform.tenant('PUT', project, `/entities/${resolvedEntityId}/automation/${id}`, { environment, body: definition });
@@ -123,11 +129,14 @@ export function registerAutomationTools(server, platform) {
     server.registerTool('automation_preview', {
         title: 'Automation önizle',
         description: "Kaydedilmemiş automation tanımını çalıştırır; kaydetmeden önce preview ile doğrulayın. definition = PreviewWorkflowCommand gövdesi. Preview tek transaction'da koşar ve sonunda ROLLBACK edilir — kalıcı satır yazmaz (ölçüldü, İK koşusu W-1); code step'teki dış HTTP çağrıları istisnadır. Davranış kuralları: platform_guide('workflow').",
-        inputSchema: { project: projectParam, environment: environmentParam, entityId: entityRef, definition: definitionParam, policyOverride: policyOverrideParam, language: languageParam },
+        inputSchema: { project: projectParam, environment: environmentParam, entityId: entityRef, definition: definitionParam, policyOverride: policyOverrideParam, language: languageParam, expectFailure: z.boolean().optional().describe("true: bu önizlemede bir adımın/dalın düşmesi BEKLENİYOR (kasıtlı negatif test — geçersiz gövde, iş kuralı reddi, revert). Yanıt yine executionSuccess:false/runtimeErrors taşır, ama ölçüm aracı bu satırı plansız hata saymaz (page_screenshot'taki expectFailure deseniyle aynı).") },
         annotations: writes
     }, handle(config, async ({ project, environment, entityId, definition, policyOverride, language }) => {
         const normalized = normalizeWorkflowDefinition(definition);
-        const findings = enforcePolicy(evaluatePolicy(config, policyRules, 'workflow', definition, { operation: 'preview', workflowKind: 'automation' }, policyOverride));
+        const findings = enforcePolicy([
+            ...evaluatePolicy(config, policyRules, 'workflow', definition, { operation: 'preview', workflowKind: 'automation' }, policyOverride),
+            ...await microfunctionStepFindings(platform, project, environment, definition, 'automation', policyOverride)
+        ]);
         const resolver = new RefResolver(platform, project, environment);
         const resolvedEntityId = await resolveEntityId(resolver, entityId);
         const payload = await platform.tenant('POST', project, `/entities/${resolvedEntityId}/automation/preview`, { environment, body: definition, headers: languageHeader(language, normalized) });

package/dist/tools/common.js

@@ -51,6 +51,22 @@ export const pagingParams = {
     order: z.string().optional().describe('Sıralanacak alan adı'),
     isDescending: z.boolean().optional()
 };
+/**
+ * Dal adı kuralı: `Environment` ctor'unun aynası, gerçek koruma backend'dedir. Ad yalnız
+ * `environment_create`'i değil, `page_screenshot`'ın `/branch/{env}` şeridini de ilgilendirdiği
+ * için tek yerde durur — iki kopya birbirinden ayrılırsa gateway kabul ettiği bir adı
+ * görüntüleyemez hâle gelir.
+ */
+export const branchNamePattern = /^[a-z][a-z0-9_]{2,30}$/;
+const reservedEnvironmentNames = new Set(['development', 'production', 'public', 'information_schema', 'dev', 'view', 'api', 'files', 'hubs']);
+/** Sabit ortamlar, url sözcükleri ve postgres şemaları: dal adı olamazlar */
+export function isReservedEnvironmentName(name) {
+    return name.startsWith('pg_') || reservedEnvironmentNames.has(name);
+}
+/** Hem biçimi tutan hem rezerve olmayan ad — platformun dal diye kabul edeceği tek küme */
+export function isBranchName(name) {
+    return branchNamePattern.test(name) && !isReservedEnvironmentName(name);
+}
 export const readOnly = { readOnlyHint: true, openWorldHint: false };
 export const writes = { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false };
 export const updates = { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false };

package/dist/tools/dependencies.js

@@ -9,7 +9,7 @@ export function registerDependencyTools(server, platform) {
         inputSchema: {
             project: projectParam,
             environment: environmentParam,
-            module: z.string().describe('Modül adı: entity | field | microservice | workflow | query | view | dataTransferObject vb. (platform Module enum değeri)'),
+            module: z.string().describe('Modül adı: entity | field | microservice | workflow | query | view | dataTransferObject | global-function (fonksiyon, iki kaynak: onu çağıran flow/workflow listesi; flow düğümü sahibini hostModule/hostId/hostName, bağlandığı komponenti ve olayı componentName/eventName/eventTitle ile taşır) vb. (platform Module enum değeri)'),
             id: guid
         },
         annotations: readOnly

package/dist/tools/environments.js

@@ -0,0 +1,52 @@
+import { branchNamePattern, destructive, guid, isReservedEnvironmentName, readOnly, writes } from './common.js';
+import { PlatformApiError } from '../platform/errors.js';
+import { handle } from '../platform/responses.js';
+import { z } from 'zod';
+/** Aggregate kuralının aynası (`Environment` ctor); gerçek koruma backend'dedir. Kural `common.ts`'te. */
+const branchName = z.string().regex(branchNamePattern)
+    .describe("Dal adı: küçük harfle başlar, yalnız küçük harf/rakam/alt çizgi, 3-31 karakter. Bu ad PG şema adı olur.");
+function assertBranchName(name) {
+    if (isReservedEnvironmentName(name)) {
+        throw new PlatformApiError(`environment_create: '${name}' rezerve bir şema adı — dal adı olarak kullanılamaz. Başka bir ad seçin.`, 400);
+    }
+}
+export function registerEnvironmentTools(server, platform) {
+    const config = platform.config;
+    server.registerTool('environment_list', {
+        title: 'Environment listesi',
+        description: "Projenin aktif environment'larını döner: önce sabitler (development, production), sonra dallar. Her satırda 'state' vardır (creating | ready | merging | deleting | merged | error); yalnız 'ready' bir dalda çalışılabilir. Dalda çalışmak için tenant tool'larına environment: '<dal adı>' geçin.",
+        inputSchema: { projectId: guid },
+        annotations: readOnly
+    }, handle(config, ({ projectId }) => platform.org('GET', `/environments/${projectId}`)));
+    server.registerTool('environment_create', {
+        title: 'Dal environment\'ı aç',
+        description: "Projede yeni bir dal environment'ı açar: kendi PG şeması kurulur ve development'ın tanımları oraya kopyalanır. Asenkron bir saga'dır — yanıt 202 döner, dal hemen kullanılabilir DEĞİLDİR. includeRecords true ise projenin KENDİ veritabanındaki bütün veri tablolarının satırları da kopyalanır (çok dilli companion tablolar ve junction'lar dahil; files/folders ve audit trail tabloları hariç, dış datasource'lara dokunulmaz) — entity'de kayıt taşıması ayarı açık olmasa bile. Satırlar merge'de geri taşınmaz.",
+        inputSchema: { projectId: guid, name: branchName, includeRecords: z.boolean().optional().describe('Projenin kendi veritabanındaki bütün tabloların satırları da kopyalansın mı (varsayılan false)') },
+        annotations: writes
+    }, handle(config, async ({ projectId, name, includeRecords }) => {
+        assertBranchName(name);
+        const payload = await platform.org('POST', `/environments/${projectId}`, { body: { name, includeRecords: includeRecords === true } });
+        return {
+            ...(payload && typeof payload === 'object' ? payload : { data: payload }),
+            note: "dal asenkron açılıyor; environment_list ile state=ready bekleyin"
+        };
+    }));
+    server.registerTool('environment_delete', {
+        title: 'Dal environment\'ını sil',
+        description: "Bir dal environment'ını ve PG şemasını siler. Sabit environment'lar (development, production) silinemez — gateway bunu HTTP'den önce reddeder. Yalnız 'ready' ya da 'error' durumundaki dal silinebilir; silme asenkrondur.",
+        inputSchema: { projectId: guid, environmentId: guid },
+        annotations: destructive
+    }, handle(config, async ({ projectId, environmentId }) => {
+        const environments = await platform.org('GET', `/environments/${projectId}`);
+        const rows = environments?.data ?? [];
+        const target = rows.find(row => row.id === environmentId);
+        if (target && target.isBranch !== true) {
+            throw new PlatformApiError(`environment_delete: '${String(target.name)}' sabit bir environment — silinemez. Yalnız dallar silinir (environment_list çıktısında isBranch: true olanlar).`, 400);
+        }
+        const payload = await platform.org('DELETE', `/environments/${projectId}/${environmentId}`);
+        return {
+            ...(payload && typeof payload === 'object' ? payload : { data: payload }),
+            note: "şema asenkron düşürülüyor; environment_list ile dalın listeden çıkmasını bekleyin"
+        };
+    }));
+}

package/dist/tools/files.js

@@ -38,6 +38,56 @@ const mimeTypes = {
     '.xml': 'application/xml',
     '.zip': 'application/zip'
 };
+export async function uploadFile(platform, { project, environment, path, content, text, filename, contentType, folderId }) {
+    const given = [path, content, text].filter(value => value !== undefined);
+    if (given.length !== 1) {
+        throw new PlatformApiError("file_upload: `path`, `content` ya da `text` parametrelerinden tam olarak biri verilmeli — `path` gateway'in okuyabildiği yerel dosya, `content` base64 içerik, `text` düz metin (ikisi de `filename` ile).");
+    }
+    let bytes;
+    let name;
+    if (path) {
+        const absolute = resolve(path);
+        try {
+            bytes = await readFile(absolute);
+        }
+        catch (error) {
+            throw new PlatformApiError(`file_upload: dosya okunamadı — ${absolute} (${error instanceof Error ? error.message : String(error)}). Yol gateway sürecinin çalıştığı makineye göre çözülür.`);
+        }
+        name = filename ?? basename(absolute);
+    }
+    else if (text !== undefined) {
+        if (!filename)
+            throw new PlatformApiError('file_upload: `text` verildiğinde `filename` zorunludur.');
+        bytes = Buffer.from(text, 'utf8');
+        if (bytes.byteLength > maxTextBytes) {
+            throw new PlatformApiError(`file_upload: \`text\` içeriği ${maxTextBytes} bayt sınırını aşıyor (${bytes.byteLength} B). Büyük dosyalar için \`path\` ya da \`content\` kullanın.`);
+        }
+        name = filename;
+    }
+    else {
+        if (!filename)
+            throw new PlatformApiError('file_upload: `content` verildiğinde `filename` zorunludur.');
+        bytes = Buffer.from(content, 'base64');
+        if (bytes.byteLength === 0)
+            throw new PlatformApiError('file_upload: `content` geçerli base64 değil ya da boş.');
+        if (bytes.byteLength > maxInlineBytes) {
+            throw new PlatformApiError(`file_upload: base64 içerik ${maxInlineBytes} bayt sınırını aşıyor (${bytes.byteLength} B). Büyük dosyalar için \`path\` kullanın.`);
+        }
+        name = filename;
+    }
+    if (bytes.byteLength > maxUploadBytes) {
+        throw new PlatformApiError(`file_upload: dosya ${maxUploadBytes} bayt platform sınırını aşıyor (${bytes.byteLength} B).`);
+    }
+    const offendingChar = [...forbiddenNameChars].find(character => name.includes(character));
+    if (offendingChar) {
+        throw new PlatformApiError(`file_upload: dosya adı '${offendingChar}' karakterini içeriyor; platform doğrulaması bunu 422 ile reddeder (FILE-001, UploadFileCommandValidator). Yasak karakterler: ${forbiddenNameChars}`);
+    }
+    const resolvedType = contentType ?? mimeTypes[extname(name).toLowerCase()] ?? 'application/octet-stream';
+    const multipart = folderId
+        ? [{ name: 'FolderId', value: folderId }, { name: 'File', filename: name, contentType: resolvedType, content: bytes }]
+        : [{ name: 'File', filename: name, contentType: resolvedType, content: bytes }];
+    return platform.tenant('POST', project, '/files/upload', { environment, multipart });
+}
 export function registerFileTools(server, platform) {
     const config = platform.config;
     server.registerTool('file_list', {
@@ -66,56 +116,7 @@ export function registerFileTools(server, platform) {
             folderId: guid.optional().describe('Hedef klasör (folder_list); boşsa kök')
         },
         annotations: writes
-    }, handle(config, async ({ project, environment, path, content, text, filename, contentType, folderId }) => {
-        const given = [path, content, text].filter(value => value !== undefined);
-        if (given.length !== 1) {
-            throw new PlatformApiError("file_upload: `path`, `content` ya da `text` parametrelerinden tam olarak biri verilmeli — `path` gateway'in okuyabildiği yerel dosya, `content` base64 içerik, `text` düz metin (ikisi de `filename` ile).");
-        }
-        let bytes;
-        let name;
-        if (path) {
-            const absolute = resolve(path);
-            try {
-                bytes = await readFile(absolute);
-            }
-            catch (error) {
-                throw new PlatformApiError(`file_upload: dosya okunamadı — ${absolute} (${error instanceof Error ? error.message : String(error)}). Yol gateway sürecinin çalıştığı makineye göre çözülür.`);
-            }
-            name = filename ?? basename(absolute);
-        }
-        else if (text !== undefined) {
-            if (!filename)
-                throw new PlatformApiError('file_upload: `text` verildiğinde `filename` zorunludur.');
-            bytes = Buffer.from(text, 'utf8');
-            if (bytes.byteLength > maxTextBytes) {
-                throw new PlatformApiError(`file_upload: \`text\` içeriği ${maxTextBytes} bayt sınırını aşıyor (${bytes.byteLength} B). Büyük dosyalar için \`path\` ya da \`content\` kullanın.`);
-            }
-            name = filename;
-        }
-        else {
-            if (!filename)
-                throw new PlatformApiError('file_upload: `content` verildiğinde `filename` zorunludur.');
-            bytes = Buffer.from(content, 'base64');
-            if (bytes.byteLength === 0)
-                throw new PlatformApiError('file_upload: `content` geçerli base64 değil ya da boş.');
-            if (bytes.byteLength > maxInlineBytes) {
-                throw new PlatformApiError(`file_upload: base64 içerik ${maxInlineBytes} bayt sınırını aşıyor (${bytes.byteLength} B). Büyük dosyalar için \`path\` kullanın.`);
-            }
-            name = filename;
-        }
-        if (bytes.byteLength > maxUploadBytes) {
-            throw new PlatformApiError(`file_upload: dosya ${maxUploadBytes} bayt platform sınırını aşıyor (${bytes.byteLength} B).`);
-        }
-        const offendingChar = [...forbiddenNameChars].find(character => name.includes(character));
-        if (offendingChar) {
-            throw new PlatformApiError(`file_upload: dosya adı '${offendingChar}' karakterini içeriyor; platform doğrulaması bunu 422 ile reddeder (FILE-001, UploadFileCommandValidator). Yasak karakterler: ${forbiddenNameChars}`);
-        }
-        const resolvedType = contentType ?? mimeTypes[extname(name).toLowerCase()] ?? 'application/octet-stream';
-        const multipart = folderId
-            ? [{ name: 'FolderId', value: folderId }, { name: 'File', filename: name, contentType: resolvedType, content: bytes }]
-            : [{ name: 'File', filename: name, contentType: resolvedType, content: bytes }];
-        return platform.tenant('POST', project, '/files/upload', { environment, multipart });
-    }));
+    }, handle(config, (input) => uploadFile(platform, input)));
     server.registerTool('file_download', {
         title: 'Dosya indir',
         description: "Dosyanın içeriğini indirir ve `outPath` ile verilen yerel yola yazar; dönen gövde yalnız özet (yol, boyut, tip) — ikili içerik model bağlamına girmez. Yol gateway sürecinin çalıştığı makineye göre çözülür.",

package/dist/tools/flows.js

@@ -9,7 +9,8 @@ import { writeDiff, withWriteDiff } from '../platform/writeDiff.js';
 import { resolvePatchOperations } from '../knowledge/outlines.js';
 import { patchResult, baseVersionOf } from '../platform/patch.js';
 import fastJsonPatch from 'fast-json-patch';
-import { policyRules } from '../knowledge/rules.js';
+import { policyRules, flowExpressionSites } from '../knowledge/rules.js';
+import { functionCallRefs } from '../knowledge/functionGuards.js';
 import { randomUUID } from 'node:crypto';
 import { z } from 'zod';
 /**
@@ -28,7 +29,7 @@ async function flowWriteDrops(platform, host, project, environment, applicationI
         return { dropped: [], normalized: [] };
     }
 }
-const stepsParam = z.array(z.record(z.unknown())).describe("Adım listesi (StepManagementSchema: { stepId, name, type, kind, args, branches }). DİKKAT: branches[].nextStepId bir GUID değil, hedef adımın stepId STRING'idir; dal ADI motorun anahtarıdır ve start/setter/code adımlarında 'always' olmak zorundadır. Tam şablon: ngapps://examples/flow-load-table (ya da flow_get çıktısı); adım tipleri ve setter/parameters şekli platform_guide('page') Kural 1c.");
+const stepsParam = z.array(z.record(z.unknown())).describe("Adım listesi (StepManagementSchema: { stepId, name, type, kind, args, branches }). DİKKAT: branches[].nextStepId bir GUID değil, hedef adımın stepId STRING'idir; dal ADI motorun anahtarıdır ve start/setter/code/function adımlarında 'always' olmak zorundadır. Tam şablon: ngapps://examples/flow-load-table (ya da flow_get çıktısı); adım tipleri ve setter/parameters şekli platform_guide('page') Kural 1c. Kullanıcı fonksiyonu çağırmak için 'function' adımı: { type:'function', args:{ functionId:'<function_list id>', functionName:'<ad>', parameters:[{ name:'<bildirimdeki ad>', value:{ type:'static'|'property'|'storage'|'state'|'code', ref } }] } } → çıktı Steps.<adımAdı>.data (ngapps://examples/flow-call-function, platform_guide('functions')).");
 const policyOverrideParam = z.boolean().optional();
 const patchOperationsParam = z.array(z.record(z.unknown())).min(1).describe("RFC 6902 JSON Patch işlemleri; yolları flow_get çıktısıyla keşfedin. Dizi öğelerinde indeks yerine seçici kullanılabilir: '/steps[stepId=paint]/args/iteratees[element=tbl_recruiters]/mapping/source' — seçici gövde platforma gitmeden indekse çevrilir, çözülemezse istek hiç gönderilmez.");
 const flowIdParam = guid.describe("Akış id'si; şemadaki events[].value bu id'dir");
@@ -136,6 +137,95 @@ function rowsTargetsByStepName(steps) {
     }
     return targets;
 }
+const isRecord = (value) => Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+function toUiFunctionRecord(entry) {
+    return {
+        id: String(entry.id ?? ''),
+        name: String(entry.name ?? ''),
+        scope: String(entry.scope ?? 'application'),
+        pageId: typeof entry.pageId === 'string' ? entry.pageId : null,
+        isAsync: entry.isAsync === true,
+        parameters: (Array.isArray(entry.parameters) ? entry.parameters : [])
+            .filter(isRecord)
+            .map(parameter => ({ name: String(parameter.name ?? ''), required: parameter.required === true, defaultValue: parameter.defaultValue ?? null }))
+    };
+}
+/** Uç okunamazsa (eski backend, yetki) `undefined`: uyarı üretilmez — lint yazmanın sonucu değil, eklentisidir. */
+async function loadUiFunctions(platform, project, environment, applicationId) {
+    try {
+        const payload = await platform.tenant('GET', project, '/global-functions', { environment, query: { applicationId } });
+        return (Array.isArray(payload?.data) ? payload.data : []).filter(isRecord).map(toUiFunctionRecord);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * FLOW-024 / FLOW-025 (G-04 · G-05): `function` adımının bildirimle eşleşmesi ve ifadelerdeki
+ * `Functions.<ad>(…)` çağrılarının gerçek bir fonksiyona çözülmesi. Küme dinamiktir (uygulama
+ * fonksiyonları + barındırıcı SAYFANIN fonksiyonları, K2) — bu yüzden politika kuralı değil,
+ * ucu okuyan uyarıdır (`requiredParameterWarnings` deseni). docs/16 §5'in "lint yok" kararı
+ * fonksiyon kümesi dinamikleştiği için burada revize edildi (G-13).
+ */
+async function functionWarnings(platform, host, project, environment, applicationId, hostId, steps) {
+    const functionSteps = steps.filter(step => step.type === 'function');
+    const callSites = steps.flatMap(step => flowExpressionSites(step)
+        .flatMap(site => functionCallRefs(site.expression).map(ref => ({ step, origin: site.origin, ref }))));
+    if (functionSteps.length === 0 && callSites.length === 0)
+        return [];
+    const functions = await loadUiFunctions(platform, project, environment, applicationId);
+    if (functions === undefined)
+        return [];
+    const byId = new Map(functions.map(entry => [entry.id, entry]));
+    const byName = new Map(functions.map(entry => [entry.name, entry]));
+    const known = functions.map(entry => entry.name).sort().join(', ') || '(hiç fonksiyon yok)';
+    const visible = (entry) => entry.scope !== 'page' || (host === 'page' && entry.pageId === hostId);
+    const label = (step) => String(step.stepId ?? step.name ?? '?');
+    const warnings = new Set();
+    for (const step of functionSteps) {
+        const args = (step.args ?? {});
+        const id = typeof args.functionId === 'string' ? args.functionId : '';
+        const fn = byId.get(id);
+        if (fn === undefined) {
+            if (id !== '')
+                warnings.add(`FLOW-024: '${label(step)}' adımının functionId'si (${id}) uygulamada yok — platform 422 GlobalFunctionNotFound verir. Bilinen fonksiyonlar: ${known}. Gerçek id'yi function_list ile alın.`);
+            continue;
+        }
+        if (typeof args.functionName === 'string' && args.functionName !== '' && args.functionName !== fn.name) {
+            warnings.add(`FLOW-024: '${label(step)}' adımının functionName'i '${args.functionName}' ama functionId '${fn.name}' fonksiyonuna ait — Studio özeti ve ad yedeği yanlış fonksiyonu gösterir; functionName: '${fn.name}' yazın.`);
+        }
+        if (!visible(fn)) {
+            warnings.add(`FLOW-024: '${label(step)}' adımı '${fn.name}' SAYFA fonksiyonunu çağırıyor ama fonksiyon başka bir sayfaya (${fn.pageId}) ait — bu ${host} bağlamının runtime paketi onu taşımaz, adım 'Functions.${fn.name} is not a function' ile düşer (K2). Fonksiyonu uygulama kapsamına alın ya da bu sayfada tanımlayın.`);
+        }
+        const given = (Array.isArray(args.parameters) ? args.parameters : []).filter(isRecord).map(parameter => String(parameter.name ?? ''));
+        const declared = fn.parameters.map(parameter => parameter.name);
+        const unknown = given.filter(name => name !== '' && !declared.includes(name));
+        if (unknown.length > 0) {
+            warnings.add(`FLOW-024: '${label(step)}' adımı '${fn.name}' fonksiyonunda olmayan parametre geçiyor: ${unknown.join(', ')} — bildirilenler: ${declared.join(', ') || '(parametresiz)'}. Eşleme ada göredir; tanınmayan parametre sessizce düşer.`);
+        }
+        const missing = fn.parameters.filter(parameter => parameter.required && !given.includes(parameter.name)).map(parameter => parameter.name);
+        if (missing.length > 0) {
+            warnings.add(`FLOW-024: '${label(step)}' adımında '${fn.name}' fonksiyonunun zorunlu parametresi eksik: ${missing.join(', ')} — çağrı 'Functions.${fn.name}: "${missing[0]}" is required' ile düşer, Steps.${String(step.name ?? label(step))}.error dolar ve akış hata gövdesiyle 'always' dalından devam eder.`);
+        }
+    }
+    for (const { step, origin, ref } of callSites) {
+        const fn = byName.get(ref.name);
+        if (fn === undefined) {
+            warnings.add(`FLOW-025: '${label(step)}' adımının ${origin} ifadesi Functions.${ref.name}(…) çağırıyor ama uygulamada bu adda fonksiyon yok — runtime 'Functions.${ref.name} is not a function' verir; runCode hatayı yutar, hedef prop yazılmaz. Bilinen fonksiyonlar: ${known}.`);
+            continue;
+        }
+        if (!visible(fn)) {
+            warnings.add(`FLOW-025: '${label(step)}' adımının ${origin} ifadesi Functions.${ref.name}(…) çağırıyor ama bu bir SAYFA fonksiyonu ve başka sayfaya (${fn.pageId}) ait — bu ${host} bağlamında tanımsızdır (K2).`);
+        }
+        if (ref.argCount > fn.parameters.length) {
+            warnings.add(`FLOW-025: '${label(step)}' adımının ${origin} ifadesi Functions.${ref.name} için ${ref.argCount} argüman geçiyor, fonksiyon ${fn.parameters.length} parametre bildiriyor (${fn.parameters.map(parameter => parameter.name).join(', ') || 'parametresiz'}) — fazlası yok sayılır (konumsal eşleme, K5).`);
+        }
+        if (fn.isAsync && !(step.type === 'code' && origin === 'args.value')) {
+            warnings.add(`FLOW-025: '${label(step)}' adımının ${origin} ifadesi async fonksiyon Functions.${ref.name} çağırıyor — dönüş bir Promise'dir; setter/parametre/condition ifadesinde değer olarak '[object Promise]' kalır. async fonksiyonu code adımında 'await Functions.${ref.name}(…)' ile ya da function adımıyla çağırın.`);
+        }
+    }
+    return [...warnings];
+}
 export function registerFlowTools(server, platform) {
     const config = platform.config;
     server.registerTool('flow_list', {
@@ -189,6 +279,7 @@ export function registerFlowTools(server, platform) {
         const findings = enforcePolicy(evaluatePolicy(config, policyRules, 'flow', flow, { operation: 'create' }, policyOverride));
         const parameterWarnings = [
             ...await requiredParameterWarnings(platform, project, environment, applicationId, steps),
+            ...await functionWarnings(platform, host, project, environment, applicationId, hostId, steps),
             ...flowBodyWarnings(steps),
             ...unknownSetterTargetWarnings(steps, errorSteps ?? [], hostNodes(hostRecord))
         ];
@@ -241,6 +332,7 @@ export function registerFlowTools(server, platform) {
             : [];
         const parameterWarnings = [
             ...await requiredParameterWarnings(platform, project, environment, applicationId, flow.steps),
+            ...await functionWarnings(platform, host, project, environment, applicationId, hostId, flow.steps),
             ...flowBodyWarnings(flow.steps),
             ...unknownSetterTargetWarnings(flow.steps, flow.errorSteps, hostNodes(hostRecord))
         ];
@@ -290,6 +382,7 @@ export function registerFlowTools(server, platform) {
         const findings = enforcePolicy(evaluatePolicy(config, policyRules, 'flow', flow, { operation: 'update' }, policyOverride));
         const parameterWarnings = [
             ...await requiredParameterWarnings(platform, project, environment, applicationId, flow.steps),
+            ...await functionWarnings(platform, host, project, environment, applicationId, hostId, flow.steps),
             ...flowBodyWarnings(flow.steps),
             ...unknownSetterTargetWarnings(flow.steps, flow.errorSteps, hostNodes(hostRecord))
         ];