@appaflytech/zeyrek-ai-mcp 0.0.16 → 0.0.18

package/dist/tools/workflows.js

@@ -7,10 +7,13 @@ import { writeDiff, withWriteDiff } from '../platform/writeDiff.js';
 import { policyRules, microfunctionStepFindings, workflowStepFindings, undefinedInputFieldFindings } from '../knowledge/rules.js';
 import { languageHeader } from '../knowledge/languageCodes.js';
 import { handle } from '../platform/responses.js';
+import { existingMatch, ifExistsParam, listAll, platformRename, withOutcome, withRename } from '../platform/ifExists.js';
+import { outlineWrite, recordWriteViewParam } from '../platform/writeView.js';
 import fastJsonPatch from 'fast-json-patch';
 import { z } from 'zod';
 import { constraintSummary } from '../knowledge/backendConstraints.js';
 import { unmappedMembers, introducedUnmappedMembers, withUnmappedMembers } from '../knowledge/schemaGuard.js';
+const workflowIfExistsParam = ifExistsParam('workflow', 'mevcut workflow\'u bu tanımla tam gövde günceller (id\'si korunur; workflow_update ile aynı yazma)');
 const policyOverrideParam = z.boolean().optional()
     .describe('true: politika block bulgularını warn\'a indirir (bilinçli istisna; yanıtta işaretlenir)');
 const patchOperationsParam = z.array(z.record(z.unknown())).min(1)
@@ -111,27 +114,51 @@ 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. 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. " + constraintSummary('CreateWorkflowCommand'),
-        inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, definition: definitionParam, policyOverride: policyOverrideParam },
+        description: "Yeni workflow tanımlar (definition = CreateWorkflowCommand). type: 'workflow' | 'automation' | 'middleware'. Uygulamada aynı ad ya da slug'da workflow varsa (tipten bağımsız) varsayılan olarak YAZMAZ ve mevcut kaydın id'sini döner (WF-034 — gönderilseydi platform '<ad> (1)' adıyla ikinci bir kayıt açardı); tekrar çalıştırılabilir yazma için ifExists:'update' verin, yanıttaki outcome 'created' | 'updated' olur. Mevcut workflow'lar okunamazsa da yazmaz. İ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. " + constraintSummary('CreateWorkflowCommand'),
+        inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, definition: definitionParam, ifExists: workflowIfExistsParam, view: recordWriteViewParam, policyOverride: policyOverrideParam },
         annotations: writes
