@appaflytech/zeyrek-ai-mcp 0.0.6 → 0.0.8

package/.env.example

@@ -56,8 +56,8 @@ SCREENSHOT_BROWSER_PATH=
 ORG_SWAGGER_URL=
 TENANT_SWAGGER_URL=
 
-# Bos = tum moduller (167 tool / 27 modul). Hazir kumeler: core (veri+mantik, 97), studio
-# (sayfa tasarimi, 59), admin (template/organizasyon/deployment, 16). platform modulu (3 tool)
+# Bos = tum moduller (172 tool / 28 modul). Hazir kumeler: core (veri+mantik, 97), studio
+# (sayfa tasarimi + kullanici fonksiyonlari, 66), admin (template/organizasyon/deployment, 15). platform modulu (3 tool)
 # her kumede vardir. Kume ve tekil modul adi karisik yazilabilir.
 # Ornek: core,studio  |  entity,row,microservice
 MODULES=

package/.env.production.example

@@ -12,6 +12,14 @@ TENANT_API_BASE_URL=https://new-zeyrek.glomil.com/api
 ORGANIZATION=new-zeyrek
 HOST_SUFFIX=glomil.com
 
+# Ikinci uzak kurulum (wappa kumesi, ayri veritabani; docs/ortam.md). Ona baglanmak icin
+# yukaridaki dort satiri ve asagidaki STUDIO_BASE_URL'i bunlarla degistirin:
+#   ORG_API_BASE_URL=https://zeyrek.appaflytech.com/api/org
+#   TENANT_API_BASE_URL=https://zeyrek.appaflytech.com/api
+#   ORGANIZATION=zeyrek
+#   HOST_SUFFIX=appaflytech.com
+#   STUDIO_BASE_URL=https://zeyrek.appaflytech.com
+
 # ZORUNLU. Gomulu varsayilan yok.
 DEFAULT_ENVIRONMENT=development
 DEFAULT_PROJECT=

package/README.md

@@ -4,10 +4,11 @@ Zeyrek (NgApps) platformunu **MCP tool'ları** olarak sunan bağımsız gateway.
 oturumu Studio arayüzüne hiç girmeden proje kurabilir, veri modeli çıkarabilir, mikroservis ve
 workflow yazıp çalıştırabilir, sayfa tasarlayabilir.
 
