@appaflytech/zeyrek-ai-mcp 0.0.3 → 0.0.4

package/dist/tools/screens.js

@@ -1,4 +1,5 @@
 import { PlatformApiError } from '../platform/errors.js';
+import { resolveNodeStyleReport } from '../knowledge/styleResolve.js';
 import { z } from 'zod';
 export const hostParam = z.enum(['page', 'layout', 'component'])
     .describe("Akışın barındırıcısı: page | layout | component (widget de component'tir)");
@@ -6,6 +7,41 @@ export const schemaParam = z.array(z.record(z.unknown()))
     .describe('Komponent ağacı (DesignComponentManagementSchema listesi); verilmezse mevcut şema korunur');
 export const eventsParam = z.array(z.record(z.unknown()))
     .describe("Sayfa/layout düzeyi olaylar: [{ name, value }] — value bir flow id'sidir");
+export const modeParam = z.enum(['summary', 'subtree', 'full']).optional().describe("summary (varsayılan): yalnız id/elementId/name/type ağacı — hedef bulmak için bunu kullanın. subtree: componentId ile tek alt ağaç. full: tüm şema.");
+/**
+ * Ağacı yalnız kimlik alanlarına indirger; hedef aramak için okunur boyutta tutar.
+ * `styleSource` verilirse (undefined DEĞİLSE) her düğüme efektif stil raporu da
+ * yazılır: tema componentStyles → preset → düğümün kendi stili kaskadı.
+ */
+export function summarize(node, styleSource) {
+    const summary = {
+        id: node.id,
+        elementId: node.elementId,
+        name: node.name,
+        type: node.type
+    };
+    if (styleSource !== undefined) {
+        const report = resolveNodeStyleReport(node, styleSource ?? undefined);
+        if (report.resolvedStyle !== undefined)
+            summary.resolvedStyle = report.resolvedStyle;
+        summary.styleLayers = report.styleLayers;
+    }
+    if (Array.isArray(node.children) && node.children.length > 0) {
+        summary.children = node.children.map(child => summarize(child, styleSource));
+    }
+    return summary;
+}
+/** elementId ya da id ile ağaçta düğüm bulur. */
+export function findNode(nodes, target) {
+    for (const node of nodes ?? []) {
+        if (node.elementId === target || String(node.id) === target)
+            return node;
+        const found = findNode(node.children, target);
+        if (found)
+            return found;
+    }
+    return undefined;
+}
 function asArray(value) {
     return Array.isArray(value) ? value : [];
 }

package/dist/tools/workflows.js

