@appaflytech/zeyrek-ai-mcp 0.0.10 → 0.0.12

package/dist/tools/flows.js

@@ -1,7 +1,7 @@
 import { fetchHost, flowPath, hostParam, unwrap } from './screens.js';
 import { guid, projectParam, environmentParam, readOnly, writes, updates, destructive, microOps } from './common.js';
 import { evaluatePolicy, enforcePolicy, attachFindings } from '../knowledge/policy.js';
-import { normalizeFlowSteps, targetlessSetterWarnings, unknownSetterTargetWarnings, withNormalization } from '../knowledge/normalize.js';
+import { flowBindings, normalizeFlowSteps, targetlessSetterWarnings, unknownSetterTargetWarnings, withNormalization } from '../knowledge/normalize.js';
 import { flowBodyWarnings } from '../knowledge/coverage.js';
 import { PlatformApiError } from '../platform/errors.js';
 import { handle } from '../platform/responses.js';
@@ -50,6 +50,90 @@ function flowSummary(flow) {
 function hostNodes(record) {
     return record.schema ?? record.views ?? [];
 }
+const BINDINGS_UNAVAILABLE = 'Barındırıcı kaydı okunamadığı için olay bağları hesaplanamadı; akış listesi yine de günceldir.';
+/**
+ * Akış listesine bağları ekler. `danglingBindings` ters yönü söyler: şemada id'si geçen ama
+ * barındırıcıda karşılığı olmayan akış — olay tetiklenir, hiçbir şey koşmaz.
+ */
+function flowListResult(flows, record) {
+    if (record === undefined)
+        return { flows: flows.map(flowSummary), bindingsNote: BINDINGS_UNAVAILABLE };
+    const bindings = flowBindings(hostNodes(record), record.events);
+    const known = new Set(flows.map(flow => String(flow.id).toLowerCase()));
+    const danglingBindings = [...bindings.entries()]
+        .filter(([flowId]) => !known.has(flowId))
+        .flatMap(([flowId, entries]) => entries.map(entry => ({ flowId, ...entry })));
+    return {
+        flows: flows.map(flow => ({ ...flowSummary(flow), bindings: bindings.get(String(flow.id).toLowerCase()) ?? [] })),
+        unboundFlowIds: flows.map(flow => String(flow.id)).filter(flowId => !bindings.has(flowId.toLowerCase())),
+        ...(danglingBindings.length > 0 ? { danglingBindings } : {})
+    };
+}
+const ifExistsParam = z.enum(['error', 'update', 'duplicate']).default('error').describe("Barındırıcıda aynı ad ya da slug'da (büyük/küçük harf duyarsız) akış varsa ne olacağı. 'error' (varsayılan): yazmaz, mevcut akışın id'sini döner. 'update': mevcut akışı bu gövdeyle günceller (id'si ve olay bağları korunur). 'duplicate': platformun ürün davranışı — ikinci kayıt açılır, platform ada/slug'a ' (1)' sayacını ekler (Studio'daki 'New Flow (1)' ile aynı kural).");
+const upper = (value) => String(value ?? '').toUpperCase();
+/**
+ * Barındırıcının akışları, önbelleksiz liste ucundan (`GET /pages|layouts/{id}/flows`). Layout ve
+ * sayfa tasarım kaydı önbellekten gelir ve zarfsız akış yazmasından sonra akışı hemen taşımaz;
+ * 2026-09-16 raporundaki kopyalar bu yüzden doğdu. Widget kaydı önbelleksizdir, oradan okunur.
+ * Layout ucu olmayan eski backend 404/405 verir: o zaman kayda düşülür.
+ */
+async function listHostFlows(platform, host, project, environment, applicationId, hostId, hostRecord) {
+    if (host !== 'component') {
+        try {
+            const payload = await platform.tenant('GET', project, flowPath(host, applicationId, hostId), { environment });
+            if (!Array.isArray(payload?.data))
+                throw new PlatformApiError('akış listesi yanıtında data dizisi yok');
+            return payload.data;
+        }
+        catch (error) {
+            const status = error instanceof PlatformApiError ? error.status : undefined;
+            if (host === 'page' || (status !== 404 && status !== 405))
+                throw error;
+        }
+    }
+    const record = await hostRecord();
+    return Array.isArray(record.flows) ? record.flows : [];
+}
+/**
+ * FLOW-026 kapısı. Aynı adla ikinci akışın `"<ad> (1)"` olarak açılması platformun ürün kararıdır
+ * (`FlowService.MakeNameUniqueAsync`; Studio'da da sayfa/workflow/akış aynı kuralla adlanır) ve
+ * değişmez. MCP ajanı ise çağrıyı tekrar edebildiği için varsayılanı "yazma, mevcut id'yi söyle"dir.
+ * Aday araması platformda `LIKE` ile harfe duyarlıdır; gateway bilinçli olarak harf duyarsız
+ * karşılaştırır. Var-mı okuması başarısız olursa çağrı düşer — okuyamadığı listeyi boş sayan kontrol
+ * tam da zaman aşımında kopya üretirdi.
+ */
+async function existingFlowMatch(platform, host, project, environment, applicationId, hostId, hostRecord, name, slug, flowId, ifExists) {
+    if (ifExists === 'duplicate')
+        return undefined;
+    let flows;
+    try {
+        flows = await listHostFlows(platform, host, project, environment, applicationId, hostId, async () => hostRecord);
+    }
+    catch (error) {
+        throw new PlatformApiError(`FLOW-026: barındırıcının mevcut akışları okunamadı, akış YAZILMADI (${error instanceof Error ? error.message : String(error)}). Liste okunmadan yazmak aynı adla ikinci akış açabilir; flow_list ile tekrar deneyin ya da bilerek ikinci akış istiyorsanız ifExists:'duplicate' verin.`);
+    }
+    const matches = flows.filter(flow => upper(flow.name) === upper(name) || upper(flow.slug) === upper(slug));
+    const [match] = matches;
+    if (match === undefined)
+        return undefined;
+    const describe = (flow) => `${String(flow.id)} ('${String(flow.name)}', slug '${String(flow.slug)}')`;
+    const copyPattern = new RegExp(`^${name.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')} \\(\\d+\\)$`, 'i');
+    const copies = flows.filter(flow => copyPattern.test(String(flow.name ?? '')));
+    const copyNote = copies.length > 0
+        ? ` Barındırıcıda bu adın sayaçlı eşleri de var: ${copies.map(describe).join(' · ')} — bağı olup olmadığını flow_list (bindings) ile kontrol edip gerekirse silin.`
+        : '';
+    if (ifExists === 'error') {
+        const where = host === 'page' ? 'sayfada' : host === 'layout' ? "layout'ta" : "widget'ta";
+        throw new PlatformApiError(`FLOW-026: bu ${where} aynı ad ya da slug'da akış zaten var: ${matches.map(describe).join(' · ')}. İstek gönderilmedi — gönderilseydi platform ürün kuralı gereği ikinci bir akış açardı (çakışan ad ya da slug'a ' (1)' sayacı eklenerek; yalnız harf farkı varsa sayaçsız). Mevcut akışı güncellemek için aynı çağrıyı ifExists:'update' ile tekrarlayın; bilerek ikinci akış istiyorsanız ifExists:'duplicate'.${copyNote}`, 409);
+    }
+    if (matches.length > 1) {
+        throw new PlatformApiError(`FLOW-026: ad ve slug farklı akışlara çıkıyor (${matches.map(describe).join(' · ')}); hangisinin güncelleneceği belirsiz, istek gönderilmedi. flowId ile flow_update kullanın.${copyNote}`, 409);
+    }
+    if (flowId !== undefined && flowId.toLowerCase() !== String(match.id).toLowerCase()) {
+        throw new PlatformApiError(`FLOW-026: verilen flowId (${flowId}) aynı adlı mevcut akışla (${describe(match)}) çelişiyor; istek gönderilmedi. Mevcut akışı güncellemek için flowId'yi vermeyin ya da ${String(match.id)} verin.`, 409);
+    }
+    return match;
+}
 async function requiredParameterWarnings(platform, project, environment, applicationId, steps) {
     const warnings = [];
     const microserviceSteps = steps
@@ -226,32 +310,41 @@ export function registerFlowTools(server, platform) {
     const config = platform.config;
     server.registerTool('flow_list', {
         title: 'Akışları listele',
-        description: "Barındırıcının olay akışlarını listeler. Sayfada ayrı bir liste ucu vardır; layout ve komponentte akışlar kaydın kendi gövdesinden okunur.",
+        description: "Barındırıcının olay akışlarını, her birine bağlı olaylarla (bindings: [{ target: elementId | 'page', event }]) listeler. unboundFlowIds hiçbir olaya bağlı olmayan (sahipsiz) akışlardır; danglingBindings şemada id'si geçen ama barındırıcıda olmayan akışlardır. Sayfa ve layout akışları önbelleksiz liste ucundan, widget akışları kaydın kendi gövdesinden okunur; bağlar barındırıcının şemasından hesaplanır.",
         inputSchema: { project: projectParam, environment: environmentParam, host: hostParam, applicationId: guid, hostId: guid },
         annotations: readOnly
     }, handle(config, async ({ project, environment, host, applicationId, hostId }) => {
-        if (host === 'page') {
-            const payload = await platform.tenant('GET', project, flowPath('page', applicationId, hostId), { environment });
-            return { flows: (payload?.data ?? []).map(flowSummary) };
+        if (host === 'component') {
+            const record = await fetchHost(platform, host, project, environment, applicationId, hostId);
+            return flowListResult(Array.isArray(record.flows) ? record.flows : [], record);
         }
-        const record = await fetchHost(platform, host, project, environment, applicationId, hostId);
-        return { flows: (Array.isArray(record.flows) ? record.flows : []).map(flowSummary) };
+        let record;
+        const readRecord = async () => (record ??= await fetchHost(platform, host, project, environment, applicationId, hostId));
+        const flows = await listHostFlows(platform, host, project, environment, applicationId, hostId, readRecord);
+        return flowListResult(flows, record ?? await readRecord().catch(() => undefined));
     }));
     server.registerTool('flow_get', {
         title: 'Akış getir',
-        description: "Tek akışı adımlarıyla getirir; yeni akış yazarken en iyi şablon budur. Hedefi silinmiş (element'siz) setter iteratee'si varsa yanıttaki flowWarnings söyler — o adım koşar ama hiçbir şeye yazmaz.",
+        description: "Tek akışı adımlarıyla getirir; yeni akış yazarken en iyi şablon budur. bindings bu akışa bağlı olaylardır ([{ target: elementId | 'page', event }]; boşsa akış sahipsizdir). Hedefi silinmiş (element'siz) setter iteratee'si varsa yanıttaki flowWarnings söyler — o adım koşar ama hiçbir şeye yazmaz.",
         inputSchema: { project: projectParam, environment: environmentParam, host: hostParam, applicationId: guid, hostId: guid, flowId: flowIdParam },
         annotations: readOnly
     }, handle(config, async ({ project, environment, host, applicationId, hostId, flowId }) => {
         const response = await platform.tenant('GET', project, flowPath(host, applicationId, hostId, flowId), { environment });
+        const record = await fetchHost(platform, host, project, environment, applicationId, hostId).catch(() => undefined);
         const warnings = targetlessSetterWarnings(response);
-        if (warnings.length === 0 || !response || typeof response !== 'object' || Array.isArray(response))
+        if (!response || typeof response !== 'object' || Array.isArray(response))
             return response;
-        return { ...response, flowWarnings: warnings };
+        return {
+            ...response,
+            ...(record === undefined
+                ? { bindingsNote: BINDINGS_UNAVAILABLE }
+                : { bindings: flowBindings(hostNodes(record), record.events).get(flowId.toLowerCase()) ?? [] }),
+            ...(warnings.length > 0 ? { flowWarnings: warnings } : {})
+        };
     }));
     server.registerTool('flow_create', {
         title: 'Akış oluştur',
-        description: "Sayfa/layout/komponent için olay akışı oluşturur. İstek yalnız akışı yazar, barındırıcının şemasına dokunmaz; gateway barındırıcıyı yalnız setter hedeflerini denetlemek için okur (FLOW-024). Akışı bir komponent olayına bağlamak ayrı adımdır ve akış kaydedildikten SONRA yapılır: set_event {target, event, eventValue: <flow id>} — sayfada page_schema_patch, layout'ta layout_schema_patch, widget'ta component_schema_patch.",
+        description: "Sayfa/layout/komponent için olay akışı oluşturur. Aynı ad ya da slug'da akış varsa varsayılan olarak YAZMAZ ve mevcut akışın id'sini döner (FLOW-026 — gönderilseydi platform ürün kuralı gereği '<ad> (1)' adıyla ikinci bir akış açardı); tekrar çalıştırılabilir yazma için ifExists:'update' verin, yanıttaki outcome 'created' | 'updated' olur. Mevcut akışlar okunamazsa da yazmaz. İstek yalnız akışı yazar, barındırıcının şemasına dokunmaz; gateway barındırıcıyı setter hedeflerini denetlemek (FLOW-024), mevcut akışları ise önbelleksiz liste ucundan okur. Akışı bir komponent olayına bağlamak ayrı adımdır ve akış kaydedildikten SONRA yapılır: set_event {target, event, eventValue: <flow id>} — sayfada page_schema_patch, layout'ta layout_schema_patch, widget'ta component_schema_patch. Hangi olayların bağlı olduğunu flow_list / flow_get bindings alanı söyler.",
         inputSchema: {
             project: projectParam,
             environment: environmentParam,
@@ -263,12 +356,13 @@ export function registerFlowTools(server, platform) {
             steps: stepsParam,
             errorSteps: stepsParam.optional(),
             flowId: guid.optional().describe('Verilmezse platform üretir; şemaya önceden bağlamak için kendiniz üretebilirsiniz'),
+            ifExists: ifExistsParam,
             policyOverride: policyOverrideParam
         },
         annotations: writes
-    }, handle(config, async ({ project, environment, host, applicationId, hostId, name, slug, steps, errorSteps, flowId, policyOverride }) => {
+    }, handle(config, async ({ project, environment, host, applicationId, hostId, name, slug, steps, errorSteps, flowId, ifExists, policyOverride }) => {
         const hostRecord = await fetchHost(platform, host, project, environment, applicationId, hostId);
-        const resolvedFlowId = flowId ?? randomUUID();
+        const resolvedFlowId = (flowId ?? randomUUID()).toLowerCase();
         const flow = {
             id: resolvedFlowId,
             name,
@@ -279,6 +373,8 @@ export function registerFlowTools(server, platform) {
         };
         const normalized = [...normalizeFlowSteps(flow.steps), ...normalizeFlowSteps(flow.errorSteps)];
         const findings = enforcePolicy(evaluatePolicy(config, policyRules, 'flow', flow, { operation: 'create' }, policyOverride));
+        const existing = await existingFlowMatch(platform, host, project, environment, applicationId, hostId, hostRecord, name, slug, flowId, ifExists);
+        const writtenFlowId = existing === undefined ? resolvedFlowId : String(existing.id);
         const parameterWarnings = [
             ...await requiredParameterWarnings(platform, project, environment, applicationId, steps),
             ...await functionWarnings(platform, host, project, environment, applicationId, hostId, steps),
@@ -287,15 +383,21 @@ export function registerFlowTools(server, platform) {
         ];
         // Gövde yalnız akıştır (designer-partial-update K1): barındırıcı zarfı platformda hâlâ isteğe bağlı
         // ama gönderilirse okunan tam kaydı yeniden yazar, açık Studio designer'ının kayıtlı tabanını
-        // eskitir. Kayıt yalnız FLOW-024 hedef araması için okunur.
-        await platform.tenant('POST', project, flowPath(host, applicationId, hostId), { environment, body: { flow } });
+        // eskitir. Kayıt FLOW-024 hedef araması ve FLOW-026 var-mı kontrolü için okunur.
+        if (existing === undefined) {
+            await platform.tenant('POST', project, flowPath(host, applicationId, hostId), { environment, body: { flow } });
+        }
+        else {
+            await platform.tenant('PUT', project, flowPath(host, applicationId, hostId, writtenFlowId), { environment, body: { flow: { ...flow, id: writtenFlowId } } });
+        }
         // Diff YALNIZ çağıranın yazdığı alanları kapsar; `id` ve barındırıcı bağı (`pageId` vb.)
         // gövdeye gateway koyar, kullanıcının düzeltebileceği bir şey değildir.
-        const drops = await flowWriteDrops(platform, host, project, environment, applicationId, hostId, resolvedFlowId, { name: flow.name, slug: flow.slug, steps: flow.steps, errorSteps: flow.errorSteps });
+        const drops = await flowWriteDrops(platform, host, project, environment, applicationId, hostId, writtenFlowId, { name: flow.name, slug: flow.slug, steps: flow.steps, errorSteps: flow.errorSteps });
         return attachFindings(withWriteDiff(withNormalization({
             host,
             hostId,
-            flow: { id: resolvedFlowId, name, slug, steps: steps.length },
+            outcome: existing === undefined ? 'created' : 'updated',
+            flow: { id: writtenFlowId, name, slug, steps: steps.length },
             ...(parameterWarnings.length > 0 ? { parameterWarnings } : {}),
             hint: "Akışı bir olaya bağlamak için: page_schema_patch (layout'ta layout_schema_patch, widget'ta component_schema_patch) ops:[{op:'set_event', target:<elementId>, event:'<component_get events listesindeki ad>', eventValue:<flow id>}]. Olay adları komponente özeldir ve 'on' ÖNEKİ ALMAZ (button → 'click', form → 'submit', table → 'mount'/'select'/'sort'…); uydurma ad 200 döner ama bağ sessizce ölü kalır — gateway PAGE-008 ile yakalar."
         }, normalized), drops), findings);

package/dist/tools/pages.js

@@ -19,6 +19,8 @@ import { resolveIdentityToken } from '../platform/tokenVault.js';
 import { mkdir, writeFile } from 'node:fs/promises';
 import { dirname, resolve } from 'node:path';
 import { setPropTypeErrors } from '../knowledge/propTypes.js';
+import { designSnapshotInput } from '../knowledge/designSnapshot.js';
+import { discoverPage } from '../knowledge/pageDiscover.js';
 import { z } from 'zod';
 /**
  * Runtime paketindeki `appFunctions`/`pageFunctions` (UiFunctionRuntimeDto: id, name, parameters,
@@ -800,6 +802,20 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
             ...flexIndexOrderNote(ordering.moved)
         ]), opDrops);
     }));
+    server.registerTool('page_discover', {
+        title: 'Tasarım ekranından sayfa iskeleti öner',
+        description: "Tasarım anlık görüntüsündeki bir EKRANIN rolünden (list · form · detail · auth · shell — sözleşme platform_guide('theme') §Tasarım dosyasından tema) altın örnek arketipini seçip page_create + page_schema_patch iskeletini döner: pageCreateArgs (ad/slug ekrandan), schemaPatchOps, flows (örneğin akış gövdeleri), presetBindings (theme_discover'ın aynı anlık görüntüden ürettiği adlı preset TEK adaysa props.style.$preset olarak bağlanır), notes (yerleşim + ekran notları), caveats (yer tutucular, doldurulacak alanlar), next (çağrı sırası). shell rolü layout_create iskeleti döner. PİKSEL KOPYASI DEĞİLDİR: iskelet örneğin domainindedir, ajan ekran notlarına göre tamamlar. YAZMAZ, platforma gitmez, tahmin yapmaz.",
+        inputSchema: {
+            snapshot: designSnapshotInput.describe('Tasarım anlık görüntüsü (screens[] dolu olmalı)'),
+            screen: z.string().min(1).describe("screens[] içindeki ekranın nodeId'si ('92:4339') ya da adı ('Deals')"),
+            layoutId: guid.optional().describe('Sayfanın kabuğu (layout_list); verilmezse pageCreateArgs kabuksuz döner ve caveats söyler'),
+            middlewareIds: z.array(guid).optional().describe('Korumalı sayfa için auth middleware id listesi (middleware_list); verilmezse örnekteki yer tutucu düşer ve caveats söyler')
+        },
+        annotations: readOnly
+    }, handle(config, async ({ snapshot, screen, layoutId, middlewareIds }) => discoverPage(snapshot, screen, {
+        ...(layoutId === undefined ? {} : { layoutId }),
+        ...(middlewareIds === undefined ? {} : { middlewareIds })
+    })));
     server.registerTool('page_create', {
         title: 'Sayfa oluştur',
         description: "Yeni sayfa açar. Şemayı burada göndermek yerine boş bırakıp page_schema_patch micro-op'larıyla kurmak daha doğrudur (canlı canvas ve hedefli düzeltme orada). Şemayı burada gönderirseniz 2026-09-08'den beri AYNI doğrulama duvarından geçer: tanınmayan prop adı ve geçersiz enum değeri 422 ile reddedilir ve sayfa HİÇ açılmaz. roleIds için role_list, layoutId için layout_list kullanın. Yanıttaki schema VARSAYILAN OLARAK iskelettir (çözülmüş layout düğümleri dâhil id/type/children'a iner) — tam gövde için view:'full'; gönderdiğiniz bir alan kaydedilmediyse silentlyDropped söyler.",

package/dist/tools/themes.js

@@ -2,6 +2,8 @@ import { guid, projectParam, readOnly, updates } from './common.js';
 import { diffCssVars, mergeRadiusScale, mergeSpacingScale, mergeTypeScale, resolveTheme } from '../knowledge/themeResolve.js';
 import { diffThemePaths, mergeTheme, normalizeTheme, readProjectTheme, summarizeTheme, themeInput, unsetThemePaths } from '../knowledge/themeSchema.js';
 import { componentPresetTypeWarnings, themeInputWarnings, unsetWarnings } from '../knowledge/themeRules.js';
+import { designSnapshotInput } from '../knowledge/designSnapshot.js';
+import { discoverTheme } from '../knowledge/themeDiscover.js';
 import { attachFindings, enforcePolicy, evaluatePolicy, applyPolicyMode } from '../knowledge/policy.js';
 import { projectUpdateForm } from './projects.js';
 import { withNormalization } from '../knowledge/normalize.js';
@@ -90,6 +92,56 @@ export function registerThemeTools(server, platform) {
             note: "Değerlerin ekrana indiği hâl için view:'resolved'; yazmak için theme_update (kısmi günceller, lint'ten geçirir, hangi CSS değişkeninin değiştiğini söyler). Adlı bir preset'i düğüme bağlamak: style.$preset — platform_guide('theme')."
         };
     }));
+    server.registerTool('theme_discover', {
+        title: 'Tasarım anlık görüntüsünden tema öner',
+        description: "Bir tasarım anlık görüntüsünü (Figma değişkenleri, metin stilleri, gölgeler, bileşen ölçüleri — sözleşme platform_guide('theme') §Tasarım dosyasından tema, altın örnek design-snapshot) theme_update şemasında bir tema önerisine çevirir ve HESABINI verir: mapping (hangi ad hangi yola, hangi kuralla), unmapped (neden gitmedi), gaps (kaynağı olmayan alan), lint uyarıları; project verilirse mevcut temaya göre changed + cssVarsChanged önizlemesi. YAZMAZ — yazmak için theme_update({ theme }), önce dryRun. Eşleme ad temelli ve deterministiktir, tahmin yapmaz: eşlenmeyen token için kararı anlık görüntünün hints alanına yazarsınız ve karar dosyada kalır — Figma'ya ikinci kez gidilmez. Yalnız sapan değer yazılır: platform varsayılanına eşit taban ve ±0,05 içindeki oran öneriye girmez.",
+        inputSchema: {
+            snapshot: designSnapshotInput.describe("Tasarım anlık görüntüsü — sözleşme platform_guide('theme') §Tasarım dosyasından tema; her seviyede strict, tanınmayan anahtar reddedilir. variables get_variable_defs çıktısının kendisidir; hints: Figma adı → tema yolu (accent.muted, paletteDark.accent.primary, colors.blue.500) ya da 'ignore'"),
+            project: projectParam.describe("Yalnız ÖNİZLEME için: verilirse projenin mevcut teması okunur (GET) ve öneri ona derin birleştirilerek changed + cssVarsChanged hesaplanır. Verilmezse platforma HİÇ gidilmez — DefaultProject burada devreye girmez"),
+            deriveDark: z.boolean().optional().describe("true: anlık görüntüde koyu küme (variablesDark) YOKSA paletteDark aydınlık accent/status değerlerinden deterministik karışımla türetilir ve her değer mapping.via:'derived' ile işaretlenir — marka kararı değil başlangıç noktası. variablesDark varsa bayrak yok sayılır. Varsayılan: türetme yok (gaps: paletteDark, THEME-009)")
+        },
+        annotations: readOnly
+    }, handle(config, async ({ snapshot, project, deriveDark }) => {
+        const discovered = discoverTheme(snapshot, { deriveDark: deriveDark === true });
+        const proposal = normalizeTheme(discovered.theme);
+        const fixes = [...discovered.normalized, ...proposal.fixes];
+        let preview;
+        let merged = proposal.theme;
+        if (project !== undefined) {
+            const { project: projectInfo, theme: base } = await loadProject(platform, project);
+            const current = base ?? {};
+            merged = normalizeTheme(mergeTheme(current, proposal.theme)).theme;
+            preview = {
+                project: projectInfo,
+                changed: diffThemePaths(current, merged),
+                cssVarsChanged: diffCssVars(resolveTheme(current).cssVars, resolveTheme(merged).cssVars),
+                note: 'theme_update({ theme, dryRun: true }) aynı sonucu verir; bu önizleme yalnız GET ile hesaplandı, hiçbir şey yazılmadı.'
+            };
+        }
+        // Uyarılar YAZMA anındaki kurallarla aynı motordan (THEME-005/008/009 …): ajan öneriyi
+        // theme_update'e taşımadan ne uyarı alacağını burada görür. Block kuralları da listelenir ama
+        // enforce edilmez — bu tool yazmıyor; yazma anında theme_update durdurur. Operasyon 'update'
+        // çünkü tema kuralları yalnız ona kayıtlı (`appliesTo: ['update']`); 'preview' ile hiçbiri
+        // değerlendirilmiyordu (inceleme B-7). Sorulan şey aynı: "bu kayıt yazılsa geçer mi".
+        const findings = config.policyMode === 'off'
+            ? []
+            : applyPolicyMode(config, [
+                ...evaluatePolicy(config, policyRules, 'theme', merged, { operation: 'update' }),
+                ...themeInputWarnings(proposal.theme, merged)
+            ]);
+        const empty = Object.keys(proposal.theme).length === 0;
+        return attachFindings(withNormalization({
+            source: snapshot.source,
+            theme: proposal.theme,
+            mapping: discovered.mapping,
+            unmapped: discovered.unmapped,
+            gaps: discovered.gaps,
+            ...(preview === undefined ? {} : { preview }),
+            note: empty
+                ? 'Anlık görüntüde eşlenebilir token yok — unmapped (sebep) ve gaps (kaynağı olmayan alan) listelerine bakın; kararı hints ile verin.'
+                : "Yazmak için theme_update({ theme }) — önce dryRun: true. unmapped kararlarını anlık görüntünün hints alanına yazın ve dosyayı koşu klasöründe bırakın; ikinci koşu Figma'ya dönmez. gaps'teki alanlar uydurulmadı: kaynağı ekleyin ya da boş bırakın."
+        }, fixes), findings);
+    }));
     server.registerTool('theme_update', {
         title: 'Proje temasını güncelle',
         description: "Temayı KISMİ günceller: kaydı okur, verdiğiniz alanları derin birleştirir, normalize eder, lint'ten geçirir ve yazar — bir rengi değiştirmek preset'leri ve bileşen preset'lerini düşürmez. Yanıt hangi yolların değiştiğini (changed) ve hangi CSS değişkeninin hangi değerden hangi değere gittiğini (cssVarsChanged) söyler; dryRun ile yazmadan aynı yanıtı alırsınız. DİKKAT: tema PROJE kaydıdır — değişiklik BÜTÜN ortamların runtime'ına iner (production dâhil) ve Studio tema paneli açık ve kaydedilmemişse panelin sonraki Save'i bu yazmayı ezer.",

package/dist/tools/workflows.js

@@ -4,7 +4,7 @@ import { evaluatePolicy, enforcePolicy, attachFindings } from '../knowledge/poli
 import { workflowOutline, resolvePart, resolvePatchOperations } from '../knowledge/outlines.js';
 import { patchResult, baseVersionOf } from '../platform/patch.js';
 import { writeDiff, withWriteDiff } from '../platform/writeDiff.js';
-import { policyRules, microfunctionStepFindings, undefinedInputFieldFindings } from '../knowledge/rules.js';
+import { policyRules, microfunctionStepFindings, workflowStepFindings, undefinedInputFieldFindings } from '../knowledge/rules.js';
 import { languageHeader } from '../knowledge/languageCodes.js';
 import { handle } from '../platform/responses.js';
 import fastJsonPatch from 'fast-json-patch';
@@ -119,6 +119,7 @@ export function registerWorkflowTools(server, platform) {
         const findings = enforcePolicy([
             ...evaluatePolicy(config, policyRules, 'workflow', definition, { operation: 'create', workflowKind: definition.type }, policyOverride),
             ...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);
@@ -135,6 +136,7 @@ export function registerWorkflowTools(server, platform) {
         const findings = enforcePolicy([
             ...evaluatePolicy(config, policyRules, 'workflow', definition, { operation: 'update', workflowKind: definition.type }, policyOverride),
             ...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('UpdateWorkflowCommand', definition);
@@ -156,6 +158,7 @@ export function registerWorkflowTools(server, platform) {
         const findings = enforcePolicy([
             ...evaluatePolicy(config, policyRules, 'workflow', patched, { operation: 'update', workflowKind: patched.type }, policyOverride),
             ...await microfunctionStepFindings(platform, project, environment, patched, patched.type, policyOverride),
+            ...await workflowStepFindings(platform, project, environment, applicationId, patched, patched.type, policyOverride),
             ...await undefinedInputFieldFindings(platform, project, environment, patched, patched.type, policyOverride)
         ]);
         const drift = introducedUnmappedMembers('UpdateWorkflowCommand', (current?.data ?? current), patched);
@@ -202,6 +205,7 @@ export function registerWorkflowTools(server, platform) {
         const findings = enforcePolicy([
             ...evaluatePolicy(config, policyRules, 'workflow', definition, { operation: 'preview', workflowKind: definition.type }, policyOverride),
             ...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 payload = await platform.tenant('POST', project, `/workflows/${applicationId}/preview`, { environment, body: definition, headers: languageHeader(language, normalized) });
@@ -209,7 +213,7 @@ export function registerWorkflowTools(server, platform) {
     }));
     server.registerTool('workflow_step_schema', {
         title: 'Step şeması üret',
-        description: 'Verilen step tanımı için çıktı şemasını üretir; step yazarken definition\'ı doğrulamanın en hızlı yolu.',
+        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ı).",
         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.10",
+  "version": "0.0.12",
   "type": "module",
   "description": "Zeyrek (NgApps) platform APIs as MCP tools — data, logic and Studio design surface in one gateway",
   "license": "UNLICENSED",
@@ -35,6 +35,7 @@
     "harvest-examples": "tsx scripts/harvest-examples.ts",
     "kabul:import-adres": "tsx scripts/import-kabul-adres.ts",
     "kabul:import-senaryolar": "tsx scripts/import-kabul-senaryolar.ts",
+    "kabul:workflow-hata-zinciri": "tsx scripts/kabul-workflow-hata-zinciri.ts",
     "benchmark:report": "tsx scripts/benchmark-report.ts"
   },
   "dependencies": {