-    }, handle(config, async ({ project, environment, applicationId, definition, policyOverride }) => {
+    }, handle(config, async ({ project, environment, applicationId, definition, ifExists, view, policyOverride }) => {
         const normalized = normalizeWorkflowDefinition(definition);
-        const findings = enforcePolicy([
-            ...evaluatePolicy(config, policyRules, 'workflow', definition, { operation: 'create', workflowKind: definition.type }, policyOverride),
+        // Politika ÖNCE koşar: block alan istek platforma hiç gitmez, var-mı listesi de okunmaz.
+        const stepFindings = [
             ...await microfunctionStepFindings(platform, project, environment, definition, definition.type, policyOverride),
             ...await workflowStepFindings(platform, project, environment, applicationId, definition, definition.type, policyOverride),
             ...await undefinedInputFieldFindings(platform, project, environment, definition, definition.type, policyOverride)
-        ]);
-        const drift = unmappedMembers('CreateWorkflowCommand', definition);
-        const payload = await platform.tenant('POST', project, `/workflows/${applicationId}`, { environment, body: definition });
-        return attachFindings(withUnmappedMembers(withWriteDiff(withNormalization(payload, normalized), writeDiff(definition, payload)), drift), findings);
+        ];
+        const bodyFindings = (operation) => evaluatePolicy(config, policyRules, 'workflow', definition, { operation, workflowKind: definition.type }, policyOverride);
+        const createFindings = enforcePolicy([...bodyFindings('create'), ...stepFindings]);
+        const existing = await existingMatch({
+            code: 'WF-034',
+            noun: 'workflow',
+            where: 'bu uygulamada',
+            name: typeof definition.name === 'string' ? definition.name : undefined,
+            slug: typeof definition.slug === 'string' ? definition.slug : undefined,
+            id: typeof definition.id === 'string' ? definition.id : undefined,
+            idParam: 'definition.id',
+            ifExists,
+            list: () => listAll(platform, project, environment, `/workflows/${applicationId}`),
+            listTool: 'workflow_list',
+            copyCheck: 'kullanılıp kullanılmadığını workflow_dependencies ile kontrol edip gerekirse silin',
+            updateTool: 'id ile workflow_update',
+            kind: { key: 'type', value: definition.type }
+        });
+        // Kayıt bulunduysa yazma bir UPDATE'tir: gövde kuralları workflow_update ile aynı kipte yeniden
+        // değerlendirilir (R-1). Adım denetimleri operasyondan bağımsızdır, tekrar koşmaz.
+        const findings = existing === undefined ? createFindings : enforcePolicy([...bodyFindings('update'), ...stepFindings]);
+        const drift = unmappedMembers(existing === undefined ? 'CreateWorkflowCommand' : 'UpdateWorkflowCommand', definition);
+        const payload = existing === undefined
+            ? await platform.tenant('POST', project, `/workflows/${applicationId}`, { environment, body: definition })
+            : await platform.tenant('PUT', project, `/workflows/${applicationId}/${String(existing.id)}`, { environment, body: definition });
+        const saved = payload?.data;
+        const rename = ifExists === 'duplicate' ? platformRename(definition, saved, 'dash') : { sent: definition };
+        return attachFindings(withUnmappedMembers(withWriteDiff(withRename(withNormalization(withOutcome(outlineWrite(payload, view, ['type']), existing), normalized), rename.renamed), writeDiff(rename.sent, payload)), drift), findings);
     }));
     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. 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. ' + constraintSummary('UpdateWorkflowCommand'),
-        inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, id: guid, definition: definitionParam, policyOverride: policyOverrideParam },
+        inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, id: guid, definition: definitionParam, view: recordWriteViewParam, policyOverride: policyOverrideParam },
         annotations: updates
-    }, handle(config, async ({ project, environment, applicationId, id, definition, policyOverride }) => {
+    }, handle(config, async ({ project, environment, applicationId, id, definition, view, policyOverride }) => {
         const normalized = normalizeWorkflowDefinition(definition);
         const findings = enforcePolicy([
             ...evaluatePolicy(config, policyRules, 'workflow', definition, { operation: 'update', workflowKind: definition.type }, policyOverride),
@@ -141,7 +168,7 @@ export function registerWorkflowTools(server, platform) {
         ]);
         const drift = unmappedMembers('UpdateWorkflowCommand', definition);
         const payload = await platform.tenant('PUT', project, `/workflows/${applicationId}/${id}`, { environment, body: definition });
-        return attachFindings(withUnmappedMembers(withWriteDiff(withNormalization(payload, normalized), writeDiff(definition, payload)), drift), findings);
+        return attachFindings(withUnmappedMembers(withWriteDiff(withNormalization(outlineWrite(payload, view, ['type']), normalized), writeDiff(definition, payload)), drift), findings);
     }));
     server.registerTool('workflow_patch', {
         title: 'Workflow\'a patch uygula',

package/package.json

@@ -1,9 +1,14 @@
 {
   "name": "@appaflytech/zeyrek-ai-mcp",
-  "version": "0.0.16",
+  "version": "0.0.18",
   "type": "module",
   "description": "Zeyrek (NgApps) platform APIs as MCP tools — data, logic and Studio design surface in one gateway",
   "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zeyrek-v2/zeyrek-app.git",
+    "directory": "zeyrek-mcp"
+  },
   "engines": {
     "node": ">=20"
   },