@appaflytech/zeyrek-ai-mcp 0.0.5 → 0.0.7

package/dist/resources/schemas/UpdateWorkflowCommand.json

@@ -1,5 +1,10 @@
 {
   "schema": {
+    "required": [
+      "name",
+      "slug",
+      "steps"
+    ],
     "type": "object",
     "properties": {
       "id": {
@@ -7,10 +12,18 @@
         "format": "uuid"
       },
       "slug": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "name": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "description": {
         "type": "string",
         "nullable": true
       },
-      "name": {
+      "caution": {
         "type": "string",
         "nullable": true
       },
@@ -31,11 +44,11 @@
         "$ref": "#/components/schemas/NgApps.Domain.Contexts.Shared.DataTransferObjects.DataTransferObjectBehavior"
       },
       "steps": {
+        "minItems": 1,
         "type": "array",
         "items": {
           "$ref": "#/components/schemas/NgApps.Application.Contexts.Flow.Workflows.StepDto"
-        },
-        "nullable": true
+        }
       },
       "schema": {
         "nullable": true
@@ -86,6 +99,14 @@
             "type": "string",
             "nullable": true
           },
+          "description": {
+            "type": "string",
+            "nullable": true
+          },
+          "caution": {
+            "type": "string",
+            "nullable": true
+          },
           "type": {
             "$ref": "#/components/schemas/NgApps.Domain.Contexts.Flow.Workflows.StepType"
           },
@@ -196,7 +217,7 @@
           "convert",
           "revert",
           "set-user",
-          "end"
+          "microfunction"
         ],
         "type": "string",
         "format": ""
@@ -296,6 +317,11 @@
             "type": "string",
             "nullable": true
           },
+          "microfunctionId": {
+            "type": "string",
+            "format": "uuid",
+            "nullable": true
+          },
           "queryId": {
             "type": "string",
             "format": "uuid",
@@ -668,6 +694,20 @@
           "automationCount": {
             "type": "integer",
             "format": "int32"
+          },
+          "version": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "localizationEntityId": {
+            "type": "string",
+            "format": "uuid",
+            "nullable": true
+          },
+          "localizationParentId": {
+            "type": "string",
+            "format": "uuid",
+            "nullable": true
           }
         },
         "additionalProperties": false
@@ -868,6 +908,9 @@
           "order": {
             "type": "integer",
             "format": "int32"
+          },
+          "writeOn": {
+            "$ref": "#/components/schemas/NgApps.Domain.Contexts.Studio.Microservices.MicroserviceFieldWriteOn"
           }
         },
         "additionalProperties": false
@@ -1012,7 +1055,8 @@
         "enum": [
           "normal",
           "junction",
-          "enum-values"
+          "enum-values",
+          "localization"
         ],
         "type": "string",
         "format": ""
@@ -1055,6 +1099,9 @@
           "isSystemField": {
             "type": "boolean"
           },
+          "isLocalized": {
+            "type": "boolean"
+          },
           "order": {
             "type": "integer",
             "format": "int32",
@@ -1095,6 +1142,10 @@
         "additionalProperties": false
       },
       "NgApps.Application.Contexts.Datastore.Entities.FieldDto": {
+        "required": [
+          "dbType",
+          "slug"
+        ],
         "type": "object",
         "properties": {
           "id": {
@@ -1102,20 +1153,23 @@
             "format": "uuid"
           },
           "description": {
+            "maxLength": 512,
             "type": "string",
             "nullable": true
           },
           "name": {
+            "maxLength": 50,
             "type": "string",
             "nullable": true
           },
           "slug": {
-            "type": "string",
-            "nullable": true
+            "minLength": 1,
+            "type": "string"
           },
           "dbType": {
-            "type": "string",
-            "nullable": true
+            "maxLength": 50,
+            "minLength": 1,
+            "type": "string"
           },
           "primaryKey": {
             "type": "boolean"
@@ -1204,6 +1258,17 @@
           },
           "isSystemField": {
             "type": "boolean"
+          },
+          "isLocalized": {
+            "type": "boolean"
+          },
+          "nameTranslations": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "string",
+              "nullable": true
+            },
+            "nullable": true
           }
         },
         "additionalProperties": false