@@ -106,7 +106,7 @@ export function registerWorkflowTools(server, platform) {
     }));
     server.registerTool('workflow_create', {
         title: 'Workflow oluştur',
-        description: "Yeni workflow tanımlar (definition = CreateWorkflowCommand). type: 'workflow' | 'automation' | 'middleware'. İlk kullanımdan önce platform_guide('workflow') okuyun: DTO-önce akışı, branch bağlama (branches[].nextStepId), tip×step matrisi. Middleware (istek öncesi koşan guard/setter, user değişkeni, alfabetik sıra) için platform_guide('middleware') + ngapps://examples/middleware-authenticate. Gövde politika kontrolünden geçer.",
+        description: "Yeni workflow tanımlar (definition = CreateWorkflowCommand). type: 'workflow' | 'automation' | 'middleware'. İlk kullanımdan önce platform_guide('workflow') okuyun: DTO-önce akışı, branch bağlama (branches[].nextStepId), tip×step matrisi. Her adım ve akışın kendisi 'description' taşımak ZORUNDADIR (WF-024, block): adımın NE İŞE YARADIĞINI 1-2 cümleyle yazın — Studio kanvasında ⓘ ikonu olarak görünür; mekanizmayı değil niyeti yazın. Middleware (istek öncesi koşan guard/setter, user değişkeni, alfabetik sıra) için platform_guide('middleware') + ngapps://examples/middleware-authenticate. Adımın gerçek bir tuzağı varsa (idempotent değil, kapsam adımda değil, dış bağımlılık, sessiz düşen dal) 'caution' alanına yazın — OPSİYONELDİR, tuzak yoksa boş bırakın; doldurma metin yazmayın. Gövde politika kontrolünden geçer.",
         inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, definition: definitionParam, policyOverride: policyOverrideParam },
         annotations: writes
     }, handle(config, async ({ project, environment, applicationId, definition, policyOverride }) => {
@@ -117,7 +117,7 @@ export function registerWorkflowTools(server, platform) {
     }));
     server.registerTool('workflow_update', {
         title: 'Workflow güncelle',
-        description: 'Workflow tanımını günceller (definition = UpdateWorkflowCommand, tam gövde). Hedefli değişiklik için workflow_patch tercih edin. Gövde politika kontrolünden geçer.',
+        description: 'Workflow tanımını günceller (definition = UpdateWorkflowCommand, tam gövde). Hedefli değişiklik için workflow_patch tercih edin. Her adım ve akışın kendisi \'description\' taşımak ZORUNDADIR (WF-024, block). Adımın gerçek bir tuzağı varsa (idempotent değil, kapsam adımda değil, dış bağımlılık, sessiz düşen dal) \'caution\' alanına yazın — OPSİYONELDİR, tuzak yoksa boş bırakın; doldurma metin yazmayın. Gövde politika kontrolünden geçer.',
         inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, id: guid, definition: definitionParam, policyOverride: policyOverrideParam },
         annotations: updates
     }, handle(config, async ({ project, environment, applicationId, id, definition, policyOverride }) => {
@@ -128,7 +128,7 @@ export function registerWorkflowTools(server, platform) {
     }));
     server.registerTool('workflow_patch', {
         title: 'Workflow\'a patch uygula',
-        description: 'Tam gövdeyi bağlama almadan hedefli değişiklik: gateway mevcut workflow\'u çeker, JSON Patch işlemlerini uygular, politika kontrolünden geçirir, tam gövdeyi geri yazar. Yanıt outline özetidir.',
+        description: 'Tam gövdeyi bağlama almadan hedefli değişiklik: gateway mevcut workflow\'u çeker, JSON Patch işlemlerini uygular, politika kontrolünden geçirir, tam gövdeyi geri yazar. Değişiklik hedefli ama yazma değil: hata yolu olmayan bir workflow/middleware kaydına patch atmak o kaydın grafiğini de düzeltir — start adımına global-error dalı + 500 dönen response adımı eklenir ve yanıtta gatewayNormalized ile bildirilir. Yanıt outline özetidir.',
         inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, id: guid, operations: patchOperationsParam, policyOverride: policyOverrideParam },
         annotations: updates
     }, handle(config, async ({ project, environment, applicationId, id, operations, policyOverride }) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appaflytech/zeyrek-ai-mcp",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "type": "module",
   "description": "MCP gateway exposing the NgApps platform APIs as tools",
   "license": "UNLICENSED",
@@ -13,6 +13,7 @@
   "files": [
     "dist",
     ".env.example",
+    ".env.production.example",
     "README.md"
   ],
   "publishConfig": {
@@ -26,6 +27,7 @@
     "prepack": "npm run build",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
+    "docs:lint": "tsx scripts/docs-lint.ts",
     "generate-schemas": "tsx scripts/generate-schemas.ts",
     "generate-reserved-tables": "tsx scripts/generate-reserved-tables.ts",
     "harvest-examples": "tsx scripts/harvest-examples.ts"
@@ -36,6 +38,7 @@
     "express": "^4.21.0",
     "fast-json-patch": "^3.1.1",
     "pino": "^9.5.0",
+    "playwright-core": "^1.49.0",
     "undici": "^7.3.0",
     "zod": "^3.24.1"
   },