@appaflytech/zeyrek-ai-mcp 0.0.5 → 0.0.6

package/.env.example

@@ -56,7 +56,7 @@ SCREENSHOT_BROWSER_PATH=
 ORG_SWAGGER_URL=
 TENANT_SWAGGER_URL=
 
-# Bos = tum moduller (162 tool / 26 modul). Hazir kumeler: core (veri+mantik, 93), studio
+# 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)
 # her kumede vardir. Kume ve tekil modul adi karisik yazilabilir.
 # Ornek: core,studio  |  entity,row,microservice

package/.env.production.example

@@ -38,7 +38,7 @@ SCREENSHOT_BROWSER_PATH=
 ORG_SWAGGER_URL=
 TENANT_SWAGGER_URL=
 
-# Bos = tum moduller (162 tool). Kumeler: core (93) | studio (59) | admin (16).
+# Bos = tum moduller (167 tool). Kumeler: core (97) | studio (59) | admin (16).
 MODULES=
 
 MCP_PORT=5100

package/README.md

@@ -4,8 +4,8 @@ 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.
 
-- **162 tool · 26 modül** — veri/mantık tarafı (project, application, datasource, entity, row,
-  microservice, query, workflow, automation, dto, view, dependency), Studio tasarım tarafı
+- **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).
 - Platform koduna referans vermez: Organization.API ile Tenant.API'yi **HTTP üzerinden** sarar —