@@ -1255,6 +1320,10 @@
         "additionalProperties": false
       },
       "NgApps.Application.Contexts.Datastore.Entities.EntityIndexDto": {
+        "required": [
+          "fieldIds",
+          "name"
+        ],
         "type": "object",
         "properties": {
           "id": {
@@ -1262,19 +1331,19 @@
             "format": "uuid"
           },
           "name": {
-            "type": "string",
-            "nullable": true
+            "minLength": 1,
+            "type": "string"
           },
           "unique": {
             "type": "boolean"
           },
           "fieldIds": {
+            "minItems": 1,
             "type": "array",
             "items": {
               "type": "string",
               "format": "uuid"
-            },
-            "nullable": true
+            }
           }
         },
         "additionalProperties": false
@@ -1287,6 +1356,15 @@
         "type": "string",
         "format": ""
       },
+      "NgApps.Domain.Contexts.Studio.Microservices.MicroserviceFieldWriteOn": {
+        "enum": [
+          "always",
+          "create",
+          "update"
+        ],
+        "type": "string",
+        "format": ""
+      },
       "NgApps.Domain.Contexts.Datastore.Entities.OperatorType": {
         "enum": [
           "eq",
@@ -1302,7 +1380,9 @@
           "startswith",
           "endswith",
           "istartswith",
-          "iendswith"
+          "iendswith",
+          "isnull",
+          "isnotnull"
         ],
         "type": "string",
         "format": ""
@@ -1378,6 +1458,18 @@
           "icon": {
             "type": "string",
             "nullable": true
+          },
+          "order": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "labels": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "string",
+              "nullable": true
+            },
+            "nullable": true
           }
         },
         "additionalProperties": false

package/dist/server.js

@@ -1,5 +1,6 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { registerMicroserviceTools } from './tools/microservices.js';
+import { registerMicrofunctionTools } from './tools/microfunctions.js';
 import { registerApplicationTools } from './tools/applications.js';
 import { registerDeploymentTools } from './tools/deployments.js';
 import { registerDatasourceTools } from './tools/datasources.js';
@@ -16,17 +17,24 @@ import { registerTranslationTools } from './tools/translations.js';
 import { registerFlowTools } from './tools/flows.js';
 import { registerKnowledgeResources } from './resources/knowledge.js';
 import { registerSchemaResources } from './resources/schemas.js';
+import { registerRuleResources } from './resources/rules.js';
 import { instrumentServer } from './observability/trace.js';
 import { registerProjectTools } from './tools/projects.js';
 import { registerEntityTools } from './tools/entities.js';
 import { registerDependencyTools } from './tools/dependencies.js';
 import { registerVariableTools } from './tools/variables.js';
+import { registerFunctionTools } from './tools/functions.js';
 import { registerFolderTools } from './tools/folders.js';
 import { registerQueryTools } from './tools/queries.js';
 import { registerViewTools } from './tools/views.js';
 import { registerPageTools } from './tools/pages.js';
 import { registerFileTools } from './tools/files.js';
 import { registerRowTools } from './tools/rows.js';
