@appaflytech/zeyrek-ai-mcp 0.0.5 → 0.0.7

package/.env.example

@@ -56,8 +56,8 @@ SCREENSHOT_BROWSER_PATH=
 ORG_SWAGGER_URL=
 TENANT_SWAGGER_URL=
 
-# Bos = tum moduller (162 tool / 26 modul). Hazir kumeler: core (veri+mantik, 93), 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=
@@ -38,7 +46,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,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.
 
-- **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ı
-  (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ş) | **162** | 26 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.
 
@@ -198,36 +199,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",
@@ -6,7 +7,9 @@ export const moduleNames = [
     "datasource",
     "entity",
     "row",
+    "import",
     "microservice",
+    "microfunction",
     "query",
     "workflow",
     "automation",
@@ -18,6 +21,7 @@ export const moduleNames = [
     "flow",
     "layout",
     "variable",
+    "function",
     "folder",
     "file",
     "access",
@@ -26,6 +30,10 @@ export const moduleNames = [
     "organization",
     "dependency",
     "deployment",
+    "environment",
+    "merge",
+    "activity",
+    "revision",
 ];
 export const modulePresets = {
     core: [
@@ -35,13 +43,20 @@ export const modulePresets = {
         "datasource",
         "entity",
         "row",
+        "import",
         "microservice",
+        "microfunction",
         "query",
         "workflow",
         "automation",
+        "function",
         "dto",
         "view",
         "dependency",
+        "environment",
+        "merge",
+        "activity",
+        "revision",
     ],
     studio: [
         "platform",
@@ -51,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 = [];
@@ -97,8 +115,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 +146,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 +223,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,
     };
 }