@@ -140,7 +140,7 @@ ya da ikisi karışık (`core,page`). `platform` modülü (3 tool) her kümede v
 | `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ş) | **162** | 26 modülün tamamı |
+| (boş) | **167** | 27 modülün tamamı |
 
 Bilinmeyen bir modül/küme adı verilirse sunucu açılmaz, geçerli adları listeleyen bir hata yazar.
 
@@ -198,36 +198,11 @@ Tam gövdeyi LLM bağlamına sokmadan çalışma modeli:
 
 ## Tool çağrısı günlüğü
 
-Her MCP tool çağrısı, okunmak için biçimlenmiş tek bir blok olarak dosyaya yazılır — varsayılan
-`{LOG_DIR}/gateway-YYYY-AA-GG.log`. Amaç: bir çağrının ne yapmaya çalıştığını, hangi duraklardan
-geçtiğini ve nerede patladığını **koda inmeden** okuyabilmek.
-
-```
-┌─ #1 · 11:27:27.082 · platform_whoami — Oturum bilgisi
-│  amaç   : Gateway'in platformda kimin adına çalıştığını döner; auth kurulumunu doğrulamak için ilk çağrılacak tool.
-│  girdi  : (parametresiz)
-│  adımlar:
-│    +2ms      kimlik →    önbellekte geçerli token yok — POST http://localhost:7000/connect/token · kullanıcı admin@zeyrek.com
-│    +229ms    kimlik ←    HTTP 200 · token alındı, önbellekte 63158340 sn geçerli
-│    +229ms    istek →     GET http://localhost:7000/connect/userinfo · org api · env=development
-│    +237ms    yanıt ←     HTTP 200 · 8 ms · 174 B
-│                          gövde: {"sub":"01917edf-…","email":"admin@zeyrek.com","role":["super-admin"]}
-└─ SONUÇ  : başarılı · 238 ms · 4 adım · 137 B yanıt
-```
-
-Adım etiketleri: `politika` (lint kuralları; `politika ✕` isteği hiç göndermez), `düzeltme`
-(gateway'in gövdeye uyguladığı otomatik düzeltmeler — yanıttaki `gatewayNormalized`),
-`kimlik →/←` (`/connect/token` turu), `istek →/yanıt ←` (platform API turu, tam URL + süre +
-boyut), `kırpma ✂` (yanıt `MAX_RESPONSE_BYTES` sınırını aştı), `tarayıcı →/←`
-(`page_screenshot`'ın headless Chromium turu), `hata ✕` (yakalanan hata: sınıf, HTTP kodu, mesaj,
-ilk 3 stack satırı). Tool gövdesine hiç girmeyen çağrılar — yanlış tool adı ya da parametre
-şemasına takılan gövde — `MCP KATMANI REDDETTİ` bloğu olarak düşer.
-
-Arama: `SONUÇ  : HATA` tüm başarısız çağrılar, `hata ✕` hata satırları, `#<n>` tek bir çağrı.
-
-Adı `pass|secret|token|authorization|api key|credential|connectionString` desenine uyan alanlar
-`***` ile maskelenir. Günlükleme yazma hatası tool çağrısını **düşürmez**: ilk hatada stderr'e
-tek satır yazılıp günlükleme kapatılır.
+Her MCP tool çağrısı, okunmak için biçimlenmiş tek bir blok olarak
+`zeyrek-mcp/logs/gateway-YYYY-MM-DD.log` dosyasına yazılır (`.gitignore`'da; `LOG_LEVEL=detail|summary|off`).
+Hızlı arama: `SONUÇ  : HATA` tüm başarısız çağrılar, `#<n>` tek bir çağrı. Blok formatı, adım
+etiketleri, diğer `LOG_*` ayarları ve maskeleme:
+[`docs/30-tool-cagri-gunlugu.md`](docs/30-tool-cagri-gunlugu.md).
 
 ## Sorun giderme
 

package/dist/config.js

@@ -1,3 +1,4 @@
+import { userInfo } from "node:os";
 import { z } from "zod";
 export const moduleNames = [
     "platform",
@@ -10,6 +11,7 @@ export const moduleNames = [
     "query",
     "workflow",
     "automation",
+    "globalFunction",
     "dto",
     "view",
     "page",
@@ -39,6 +41,7 @@ export const modulePresets = {
         "query",
         "workflow",
         "automation",
+        "globalFunction",
         "dto",
         "view",
         "dependency",
@@ -97,8 +100,22 @@ const environmentSchema = z.object({
     MCP_PORT: z.coerce.number().int().positive().default(5100),
     STUDIO_BASE_URL: z.string().url().optional(),
     SCREENSHOT_BROWSER_PATH: z.string().min(1).optional(),
+    SCREENSHOT_QUEUE_WAIT_MS: z.coerce.number().int().positive().default(120000),
 });
 export const environmentKeys = Object.keys(environmentSchema.shape);
+/**
+ * Makine kullanıcısının adı. Windows `USER`/`LOGNAME` tanımlamaz — o ikisi POSIX kabuklarına
+ * aittir — bu yüzden `USERNAME` gölgelemesinin HER ZAMAN yaşandığı platformda kıyaslanacak ad
+ * yalnız buradan gelir. Kısıtlı ortamlarda çağrı fırlatabildiği için sarılıdır.
+ */
+function machineUserName() {
+    try {
+        return userInfo().username;
+    }
+    catch {
+        return undefined;
+    }
+}
 /**
  * `.mcp.json` env bloğundan gelen KULLANILAMAZ değerleri süreç ortamından düşürür ki `.env`
  * (dotenv mevcut anahtarları ezmez) ve şema varsayılanları devreye girebilsin. İki hâl
@@ -114,14 +131,14 @@ export const environmentKeys = Object.keys(environmentSchema.shape);
  * sisteminin kullanıcı adıyla AYNIYSA düşürülür: gerçekten o adla giren bir kurulum zaten
  * `.env`/`.mcp.json`'da aynı değeri yazar ve dosyadan geri okunur.
  */
-export function dropUnusableEnvironment(env) {
+export function dropUnusableEnvironment(env, osUserName = machineUserName()) {
     for (const key of environmentKeys) {
         const value = env[key];
         if (value === "" || (value !== undefined && /^\$\{[^}]*\}$/.test(value))) {
             delete env[key];
         }
     }
-    const osUser = env.USER ?? env.LOGNAME;
+    const osUser = env.USER ?? env.LOGNAME ?? osUserName;
     if (env.USERNAME !== undefined && env.USERNAME === osUser) {
         delete env.USERNAME;
     }
@@ -191,5 +208,6 @@ export function loadConfig(env) {
         port: values.MCP_PORT,
         studioBaseUrl: values.STUDIO_BASE_URL?.replace(/\/+$/, ""),
         screenshotBrowserPath: values.SCREENSHOT_BROWSER_PATH,
+        screenshotQueueWaitMs: values.SCREENSHOT_QUEUE_WAIT_MS,
     };
 }