+import { registerImportTools } from './tools/imports.js';
+import { registerEnvironmentTools } from './tools/environments.js';
+import { registerMergeTools } from './tools/merges.js';
+import { registerRevisionTools } from './tools/revisions.js';
+import { registerActivityTools } from './tools/activities.js';
 import { registerDtoTools } from './tools/dtos.js';
 const moduleRegistrations = {
     platform: registerPlatformTools,
@@ -35,7 +43,9 @@ const moduleRegistrations = {
     datasource: registerDatasourceTools,
     entity: registerEntityTools,
     row: registerRowTools,
+    import: registerImportTools,
     microservice: registerMicroserviceTools,
+    microfunction: registerMicrofunctionTools,
     query: registerQueryTools,
     workflow: registerWorkflowTools,
     automation: registerAutomationTools,
@@ -47,6 +57,7 @@ const moduleRegistrations = {
     flow: registerFlowTools,
     layout: registerLayoutTools,
     variable: registerVariableTools,
+    function: registerFunctionTools,
     folder: registerFolderTools,
     file: registerFileTools,
     access: registerAccessTools,
@@ -54,7 +65,11 @@ const moduleRegistrations = {
     template: registerTemplateTools,
     organization: registerOrganizationTools,
     dependency: registerDependencyTools,
-    deployment: registerDeploymentTools
+    deployment: registerDeploymentTools,
+    environment: registerEnvironmentTools,
+    merge: registerMergeTools,
+    activity: registerActivityTools,
+    revision: registerRevisionTools
 };
 export function createGatewayServer(platform) {
     const server = instrumentServer(new McpServer({ name: 'ngapps', version: '0.1.0' }), platform.config);
@@ -63,5 +78,6 @@ export function createGatewayServer(platform) {
     }
     registerSchemaResources(server);
     registerKnowledgeResources(server);
+    registerRuleResources(server);
     return server;
 }

package/dist/tools/access.js

@@ -5,12 +5,12 @@ export function registerAccessTools(server, platform) {
     const config = platform.config;
     server.registerTool('role_list', {
         title: 'Rolleri listele',
-        description: "Projenin rollerini listeler. page_create/page_update'in roleIds parametresi bu id'lerdir — rol id'sini tahmin etmeyin, buradan okuyun.",
+        description: "Projenin rollerini listeler. Uç YALNIZ id + name döner (backend RoleDto bu ikisini taşır) — SLUG BURADA YOKTUR ve iki anahtar farklıdır: page_create/page_update ve microservice_create'in roleIds alanı ID ister, buna karşılık Authorized(user.roles) ile middleware'in kurduğu user.roles SLUG karşılaştırır (platformun get-user sorgusu roles+user_roles join'inden slug dizisi üretir). Slug'ı built-in 'roles' entity'sinden okuyun (sabit id 01917ede-88a2-72ea-8397-2619e5d5dca0; row_list/microservice). ROL OLUŞTURAN BİR TOOL YOKTUR ve olmamalıdır: roller built-in datasource'taki sıradan bir entity'dir (kolonlar id · name UNIQUE · slug). Uygulamanın rol yönetmesi gerekiyorsa yol entity_get('roles') + kendi microservice ucun (uç + sayfa) ve rolü kullanıcıya bağlayan user_roles satırı — MCP'den doğrudan yazma değil; reçete platform_guide('entity') §'Hazır entity'ler'. Projeyle birlikte gelen roller çoğu senaryoya yeter; önce bu listeye bakın.",
         inputSchema: { project: projectParam, environment: environmentParam },
         annotations: readOnly
     }, handle(config, async ({ project, environment }) => {
         const payload = await platform.tenant('GET', project, '/roles', { environment });
-        return { roles: (payload?.data ?? []).map(role => ({ id: role.id, name: role.name, isSuperAdmin: role.isSuperAdmin })) };
+        return { roles: (payload?.data ?? []).map(role => ({ id: role.id, name: role.name })) };
     }));
     server.registerTool('user_list', {
         title: 'Kullanıcıları listele',
@@ -20,7 +20,7 @@ export function registerAccessTools(server, platform) {
     }, handle(config, ({ project, environment, ...query }) => platform.tenant('GET', project, '/users', { environment, query })));
     server.registerTool('org_role_list', {
         title: 'Organizasyon rollerini listele',
-        description: 'Organization.API tarafındaki rolleri listeler (platform yönetimi); proje içi yetkilendirme için role_list kullanın.',
+        description: 'Organization.API tarafındaki rolleri listeler (platform yönetimi); proje içi yetkilendirme için role_list kullanın. Burada da oluşturma yoktur — organizasyon rolleri platform yönetimine aittir ve uygulamanın rol tablosuyla (built-in roles entity) ilgisi yoktur.',
         inputSchema: {},
         annotations: readOnly
     }, handle(config, () => platform.org('GET', '/roles')));

package/dist/tools/activities.js

@@ -0,0 +1,40 @@
+import { guid, pagingParams, readOnly } from './common.js';
+import { handle } from '../platform/responses.js';
+import { z } from 'zod';
+const activityKind = z.enum([
+    'environment.created',
+    'environment.ready',
+    'environment.failed',
+    'environment.deleted',
+    'environment.merged',
+    'merge.planned',
+    'merge.resolved',
+    'merge.applied',
+    'merge.applied_with_drift',
+    'merge.discarded',
+    'merge.failed',
+    'deployment.started',
+    'deployment.completed',
+    'deployment.failed',
+    'merge.reverted'
+]).optional()
+    .describe("Tek bir olay türüne süz");
+const isoDate = z.string().min(1).optional()
+    .describe("ISO tarih, ör. '2026-09-08T00:00:00Z'");
+export function registerActivityTools(server, platform) {
+    const config = platform.config;
+    server.registerTool('activity_list', {
+        title: 'Proje etkinlik günlüğü',
+        description: "Projenin dal, merge ve dağıtım geçmişini en yeniden eskiye listeler: kim, ne zaman, ne yaptı. Her satırda kind, actor, actorSource (human|ai|system), occurredAt ve türe göre değişen bir summary vardır — merge.applied'da message ve counters, environment.created'da branchName, deployment.*'da süre ya da hata. subjectId merge satırlarında plan id'sidir; ayrıntı için merge_get ile okuyun. actorSource='ai' satırları bu gateway üzerinden yapılan işlerdir.",
+        inputSchema: {
+            projectId: guid,
+            kind: activityKind,
+            environmentId: guid.optional(),
+            userId: z.string().min(1).optional().describe("Aktörün kullanıcı id'si"),
+            from: isoDate,
+            to: isoDate,
+            ...pagingParams
+        },
+        annotations: readOnly
+    }, handle(config, ({ projectId, ...query }) => platform.org('GET', `/activities/${projectId}`, { query })));
+}

package/dist/tools/applications.js

@@ -29,7 +29,7 @@ export function registerApplicationTools(server, platform) {
             name: z.string().min(1),
             color: z.string().optional(),
             dns: z.string().optional(),
-            type: z.string().optional().describe('ApplicationType; varsayılan Web'),
+            type: z.enum(['web', 'mobile']).optional().describe("ApplicationType; geçerli değerler: 'web', 'mobile'; varsayılan 'web'"),
             properties: z.record(z.unknown()).optional(),
             notFoundPageId: guid.optional()
         },

package/dist/tools/automations.js

@@ -1,9 +1,12 @@
-import { guid, projectParam, environmentParam, definitionParam, pagingParams, readOnly, writes, updates, destructive } from './common.js';
+import { guid, entityRef, resolveEntityId, withResolved, projectParam, environmentParam, definitionParam, pagingParams, readOnly, writes, updates, destructive, languageParam } from './common.js';
+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';
+import { constraintSummary } from '../knowledge/backendConstraints.js';
 const policyOverrideParam = z.boolean().optional()
     .describe('true: politika block bulgularını warn\'a indirir (bilinçli istisna; yanıtta işaretlenir)');
 export function registerAutomationTools(server, platform) {
@@ -11,93 +14,132 @@ export function registerAutomationTools(server, platform) {
     server.registerTool('automation_list', {
         title: 'Automation listele',
         description: 'Entity\'ye bağlı automation\'ları listeler.',
-        inputSchema: { project: projectParam, environment: environmentParam, entityId: guid, searchTerm: z.string().optional(), ...pagingParams },
+        inputSchema: { project: projectParam, environment: environmentParam, entityId: entityRef, searchTerm: z.string().optional(), ...pagingParams },
         annotations: readOnly
-    }, handle(config, ({ project, environment, entityId, ...query }) => platform.tenant('GET', project, `/entities/${entityId}/automation/list`, { environment, query })));
+    }, handle(config, async ({ project, environment, entityId, ...query }) => {
+        const resolver = new RefResolver(platform, project, environment);
+        const resolvedEntityId = await resolveEntityId(resolver, entityId);
+        return withResolved(await platform.tenant('GET', project, `/entities/${resolvedEntityId}/automation/list`, { environment, query }), resolver.resolved);
+    }));
     server.registerTool('automation_get', {
         title: 'Automation getir',
         description: 'Tek automation\'ı step ağacıyla getirir.',
-        inputSchema: { project: projectParam, environment: environmentParam, entityId: guid, id: guid },
+        inputSchema: { project: projectParam, environment: environmentParam, entityId: entityRef, id: guid },
         annotations: readOnly
-    }, handle(config, ({ project, environment, entityId, id }) => platform.tenant('GET', project, `/entities/${entityId}/automation/${id}`, { environment })));
+    }, handle(config, async ({ project, environment, entityId, id }) => {
+        const resolver = new RefResolver(platform, project, environment);
+        const resolvedEntityId = await resolveEntityId(resolver, entityId);
+        return withResolved(await platform.tenant('GET', project, `/entities/${resolvedEntityId}/automation/${id}`, { environment }), resolver.resolved);
+    }));
     server.registerTool('automation_create', {
         title: 'Automation oluştur',
-        description: "Entity'ye automation bağlar. definition = CreateWorkflowCommand gövdesi ('automation' nesnesi içermeli; entityId route'tan set edilir). İlk kullanımdan önce platform_guide('workflow') okuyun; gövde politika kontrolünden geçer.",
-        inputSchema: { project: projectParam, environment: environmentParam, entityId: guid, definition: definitionParam, policyOverride: policyOverrideParam },
+        description: "Entity'ye automation bağlar. definition = CreateWorkflowCommand gövdesi ('automation' nesnesi içermeli; entityId route'tan set edilir). İlk kullanımdan önce platform_guide('workflow') okuyun; gövde politika kontrolünden geçer. " + constraintSummary('CreateWorkflowCommand'),
+        inputSchema: { project: projectParam, environment: environmentParam, entityId: entityRef, definition: definitionParam, policyOverride: policyOverrideParam },
         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 payload = await platform.tenant('POST', project, `/entities/${entityId}/automation`, { environment, body: definition });
-        return attachFindings(withNormalization(payload, normalized), findings);
+        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 });
+        return attachFindings(withResolved(withNormalization(payload, normalized), resolver.resolved), findings);
     }));
     server.registerTool('automation_update', {
         title: 'Automation güncelle',
-        description: "Automation tanımını günceller. definition = UpdateWorkflowCommand gövdesi ('automation' nesnesi içermeli); gövde politika kontrolünden geçer.",
-        inputSchema: { project: projectParam, environment: environmentParam, entityId: guid, id: guid, definition: definitionParam, policyOverride: policyOverrideParam },
+        description: "Automation tanımını günceller. definition = UpdateWorkflowCommand gövdesi ('automation' nesnesi içermeli); gövde politika kontrolünden geçer. " + constraintSummary('UpdateWorkflowCommand'),
+        inputSchema: { project: projectParam, environment: environmentParam, entityId: entityRef, id: guid, definition: definitionParam, policyOverride: policyOverrideParam },
         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 payload = await platform.tenant('PUT', project, `/entities/${entityId}/automation/${id}`, { environment, body: definition });
-        return attachFindings(withNormalization(payload, normalized), findings);
+        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 });
+        return attachFindings(withResolved(withNormalization(payload, normalized), resolver.resolved), findings);
     }));
     server.registerTool('automation_delete', {
         title: 'Automation sil',
         description: 'Automation\'ı siler.',
-        inputSchema: { project: projectParam, environment: environmentParam, entityId: guid, id: guid },
+        inputSchema: { project: projectParam, environment: environmentParam, entityId: entityRef, id: guid },
         annotations: destructive
-    }, handle(config, ({ project, environment, entityId, id }) => platform.tenant('DELETE', project, `/entities/${entityId}/automation/${id}`, { environment })));
+    }, handle(config, async ({ project, environment, entityId, id }) => {
+        const resolver = new RefResolver(platform, project, environment);
+        const resolvedEntityId = await resolveEntityId(resolver, entityId);
+        return withResolved(await platform.tenant('DELETE', project, `/entities/${resolvedEntityId}/automation/${id}`, { environment }), resolver.resolved);
+    }));
     server.registerTool('automation_reorder', {
         title: 'Automation sırasını değiştir',
         description: "Entity'nin automation'larının çalışma sırasını toplu günceller; aynı operasyona bağlı birden çok automation'da sıra davranışı belirler.",
         inputSchema: {
             project: projectParam,
             environment: environmentParam,
-            entityId: guid,
+            entityId: entityRef,
             automations: z.array(z.object({ id: guid, order: z.number().int().min(0) })).min(1)
                 .describe('Tüm automation\'lar için (id, order) çiftleri; listeyi automation_list ile kurun')
         },
         annotations: updates
-    }, handle(config, ({ project, environment, entityId, automations }) => platform.tenant('PUT', project, `/entities/${entityId}/automation/orders`, { environment, body: { automations } })));
+    }, handle(config, async ({ project, environment, entityId, automations }) => {
+        const resolver = new RefResolver(platform, project, environment);
+        const resolvedEntityId = await resolveEntityId(resolver, entityId);
+        return withResolved(await platform.tenant('PUT', project, `/entities/${resolvedEntityId}/automation/orders`, { environment, body: { automations } }), resolver.resolved);
+    }));
     server.registerTool('automation_trigger', {
         title: 'Automation tetikle',
-        description: 'Automation\'ı elle tetikler. Fire-and-forget çalışır: sonuç bu yanıtta dönmez, automation_histories ile izleyin.',
+        description: "Automation'ı elle tetikler — CANLI çalıştırır, gerçek satır yazar. Fire-and-forget: sonuç bu yanıtta dönmez, automation_histories + row_list ile izleyin. VERİ ÜRETMEK İÇİN KULLANMAYIN: rowContext almaz, bu yüzden yazdığı her zaman damgası UtcNow() olur — tarihsel bir tohumun üstünde tek bir doğrulama çağrısı huni ortalamasını bozar (B-52). Akışın ŞEKLİNİ sınamak istiyorsanız automation_preview kullanın: automation da bir workflow'dur, preview tek transaction'da koşar ve geri alınır, yani hiçbir satır kalmaz.",
         inputSchema: {
             project: projectParam,
             environment: environmentParam,
-            entityId: guid,
+            entityId: entityRef,
             id: guid,
             operation: z.string().optional(),
             recordIds: z.array(z.union([z.string(), z.number()])).optional().describe('Tetiklenecek satır id\'leri')
         },
         annotations: writes
-    }, handle(config, ({ project, environment, entityId, id, operation, recordIds }) => platform.tenant('POST', project, `/entities/${entityId}/automation/${id}/trigger`, {
-        environment,
-        body: { operation, recordIds: recordIds ?? [] }
-    })));
+    }, handle(config, async ({ project, environment, entityId, id, operation, recordIds }) => {
+        const resolver = new RefResolver(platform, project, environment);
+        const resolvedEntityId = await resolveEntityId(resolver, entityId);
+        return withResolved(await platform.tenant('POST', project, `/entities/${resolvedEntityId}/automation/${id}/trigger`, {
+            environment,
+            body: { operation, recordIds: recordIds ?? [] }
+        }), resolver.resolved);
+    }));
     server.registerTool('automation_histories', {
         title: 'Automation geçmişi',
         description: 'Automation çalıştırma geçmişini listeler; automation_trigger sonrası sonucu buradan doğrulayın.',
         inputSchema: {
             project: projectParam,
             environment: environmentParam,
-            entityId: guid,
+            entityId: entityRef,
             id: guid,
             status: z.string().optional().describe('EventStatus filtresi'),
             ...pagingParams
         },
         annotations: readOnly
-    }, handle(config, ({ project, environment, entityId, id, ...query }) => platform.tenant('GET', project, `/entities/${entityId}/automation/${id}/histories`, { environment, query })));
+    }, handle(config, async ({ project, environment, entityId, id, ...query }) => {
+        const resolver = new RefResolver(platform, project, environment);
+        const resolvedEntityId = await resolveEntityId(resolver, entityId);
+        return withResolved(await platform.tenant('GET', project, `/entities/${resolvedEntityId}/automation/${id}/histories`, { environment, query }), resolver.resolved);
+    }));
     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.',
-        inputSchema: { project: projectParam, environment: environmentParam, entityId: guid, definition: definitionParam, policyOverride: policyOverrideParam },
+        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, 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 }) => {
+    }, 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 payload = await platform.tenant('POST', project, `/entities/${entityId}/automation/preview`, { environment, body: definition });
-        return attachFindings(withNormalization(payload, normalized), findings);
+        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) });
+        return attachFindings(withResolved(withNormalization(payload, normalized), resolver.resolved), findings);
     }));
 }