-- **167 tool · 27 modül** — veri/mantık tarafı (project, application, datasource, entity, row,
-  microservice, query, workflow, automation, global function, dto, view, dependency), Studio tasarım tarafı
-  (page, component, external component, flow, layout, variable, folder, file, access,
-  translation) ve yönetim (template, organization, deployment).
+- **191 tool · 32 modül** — veri/mantık tarafı (project, application, datasource, entity, row,
+  import, microservice, query, workflow, automation, function, dto, view, dependency), Studio
+  tasarım tarafı (page, component, external component, flow, layout, variable, function, folder,
+  file, access, translation), yönetim (template, organization, deployment) ve proje dallanması
+  (environment, merge).
 - Platform koduna referans vermez: Organization.API ile Tenant.API'yi **HTTP üzerinden** sarar —
   istekler MVC binding'den geçtiği için FluentValidation aynen çalışır.
 - Üstünde bir **bilgi katmanı** vardır (rehber + altın örnek + politika lint'i): platformun
@@ -137,10 +138,10 @@ ya da ikisi karışık (`core,page`). `platform` modülü (3 tool) her kümede v
 
 | Küme | Tool | Modüller |
 |---|---|---|
-| `core` | 93 | platform, project, application, datasource, entity, row, microservice, query, workflow, automation, dto, view, dependency |
-| `studio` | 59 | platform, page, component, externalComponent, flow, layout, variable, folder, file, access, translation |
-| `admin` | 16 | platform, template, organization, deployment |
-| (boş) | **167** | 27 modülün tamamı |
+| `core` | 111 | platform, project, application, datasource, entity, row, microservice, query, workflow, automation, function, dto, view, dependency, environment, merge, activity, revision |
+| `studio` | 69 | platform, page, component, externalComponent, flow, layout, variable, function, folder, file, access, translation, revision |
+| `admin` | 26 | platform, template, organization, deployment, environment, merge, activity |
+| (boş) | **185** | 32 modülün tamamı |
 
 Bilinmeyen bir modül/küme adı verilirse sunucu açılmaz, geçerli adları listeleyen bir hata yazar.
 

package/dist/config.js

@@ -7,11 +7,12 @@ export const moduleNames = [
     "datasource",
     "entity",
     "row",
+    "import",
     "microservice",
+    "microfunction",
     "query",
     "workflow",
     "automation",
-    "globalFunction",
     "dto",
     "view",
     "page",
@@ -20,6 +21,7 @@ export const moduleNames = [
     "flow",
     "layout",
     "variable",
+    "function",
     "folder",
     "file",
     "access",
@@ -28,6 +30,10 @@ export const moduleNames = [
     "organization",
     "dependency",
     "deployment",
+    "environment",
+    "merge",
+    "activity",
+    "revision",
 ];
 export const modulePresets = {
     core: [
@@ -37,14 +43,20 @@ export const modulePresets = {
         "datasource",
         "entity",
         "row",
+        "import",
         "microservice",
+        "microfunction",
         "query",
         "workflow",
         "automation",
-        "globalFunction",
+        "function",
         "dto",
         "view",
         "dependency",
+        "environment",
+        "merge",
+        "activity",
+        "revision",
     ],
     studio: [
         "platform",
@@ -54,12 +66,15 @@ export const modulePresets = {
         "flow",
         "layout",
         "variable",
+        "function",
         "folder",
         "file",
+        "import",
         "access",
         "translation",
+        "revision",
     ],
-    admin: ["platform", "template", "organization", "deployment"],
+    admin: ["platform", "template", "organization", "deployment", "environment", "merge", "activity"],
 };
 function expandModuleNames(entries) {
     const modules = [];

package/dist/knowledge/backendConstraints.js

@@ -417,6 +417,9 @@ function microserviceFindings(body) {
             findings.push(`sourceParameters.fields[${index}]: writeOn:'${String(field.writeOn)}' yalnız operation:'upsert' ucunda anlamlı; bu uç '${operation ?? '?'}' — writeOn'u kaldırın ya da 'always' bırakın (Fields.All(WriteOn == Always) when Operation != Upsert).`);
         }
     });
+    if (body.source === 'table' && operation !== undefined && operation.startsWith('bulk-') && asObjects(parameters.filters).length > 0) {
+        findings.push(`sourceParameters.filters: '${operation}' ucu filtre KULLANMAZ — bulk create/update satırları gövdeden, bulk delete birincil anahtarları gövdeden okur. Filtreleri kaldırın.`);
+    }
     flattenFilters(parameters.filters).forEach((filter, index) => {
         if (!isSingleFilter(filter))
             return;
@@ -565,6 +568,71 @@ function datasourceFindings(body) {
     }
     return findings;
 }
+const MICROFUNCTION_ENTRYPOINT_PATTERN = /^[A-Za-z_][\w./-]*\.[A-Za-z_]\w*$/;
+const MICROFUNCTION_ENVIRONMENT_KEY_PATTERN = /^[A-Z_][A-Z0-9_]*$/;
+const MICROFUNCTION_ROLE_ARN_PATTERN = /^arn:aws:iam::\d{12}:role\/.+$/;
+/**
+ * `MicrofunctionOptions.Limits` ile de sınırlanır (kök `.env`); buradaki değerler
+ * `MicrofunctionConstants`'ın sabit tavanıdır — ayar daha dar bir tavan koyduysa platform onu
+ * uygular ve gateway'in geçirdiği gövde 422 döner. Ters yön olmaz: buradan geçmeyen gövde
+ * platformda da geçmez.
+ */
+function microfunctionFindings(body) {
+    const provider = isPresent(body.provider) ? String(body.provider) : 'built-in';
+    const sourceKind = isPresent(body.sourceKind) ? String(body.sourceKind) : 'inline';
+    const findings = [];
+    if (provider === 'azure-functions') {
+        findings.push("provider: 'azure-functions' v1'de seçilemez (MicrofunctionProviderNotSupported). Enum değeri tanımlı ama connector'ı yok — 'built-in' (platformun kendi Fission kümesi) ya da 'aws-lambda' kullanın.");
+    }
+    if (provider === 'aws-lambda' && !isPresent(body.runtimeId)) {
+        findings.push("runtimeId: provider 'aws-lambda' iken zorunlu (MicrofunctionRuntimeRequired) — fonksiyonun hangi AWS hesabında koşacağı kayıttan gelir. microfunction_runtime_list ile hesabı seçin.");
+    }
+    if (provider === 'built-in' && isPresent(body.runtimeId)) {
+        findings.push("runtimeId: provider 'built-in' iken VERİLMEZ (MicrofunctionRuntimeNotAllowedForBuiltIn) — Built-In fonksiyon platformun kendi kümesinde koşar, bulut hesabı kaydı yoktur.");
+    }
+    if (sourceKind === 'inline' && !hasText(body.code)) {
+        findings.push("code: sourceKind 'inline' iken zorunlu (MicrofunctionCodeRequired).");
+    }
+    if (sourceKind === 'archive' && !(hasText(body.entrypoint) && MICROFUNCTION_ENTRYPOINT_PATTERN.test(body.entrypoint))) {
+        findings.push(`entrypoint: sourceKind 'archive' iken 'modül.fonksiyon' biçiminde zorunlu (MicrofunctionEntrypointInvalid, desen ${MICROFUNCTION_ENTRYPOINT_PATTERN.source}), ör. 'handlers/sum.handler'.`);
+    }
+    // Komut alanları non-nullable int: gönderilmezse gövdeye 0 gider ve platform 422 döner. Gateway
+    // değer UYDURMAZ (0 ile 30 arasındaki fark faturalandırmayı da davranışı da değiştirir), yalnız
+    // eksikliği çağrıdan önce söyler.
+    const timeoutCeiling = provider === 'aws-lambda' ? 900 : 300;
+    if (!isPresent(body.timeoutSeconds)) {
+        findings.push(`timeoutSeconds: alan non-nullable int — gönderilmezse 0 gider ve platform 422 döner (MicrofunctionTimeoutOutOfRange). 1–${timeoutCeiling} arası bir değer verin (ürün varsayılanı 30).`);
+    }
+    else if (Number(body.timeoutSeconds) < 1 || Number(body.timeoutSeconds) > timeoutCeiling) {
+        findings.push(`timeoutSeconds: ${String(body.timeoutSeconds)} — provider '${provider}' için geçerli aralık 1–${timeoutCeiling} (MicrofunctionTimeoutOutOfRange).`);
+    }
+    if (!isPresent(body.memoryMb)) {
+        findings.push('memoryMb: alan non-nullable int — gönderilmezse 0 gider ve platform 422 döner (MicrofunctionMemoryOutOfRange). 128–3008 arası bir değer verin (ürün varsayılanı 256).');
+    }
+    const environmentVariables = asObject(body.environmentVariables);
+    if (environmentVariables !== undefined) {
+        const invalidKeys = Object.keys(environmentVariables).filter(key => !MICROFUNCTION_ENVIRONMENT_KEY_PATTERN.test(key));
+        const bytes = Object.entries(environmentVariables)
+            .reduce((total, [key, value]) => total + Buffer.byteLength(key, 'utf8') + Buffer.byteLength(value === null || value === undefined ? '' : String(value), 'utf8'), 0);
+        if (invalidKeys.length > 0) {
+            findings.push(`environmentVariables: anahtarlar ${MICROFUNCTION_ENVIRONMENT_KEY_PATTERN.source} desenine uymalı (MicrofunctionEnvironmentVariableKeyInvalid) — uymayanlar: ${invalidKeys.join(', ')}.`);
+        }
+        if (bytes > 4096) {
+            findings.push(`environmentVariables: anahtar+değer toplamı ${bytes} bayt, üst sınır 4096 (Lambda sınırı; MicrofunctionEnvironmentVariablesTooLarge).`);
+        }
+    }
+    return findings;
+}
+function microfunctionRuntimeFindings(body) {
+    const findings = [];
+    if (isPresent(body.provider) && String(body.provider) !== 'aws-lambda') {
+        findings.push(`provider: runtime hesabı v1'de yalnız 'aws-lambda' olabilir (MicrofunctionProviderNotSupported); '${String(body.provider)}' reddedilir. Built-In fonksiyonların runtime kaydı YOKTUR.`);
+    }
+    if (!(hasText(body.roleArn) && MICROFUNCTION_ROLE_ARN_PATTERN.test(body.roleArn))) {
+        findings.push(`roleArn: zorunlu ve ${MICROFUNCTION_ROLE_ARN_PATTERN.source} desenine uymalı (MicrofunctionRuntimeRoleArnInvalid) — fonksiyonun koşacağı Lambda execution rolü, ör. 'arn:aws:iam::123456789012:role/zeyrek-microfunction'.`);
+    }
+    return findings;
+}
 function projectCreateFindings(body) {
     if (!isPresent(body.templateOptions) && !isPresent(body.application)) {
         return ["application: 'Application' must not be empty. — templateOptions verilmeyen projede ilk application projeyle birlikte açılır: application { slug, name } zorunlu."];
@@ -790,6 +858,26 @@ export const backendRules = [
         sourceRef: 'UploadFileCommandValidator: File.NotNull(), File.Must(IsContainsSpecialChar(FileName))',
         check: body => nameCharacterFindings('filename', body.filename)
     },
+    {
+        id: 'MF-001',
+        module: 'microfunction',
+        commands: { create: 'CreateMicrofunctionCommand', update: 'UpdateMicrofunctionCommand' },
+        status: 422,
+        summary: "provider 'built-in' ⇒ runtimeId boş, 'aws-lambda' ⇒ runtimeId zorunlu, 'azure-functions' reddedilir · sourceKind 'inline' ⇒ code, 'archive' ⇒ 'modül.fonksiyon' biçiminde entrypoint · timeoutSeconds ve memoryMb GÖNDERİLMEK ZORUNDA (non-nullable int, eksikse 0 gider) · env anahtarları ^[A-Z_][A-Z0-9_]*$ ve toplam ≤ 4 KB",
+        sourceRef: 'CreateMicrofunctionCommandValidator / UpdateMicrofunctionCommandValidator (ikisi birebir aynı kural kümesi) + MicrofunctionConstants (EntrypointPattern, EnvironmentVariableKeyPattern, BuiltInMaxTimeoutSeconds 300, CloudMaxTimeoutSeconds 900, MinMemoryMb 128, MaxMemoryMb 3008, MaxEnvironmentVariablesBytes 4096)',
+        guide: 'ngapps://guides/microfunction',
+        check: body => microfunctionFindings(body)
+    },
+    {
+        id: 'MFR-001',
+        module: 'microfunctionRuntime',
+        commands: { create: 'CreateMicrofunctionRuntimeCommand', update: 'UpdateMicrofunctionRuntimeCommand' },
+        status: 422,
+        summary: "provider yalnız 'aws-lambda' · roleArn zorunlu ve arn:aws:iam::<12 hane>:role/<ad> desenli",
+        sourceRef: 'CreateMicrofunctionRuntimeCommandValidator / UpdateMicrofunctionRuntimeCommandValidator + MicrofunctionConstants.RoleArnPattern',
+        guide: 'ngapps://guides/microfunction',
+        check: body => microfunctionRuntimeFindings(body)
+    },
     {
         id: 'EXT-001',
         module: 'externalComponent',