@appaflytech/zeyrek-ai-mcp 0.0.62 → 0.0.63

package/dist/tools/platformInfo.js

@@ -2,6 +2,7 @@ import { listKnowledgeFiles, readKnowledgeFile } from '../resources/knowledge.js
 import { readToolResource } from '../resources/read.js';
 import { splitGuideSections } from '../knowledge/guideSections.js';
 import { PlatformApiError } from '../platform/errors.js';
+import { deliverGapReport } from '../observability/gapSink.js';
 import { logCapabilityGap } from '../observability/trace.js';
 import { handle } from '../platform/responses.js';
 import { readOnly } from './common.js';
@@ -174,9 +175,9 @@ export function registerPlatformTools(server, platform) {
     // hoşgörülüdür; çeviri yapıldığında yanıt bunu normalizedFrom ile söyler.
     server.registerTool('platform_gap_report', {
         title: 'Kabiliyet boşluğu bildir',
-        description: "Yapmak İSTEDİĞİNİZ ama platform desteklemediği için yapamadığınız her noktada BUNU ÇAĞIRIN — tasarımı sessizce küçültmeyin. Bu çağrı platforma gitmez, yalnızca günlüğe 'KABİLİYET BOŞLUĞU' bloğu yazar; hata günlüğünde görünmeyen bu kayıtlar ürün yol haritasının girdisidir. Önce rehbere bakıp (platform_guide; hazır komponent yetmiyorsa tek seferlik için 'html' kaçış kapısı, kalıcı bir ihtiyaç içinse 'external-component' — kendi komponentinizi yazıp yayınlayabilirsiniz) gerçekten desteklenmediğinden emin olun: desteklenen bir şeyi 'yok' diye bildirmek yanlış yol haritası üretir.",
+        description: "Yapmak İSTEDİĞİNİZ ama platform desteklemediği için yapamadığınız her noktada BUNU ÇAĞIRIN — tasarımı sessizce küçültmeyin. Bu çağrı platform API'sine gitmez: günlüğe 'KABİLİYET BOŞLUĞU' bloğu yazar ve GAP_REPORT_WEBHOOK_URL tanımlıysa kaydı ekibin webhook'una gönderir; yanıttaki delivered kaydın ekibe ulaşıp ulaşmadığını söyler (webhook · log-only · webhook-failed). Hata günlüğünde görünmeyen bu kayıtlar ürün yol haritasının girdisidir. Önce rehbere bakıp (platform_guide; hazır komponent yetmiyorsa tek seferlik için 'html' kaçış kapısı, kalıcı bir ihtiyaç içinse 'external-component' — kendi komponentinizi yazıp yayınlayabilirsiniz) gerçekten desteklenmediğinden emin olun: desteklenen bir şeyi 'yok' diye bildirmek yanlış yol haritası üretir.",
         inputSchema: {
-            project: z.string().min(1).optional().describe("Boşluğun görüldüğü proje (ad ya da slug); kayda yazılır. Bu çağrı platforma gitmez, proje yalnız bağlamdır"),
+            project: z.string().min(1).optional().describe("Boşluğun görüldüğü proje (ad ya da slug); kayda yazılır. Platform API'sine gitmez, proje yalnız bağlamdır"),
             goal: z.string().min(1).optional().describe('Ne yapmak istediniz — kullanıcıya görünen sonuç olarak yazın ("randevu listesini hasta adına göre süzmek"). Eşanlamlı kabul edilir: title · summary · what.'),
             blocker: z.string().min(1).optional().describe('Neden yapamadınız — hangi kabiliyetin eksik olduğu ("uçta X yok", "komponentte Y prop\'u yok"). Eşanlamlı kabul edilir: reason · problem · missing · description.'),
             severity: z.string().optional().describe("YOL HARİTASINDAKİ SIRAYI BU ALAN BELİRLER, doldurun. blocker: özellik hiç yapılamadı · workaround: daha kötü bir yolla yapıldı · cosmetic: yalnız görsel/ergonomik kayıp. Eşanlamlılar çevrilir (critical/high/blocking→blocker, medium/major→workaround, low/minor/nit→cosmetic). TANINMAYAN değer reddedilir; verilmezse kayıt düşer ama yanıt 'incomplete' ile uyarır ve bildirim orta kovaya yazılır."),
@@ -191,22 +192,30 @@ export function registerPlatformTools(server, platform) {
             missing: z.string().optional().describe('blocker ile aynı alan (eşanlamlı)'),
             description: z.string().optional().describe('blocker ile aynı alan (eşanlamlı)')
         },
-        annotations: readOnly
+        annotations: { ...readOnly, openWorldHint: true }
     }, handle(config, async (input) => {
         const gap = normalizeGapReport(input);
-        logCapabilityGap({ goal: gap.goal, blocker: gap.blocker, severity: gap.severity, module: gap.module, attempted: gap.attempted, workaround: gap.workaround, project: input.project });
+        const record = { goal: gap.goal, blocker: gap.blocker, severity: gap.severity, module: gap.module, attempted: gap.attempted, workaround: gap.workaround, project: input.project };
+        logCapabilityGap(record);
+        const delivered = await deliverGapReport(config.gapReportWebhookUrl, record);
+        const deliveryNote = {
+            webhook: 'Günlüğe yazıldı ve ekibe iletildi.',
+            'log-only': 'Yalnız bu makinedeki günlüğe yazıldı — ekibe ulaşmadı (GAP_REPORT_WEBHOOK_URL tanımlı değil).',
+            'webhook-failed': "Ekibin webhook'una ulaşılamadı, kayıt bu makinedeki günlükte duruyor."
+        }[delivered];
         return {
             recorded: true,
+            delivered,
             ...(input.project ? { project: input.project } : {}),
             severity: gap.severity,
             module: gap.module ?? null,
             ...(Object.keys(gap.normalizedFrom).length > 0 ? { normalizedFrom: gap.normalizedFrom } : {}),
             ...(gap.incomplete.length > 0 ? { incomplete: gap.incomplete } : {}),
             note: gap.incomplete.length > 0
-                ? `Günlüğe yazıldı ama eksik: ${gap.incomplete.join(', ')}.`
+                ? `${deliveryNote} Kayıt eksik: ${gap.incomplete.join(', ')}.`
                     + (gap.incomplete.includes('severity') ? ` Şiddet verilmediği için kayıt '${gap.severity}' olarak düştü — yol haritasındaki sırayı bu alan belirler, blocker'sa bunu açıkça yazın.` : '')
                     + ' Bir sonraki bildirimde bu alanları da doldurun — eksik kayıt yol haritasında sırasını kaybeder. Kullanıcıya da tek cümleyle söyleyin: neyi yapamadınız ve yerine ne yaptınız.'
-                : 'Günlüğe yazıldı. Kullanıcıya da tek cümleyle söyleyin: neyi yapamadınız ve yerine ne yaptınız.'
+                : `${deliveryNote} Kullanıcıya da tek cümleyle söyleyin: neyi yapamadınız ve yerine ne yaptınız.`
         };
     }));
 }

package/dist/tools/workflows.js

@@ -1,4 +1,4 @@
-import { guid, projectParam, environmentParam, definitionParam, pagingParams, readOnly, writes, updates, destructive, microOps, languageParam } from './common.js';
+import { guid, projectParam, environmentParam, definitionParam, pagingParams, readOnly, writes, updates, destructive, microOps, languageParam, unchangedPatch } from './common.js';
 import { normalizeWorkflowDefinition, withNormalization } from '../knowledge/normalize.js';
 import { evaluatePolicy, enforcePolicy, attachFindings } from '../knowledge/policy.js';
 import { workflowOutline, resolvePart, resolvePatchOperations } from '../knowledge/outlines.js';
@@ -224,6 +224,8 @@ export function registerWorkflowTools(server, platform) {
         // Gövde değil FARK gönderilir: gateway normalizasyonları da op'a çevrilsin diye net diff
         // okunan kayıt ile son hâl arasından hesaplanır (tam PUT yok, yalnız değişen alanlar yazılır).
         const netOps = fastJsonPatch.compare(definition, patched);
+        if (netOps.length === 0)
+            return attachFindings(unchangedPatch(operations.length), findings);
         const saved = await platform.tenant('PATCH', project, `/workflows/${applicationId}/${id}`, {
             environment,
             body: { baseVersion: baseVersionOf(definition, 'workflow_get'), ops: netOps }
@@ -272,7 +274,7 @@ export function registerWorkflowTools(server, platform) {
     }));
     server.registerTool('workflow_step_schema', {
         title: 'Step şeması üret',
-        description: "Verilen step tanımı için girdi/çıktı şemasını üretir (parameterScheme / returnScheme); step yazarken definition'ı doğrulamanın en hızlı yolu. type:'workflow' adımında (rule.workflowId) çağrılan akışın parametre ve dönüş DTO'sunu döner — alt akışa girdi YALNIZ rule.expression ile geçer, nesne literalinin anahtarları bu parameterScheme'in alanlarıdır (WF-032; platform_guide('workflow') §Workflow adımı). 'workflow' adımında returnBehavior çağrılan akışın dönüş biçimidir (array → liste). returnScheme adımın GÖVDESİDİR; koşumda her adım { data, meta, error } zarfındadır — 'http' adımında gövde tipsizdir (<adım>.data), durum kodu <adım>.meta.httpStatusCode. ŞEMA ALAN ADLARINI VERİR, HANGİ ALANIN ÇALIŞTIĞINI DEĞİL — iki ölçülmüş sapma (2026-09-16): (1) 'workflow' adımında workflowId boşken parameterScheme/returnScheme boş döner ve şema girdinin rule.expression ile bağlandığını söylemez; (2) 'email' adımında şemanın gösterdiği alıcı adı çalışmaz (36/W-6). Sözleşmenin ölçülmüş hâli: ngapps://examples/workflow-http-step · workflow-call-workflow · workflow-loop-step ve platform_guide('workflow').",
+        description: "Verilen step tanımı için girdi/çıktı şemasını üretir (parameterScheme / returnScheme); step yazarken definition'ı doğrulamanın en hızlı yolu. type:'workflow' adımında (rule.workflowId) çağrılan akışın parametre ve dönüş DTO'sunu döner — alt akışa girdi YALNIZ rule.expression ile geçer, nesne literalinin anahtarları bu parameterScheme'in alanlarıdır (WF-032; platform_guide('workflow') §Workflow adımı). 'workflow' adımında returnBehavior çağrılan akışın dönüş biçimidir (array → liste). returnScheme adımın GÖVDESİDİR; koşumda her adım { data, meta, error } zarfındadır — 'http' adımında gövde tipsizdir (<adım>.data), durum kodu <adım>.meta.httpStatusCode. ŞEMA ALAN ADLARINI VERİR, HANGİ ALANIN ÇALIŞTIĞINI DEĞİL — iki ölçülmüş sapma (2026-09-16): (1) 'workflow' adımında workflowId boşken parameterScheme/returnScheme boş döner ve şema girdinin rule.expression ile bağlandığını söylemez; (2) 'email' adımında alıcı YALNIZ rule.expression ile verilir ve { to, cc, bcc } adres dizgisi listeleri döndürür — \"({ to: [input.email] })\"; şemadaki expression.to/cc/bcc bu ifadenin döndürdüğü şekildir, kural düzeyinde send/toMail/sendTo yazılırsa platform atar (WF-037; platform_guide('workflow') §Email adımı). Sözleşmenin ölçülmüş hâli: ngapps://examples/workflow-http-step · workflow-call-workflow · workflow-loop-step · workflow-email-step ve platform_guide('workflow').",
         inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, id: guid, step: definitionParam },
         annotations: readOnly
     }, handle(config, ({ project, environment, applicationId, id, step }) => platform.tenant('POST', project, `/workflows/${applicationId}/${id}/steps/schema`, { environment, body: step })));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appaflytech/zeyrek-ai-mcp",
-  "version": "0.0.62",
+  "version": "0.0.63",
   "type": "module",
   "description": "Zeyrek (NgApps) platform APIs as MCP tools — data, logic and Studio design surface in one gateway",
   "license": "UNLICENSED",