@appaflytech/zeyrek-ai-mcp 0.0.10 → 0.0.12

package/README.md

@@ -4,7 +4,7 @@ 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.
 
-- **208 tool · 34 modül** — veri/mantık tarafı (project, application, datasource, entity, row,
+- **212 tool · 34 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, **theme**, component, external component, flow, layout, variable, function,
   folder, file, access, translation), yönetim (template, organization, deployment) ve proje dallanması
@@ -140,9 +140,9 @@ ya da ikisi karışık (`core,page`). `platform` modülü (3 tool) her kümede v
 | Küme | Tool | Modüller |
 |---|---|---|
 | `core` | 136 | platform, project, application, datasource, entity, row, import, microservice, microfunction, query, workflow, automation, function, dto, view, dependency, environment, merge, activity, revision |
-| `studio` | 78 | platform, page, theme, component, externalComponent, flow, layout, variable, function, folder, file, import, access, translation, revision |
+| `studio` | 82 | platform, page, theme, component, externalComponent, flow, layout, variable, function, folder, file, import, access, translation, revision |
 | `admin` | 27 | platform, template, organization, deployment, environment, merge, activity |
-| (boş) | **208** | 34 modülün tamamı |
+| (boş) | **212** | 34 modülün tamamı (ölçüm 2026-09-16, `listTools()`) |
 
 Bilinmeyen bir modül/küme adı verilirse sunucu açılmaz, geçerli adları listeleyen bir hata yazar.
 
@@ -281,9 +281,14 @@ kural envanteri [`docs/08-kural-envanteri.md`](docs/08-kural-envanteri.md).
 Yayın otomatiktir: `main`'e `zeyrek-mcp/` değişikliği girince CI işi `publish:mcp:npm`
 ([`scripts/ci-publish-npm.sh`](scripts/ci-publish-npm.sh)) paketi üretip npm'deki son sürümle
 içerik olarak karşılaştırır; pakete giren dosyalar değiştiyse yeni patch sürümünü yayınlar.
-Sürümün kaynağı npm'dir, CI `package.json`'ı geri commit'lemez. Minor/major için
-`package.json`'daki sürümü elle yükseltip merge edin. Yayını o commit için atlamak: commit
-mesajına `DoNotDeploy` (iş elle tetiklenir hâle gelir).
+Yayından sonra CI yeni sürümü `package.json` + `package-lock.json`'a yazıp
+`chore: zeyrek-mcp X.Y.Z [skip ci]` bot commit'iyle `main`'e push eder (yeni pipeline
+başlatmaz); yayın olmazsa commit de olmaz. Push CI_JOB_TOKEN ile yapılır; gereken GitLab
+ayarları `.gitlab-ci.yml`'daki `publish:mcp:npm` notunda. Commit yazılamayıp iş kırmızı düşerse
+push yetkisi olan biri işi Retry eder: yayın tekrarlanmaz, yalnız sürüm `main`'e yazılır.
+Minor/major için `package.json`'daki
+sürümü elle yükseltip merge edin. Yayını o commit için atlamak: commit mesajına `DoNotDeploy`
+(iş elle tetiklenir hâle gelir).
 
 Yerelde deneme (yayın yapmaz; `npm ci` çalıştırdığı için bir kopyada ya da Linux container'da):
 

package/dist/knowledge/designSnapshot.js

@@ -0,0 +1,77 @@
+import { z } from 'zod';
+/**
+ * TASARIM ANLIK GÖRÜNTÜSÜ — bir tasarım dosyasının (Figma) TEK GEÇİŞTE okunup dosyaya alınmış
+ * hâli. `theme_discover`'ın girdisi budur; gateway Figma'ya kendisi gitmez (plan K1), süreç içi
+ * önbellek de tutmaz (HTTP taşımasında her POST yeni sunucu kurar — anlık görüntü DOSYADIR, K2).
+ *
+ * `.strict()` her seviyede: tanınmayan anahtar sessizce yaşamaz. Gerekçe tema şemasıyla aynı —
+ * ajan `variables` yerine `tokens` yazarsa bu bir yazım hatası değil, eşlemeye hiç girmeyen ve
+ * kimsenin görmediği bir veri kaybıdır. Şema onu istek anında adıyla reddeder.
+ *
+ * Ölçek: `textStyles.fontSize`, `components.*` uzunlukları ve `layout` px'tir; `effects.opacity`
+ * Figma'nın 0–1'idir (tema 0–100 ister, çeviri eşlemede — g-02). `variables` `get_variable_defs`
+ * çıktısının KENDİSİDİR: ad yeniden yazılmaz, değer olduğu gibi taşınır; eşleme adı okur.
+ */
+const scalar = z.union([z.string(), z.number()]);
+export const TEXT_STYLE_ROLES = ['h1', 'h2', 'h3', 'h4', 'label', 'p', 'small'];
+export const SCREEN_ROLES = ['shell', 'list', 'form', 'detail', 'auth', 'other'];
+/** `hints` değeri: bu Figma adı eşlemeye HİÇ girmesin (bilinçli karar; `unmapped` sebebi olarak döner). */
+export const SNAPSHOT_HINT_IGNORE = 'ignore';
+export const designSnapshotInput = z.object({
+    source: z.object({
+        kind: z.enum(['figma', 'manual']),
+        fileKey: z.string().optional(),
+        fileName: z.string().optional(),
+        nodeIds: z.array(z.string()).optional(),
+        fetchedAt: z.string().optional(),
+        calls: z.number().int().optional(),
+        characters: z.number().int().optional()
+    }).strict(),
+    variables: z.record(scalar),
+    variablesDark: z.record(scalar).optional(),
+    textStyles: z.array(z.object({
+        name: z.string(),
+        role: z.enum(TEXT_STYLE_ROLES).optional(),
+        fontFamily: z.string(),
+        fontSize: z.number(),
+        fontWeight: scalar.optional(),
+        lineHeight: z.number().optional()
+    }).strict()).optional(),
+    effects: z.array(z.object({
+        name: z.string(),
+        offsetX: z.number(),
+        offsetY: z.number(),
+        blur: z.number(),
+        spread: z.number(),
+        color: z.string(),
+        opacity: z.number()
+    }).strict()).optional(),
+    layout: z.object({
+        desktopWidth: z.number().optional(),
+        mobileWidth: z.number().optional(),
+        gutter: z.number().optional(),
+        sidebarWidth: z.number().optional(),
+        notes: z.array(z.string()).optional()
+    }).strict().optional(),
+    components: z.record(z.object({
+        background: z.string().optional(),
+        color: z.string().optional(),
+        border: z.string().optional(),
+        borderRadius: scalar.optional(),
+        paddingX: z.number().optional(),
+        paddingY: z.number().optional(),
+        height: z.number().optional(),
+        fontSize: z.number().optional(),
+        fontWeight: scalar.optional(),
+        shadow: z.string().optional()
+    }).strict()).optional(),
+    screens: z.array(z.object({
+        nodeId: z.string(),
+        name: z.string(),
+        role: z.enum(SCREEN_ROLES),
+        screenshot: z.string().optional(),
+        notes: z.array(z.string()).optional()
+    }).strict()).optional(),
+    /** Figma adı → tema yolu (`accent.muted`, `colors.blue.500`) ya da `ignore`; ajanın KALICI kararı. */
+    hints: z.record(z.string()).optional()
+}).strict();

package/dist/knowledge/errorPath.js

@@ -1,5 +1,25 @@
 import { randomUUID } from 'node:crypto';
 const ERROR_STEP_NAME = 'gatewayOnError';
+const ERROR_STEP_NAME_PATTERN = /^gatewayOnError\d*$/;
+/**
+ * Global-error dalında `error` = `WorkflowError.ToObject()`: `{ code, message, detail, type,
+ * step: { id, name, type, data, input } }` (`ActivityContext.EnterGlobalErrorHandling`). Gövde
+ * `step`'i ALT KÜME olarak yazar, çünkü (1) `ResponseStep` global-error kipinde gövdedeki `step`
+ * `error.step` ile birebir aynıysa onu siler, (2) `step.input` adımın ifade değerlerini (parola
+ * dahil) taşır. Zincir önce `error.cause`'tan okunur: backend 2026-09-17'den beri her seviyeyi
+ * `{ code, message, detail, type, step: { name, type }, cause }` olarak orada verir — loop iterasyonu
+ * (`<loop>[<sıra>]`) ve istisnasız 2xx dışı dönen çocuk dahil (`WorkflowError.ToObject`). Eski backend'de
+ * `error.cause` yoktur; o zaman yalnız patlayan `workflow` adımının `step.data`'sı okunur: fırlatan
+ * çocukta `WorkflowError.ToResponseObject()`, 2xx dışı dönen çocukta çocuğun KENDİ yanıtı. İkincisi
+ * keyfî olabilir (elle yazılmış `({ err: error })` input taşır), bu yüzden `pick` her iki kaynağı seviye
+ * seviye beyaz listeye süzer: `code/message/detail/type/step{name,type}/cause`. Hiçbiri yoksa `cause`
+ * yazılmaz. Loop adımının `data`'sı tamamlanan öğelerdir — okunmaz. Canlı ölçüm 2026-09-16 (lokal `emrah/web`, üç seviyeli
+ * zincir + `/m/`). ES5: motor Jint 4 ama desteklenen yüzey belgesiz (RFQ W-4); null alan yazılmaz.
+ */
+export const GATEWAY_ERROR_BODY_EXPRESSION = "(function () { function pick(source, depth) { if (!source || typeof source !== 'object') return null; var picked = {}; if (source.code) picked.code = source.code; if (source.message) picked.message = source.message; if (source.detail) picked.detail = source.detail; if (source.type) picked.type = source.type; if (source.step && source.step.name) { picked.step = { name: source.step.name }; if (source.step.type) picked.step.type = source.step.type; } if (depth < 8 && source.cause) { var inner = pick(source.cause, depth + 1); if (inner) picked.cause = inner; } return picked.code || picked.message || picked.step || picked.cause ? picked : null; } var body = { code: error.code, message: error.message }; if (error.detail) body.detail = error.detail; if (error.type) body.type = error.type; if (error.step) body.step = { name: error.step.name, type: error.step.type }; var cause = pick(error.cause, 0) || (error.step && error.step.type === 'workflow' ? pick(error.step.data, 0) : null); if (cause) body.cause = cause; return body; })()";
+export const LEGACY_GATEWAY_ERROR_BODY_EXPRESSION = '({ code: error.code, message: error.message })';
+const ERROR_STEP_DESCRIPTION = "Gateway'in eklediği hata yolu: akışın herhangi bir adımı patlarsa buraya düşer ve 500 ile { code, message, detail, type, step: { name, type } } döner; patlayan adım bir alt akışsa çocuğun hata gövdesi cause içinde iç içe gelir. Kendi hata gövdeni istiyorsan bu adımın bodyExpression'ını değiştir.";
+const LEGACY_ERROR_STEP_DESCRIPTION = "Gateway'in eklediği hata yolu: akışın herhangi bir adımı patlarsa buraya düşer ve 500 ile { code, message } döner. Kendi hata gövdeni istiyorsan bu adımın bodyExpression'ını değiştir.";
 const INJECTED_KINDS = new Set(['workflow', 'middleware']);
 function asSteps(value) {
     return (Array.isArray(value) ? value : []).filter((step) => Boolean(step) && typeof step === 'object');
@@ -35,8 +55,9 @@ export function ensureWorkflowErrorPath(definition, kind) {
     if (steps.some(step => step !== startStep && (Array.isArray(step.branches) ? step.branches : []).some(branch => branch?.type === 'global-error')))
         return [];
     const branches = Array.isArray(startStep.branches) ? startStep.branches : [];
-    if (branches.some(branch => branch?.type === 'global-error' && branch.nextStepId))
-        return [];
+    const wired = branches.find(branch => branch?.type === 'global-error' && branch.nextStepId);
+    if (wired)
+        return upgradeLegacyErrorBody(steps, String(wired.nextStepId));
     const name = availableName(steps);
     const errorStepId = randomUUID();
     const unwired = branches.find(branch => branch?.type === 'global-error');
@@ -44,12 +65,12 @@ export function ensureWorkflowErrorPath(definition, kind) {
         id: errorStepId,
         name,
         type: 'response',
-        description: "Gateway'in eklediği hata yolu: akışın herhangi bir adımı patlarsa buraya düşer ve 500 ile { code, message } döner. Kendi hata gövdeni istiyorsan bu adımın bodyExpression'ını değiştir.",
+        description: ERROR_STEP_DESCRIPTION,
         caution: "Bu adımı gateway ekledi; silersen akışın hata yolu kaybolur ve patlayan adım istemciye ham hata döndürür.",
         rule: {
             stepType: 'response',
             httpStatusCode: 500,
-            bodyExpression: '({ code: error.code, message: error.message })'
+            bodyExpression: GATEWAY_ERROR_BODY_EXPRESSION
         },
         branches: []
     });
@@ -60,5 +81,27 @@ export function ensureWorkflowErrorPath(definition, kind) {
         branches.push({ id: randomUUID(), name: 'global-error', type: 'global-error', nextStepId: errorStepId });
     }
     startStep.branches = branches;
-    return [`hata yolu eklendi: start adımına 'global-error' dalı + '${name}' response adımı (500, { code, message }). Hata yolu olmayan akış patladığında platform WorkflowStepFailedException fırlatır (HTTP 500 { code, message, detail, type }; zamanlanmış işte failed + "Step 'x' failed: …"); bu adım çıktıyı { code, message } ile denetim altına alır, zamanlanmış işte sonuç yine failed düşer. Kendi hata gövdenizi istiyorsanız bu adımın bodyExpression'ını değiştirin.`];
+    return [`hata yolu eklendi: start adımına 'global-error' dalı + '${name}' response adımı (500, { code, message, detail, type, step: { name, type }, cause }). Hata yolu olmayan akış patladığında platform WorkflowStepFailedException fırlatır (HTTP 500 { code, message, detail, type }, 2026-09-17 backend'inde step ve cause da; zamanlanmış işte failed + "Step 'x' failed: …"); bu adım aynı şekli ele alınmış 500 olarak döner — patlayan adımın adı ve tipi, alt akış ya da loop iterasyonu zinciri cause içinde — ve zamanlanmış işte sonuç yine failed düşer. Kendi hata gövdenizi istiyorsanız bu adımın bodyExpression'ını değiştirin.`];
+}
+/**
+ * Bu dosyanın 2026-09-16 öncesi sürümü hata adımına `{ code, message }` yazıyordu; o kayıtlar
+ * `detail`, `type` ve patlayan adımı dışarı vermez. Yalnız gateway'in KENDİ yazdığı ve kimsenin
+ * dokunmadığı adım yükseltilir: global-error dalının hedefi, adı `gatewayOnError[n]`, tipi
+ * `response`, ifadesi eski varsayılanla birebir aynı VE açıklaması eski gateway metni (ya da boş).
+ * Açıklama şartı, yükseltilmiş bir adımı aynı çağrıda bilerek eski gövdeye döndüren kullanıcıyı
+ * korur: yükseltme açıklamayı da yenilediği için geri dönüş bir daha ezilmez.
+ */
+function upgradeLegacyErrorBody(steps, errorStepId) {
+    const target = steps.find(step => String(step.id ?? '') === errorStepId);
+    const rule = target?.rule;
+    if (!target || target.type !== 'response' || !ERROR_STEP_NAME_PATTERN.test(String(target.name ?? '')) || !rule)
+        return [];
+    if (typeof rule.bodyExpression !== 'string' || rule.bodyExpression.trim() !== LEGACY_GATEWAY_ERROR_BODY_EXPRESSION)
+        return [];
+    const untouchedDescription = target.description === undefined || target.description === null || String(target.description).trim() === '' || target.description === LEGACY_ERROR_STEP_DESCRIPTION;
+    if (!untouchedDescription)
+        return [];
+    rule.bodyExpression = GATEWAY_ERROR_BODY_EXPRESSION;
+    target.description = ERROR_STEP_DESCRIPTION;
+    return [`hata gövdesi genişletildi: '${String(target.name)}' adımının bodyExpression'ı gateway'in eski varsayılanıydı ({ code, message }); yeni varsayılan detail, type, patlayan adımın { name, type } bilgisini ve adım bir alt akışsa çocuğun hata gövdesini cause olarak da döner. Çocuk gövdesi yalnız code/message/detail/type/step{name,type}/cause alanlarına süzülür. Yanıta alan EKLENİR, mevcut code/message değişmez. Açıklaması ya da ifadesi elle değiştirilmiş hata adımına dokunulmaz; eski gövdede kalmak için bu adımın açıklamasını değiştirin.`];
 }

package/dist/knowledge/normalize.js

@@ -1905,6 +1905,53 @@ export function inertFlexPropWarning(entries) {
             + "sessizce yok sayılır (istek reddedilmez, prop katalogda vardır). Akış düzeni istiyorsan aynı düğüme "
             + "layout:'flex' de yaz, istemiyorsan bu prop'ları kaldır — platform_guide('page') Kural 1f-2."];
 }
+/**
+ * Akış id'si → ona bağlı olaylar. Bağ üç yerde durur: düğümün `events[].value`'su, düğüm
+ * prop'larındaki `type:'flow'` referansları (`event` alanı `prop:<ad>` olur) ve barındırıcının
+ * düzey olayları (`target: 'page'` — `remove_event`'in aynı hedef adı). Akış tarafından bu
+ * listeyi veren bir uç yok; 2026-09-16 raporunda uygulama kabuğunda hangi olayın hangi akışa
+ * bağlı olduğu kaybolmuş, ikinci "zil rozeti" akışı sahipsiz kalmıştı.
+ */
+export function flowBindings(schema, hostEvents) {
+    const bindings = new Map();
+    const add = (flowId, binding) => {
+        if (flowId === '')
+            return;
+        bindings.set(flowId.toLowerCase(), [...(bindings.get(flowId.toLowerCase()) ?? []), binding]);
+    };
+    for (const event of asObjects(hostEvents)) {
+        if (typeof event.value === 'string')
+            add(event.value, { target: 'page', event: String(event.name ?? '') });
+    }
+    const visitProp = (target, propName, value) => {
+        if (Array.isArray(value)) {
+            for (const entry of value)
+                visitProp(target, propName, entry);
+            return;
+        }
+        if (!value || typeof value !== 'object')
+            return;
+        const record = value;
+        if (record.type === 'flow' && typeof record.ref === 'string')
+            add(record.ref, { target, event: `prop:${propName}` });
+        for (const entry of Object.values(record))
+            visitProp(target, propName, entry);
+    };
+    const visitNode = (node) => {
+        const target = String(node.elementId ?? node.name ?? '');
+        for (const event of asObjects(node.events)) {
+            if (typeof event.value === 'string')
+                add(event.value, { target, event: String(event.name ?? '') });
+        }
+        for (const [propName, value] of Object.entries((node.props ?? {})))
+            visitProp(target, propName, value);
+        for (const child of asObjects(node.children))
+            visitNode(child);
+    };
+    for (const node of asObjects(schema))
+        visitNode(node);
+    return bindings;
+}
 /**
  * Bir yamanın SİLECEĞİ akışlar. Platform referanssız kalan akışı KALICI siler; uyarı yamadan sonra
  * geldiğinde "önce yedekle" tavsiyesi uygulanamaz hâle geliyordu (09-05 koşusu: sekiz adımlı giriş

package/dist/knowledge/pageDiscover.js

@@ -0,0 +1,151 @@
+import { readKnowledgeFile } from '../resources/knowledge.js';
+import { PlatformApiError } from '../platform/errors.js';
+import { discoverTheme } from './themeDiscover.js';
+const ARCHETYPES = {
+    form: { example: 'page-form-upsert', flows: { mount: 'mountFlowCreateArgs', submit: 'submitFlowCreateArgs' } },
+    detail: { example: 'page-detail-profile', flows: { mount: 'mountFlowCreateArgs' } },
+    auth: { example: 'page-sign-in', flows: { submit: 'submitFlowCreateArgs' } }
+};
+const LIST_ARCHETYPE = 'list (kod içi iskelet) + flow-list-to-form';
+const SHELL_EXAMPLE = 'layout-app-shell';
+const LIST_EVENTS_EXAMPLE = 'flow-list-to-form';
+const turkishMap = { ç: 'c', ğ: 'g', ı: 'i', ö: 'o', ş: 's', ü: 'u', â: 'a', î: 'i', û: 'u' };
+export function slugifyScreenName(name) {
+    return name.toLocaleLowerCase('tr')
+        .replace(/[çğıöşüâîû]/g, letter => turkishMap[letter] ?? letter)
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+const readExample = (name) => JSON.parse(readKnowledgeFile('examples', `${name}.json`));
+const isPlaceholder = (value) => typeof value === 'string' && value.startsWith('<');
+const staticProp = (data) => ({ type: 'static', data });
+const node = (elementId, type, props, wrapper, block) => ({
+    elementId,
+    kind: 'component',
+    type,
+    name: elementId,
+    props,
+    states: { isSticky: false, isDroppable: wrapper, isScrollable: false, isWrapper: wrapper },
+    blocks: [{ breakpoint: 1024, size: { h: block.h, w: block.w }, position: { x: block.x, y: block.y } }],
+    children: [],
+    events: [],
+    validations: [],
+    stateBindings: []
+});
+/** Liste sayfası asgari iskeleti: araç çubuğu (Yeni) + kayıt tablosu; adlar `flow-list-to-form` ile aynı. */
+function listSkeleton() {
+    return [
+        { op: 'add_component', parent: 'page_container', component: node('list_toolbar', 'container', { layout: staticProp('flex'), direction: staticProp('row') }, true, { h: 4, w: 12, x: 0, y: 0 }) },
+        { op: 'add_component', parent: 'list_toolbar', component: node('btn_new', 'button', { text: staticProp('Yeni') }, false, { h: 4, w: 3, x: 0, y: 0 }) },
+        { op: 'add_component', parent: 'page_container', component: node('records_table', 'table', {}, false, { h: 40, w: 12, x: 0, y: 4 }) }
+    ];
+}
+function pageArgs(screenName, base, options, caveats) {
+    const args = { ...base, name: screenName, slug: slugifyScreenName(screenName), browserTitle: screenName };
+    if (options.layoutId !== undefined) {
+        args.layoutId = options.layoutId;
+    }
+    else {
+        if (isPlaceholder(args.layoutId) || args.layoutId === undefined)
+            delete args.layoutId;
+        caveats.push("layoutId verilmedi — sayfa kabuksuz açılır; kabuk için 'shell' ekranını page_discover ile layout_create'e çevirip (ya da layout_list ile mevcut kabuğu bulup) pageCreateArgs.layoutId verin");
+    }
+    if (options.middlewareIds !== undefined) {
+        args.middlewareIds = options.middlewareIds;
+    }
+    else if (Array.isArray(args.middlewareIds) && args.middlewareIds.some(isPlaceholder)) {
+        delete args.middlewareIds;
+        caveats.push('middlewareIds verilmedi — örnek korumalı sayfa istiyor; auth middleware id için middleware_list, sonra pageCreateArgs.middlewareIds (bir-iki ucu bağlayıp gerisini açık bırakmak yasak)');
+    }
+    return args;
+}
+/** Tek aday preset bağlanır (`props.style = { $preset }`); birden çok aday karar ister (K4). */
+function bindPresets(ops, presets, caveats) {
+    const bindings = [];
+    for (const op of ops) {
+        if (op.op !== 'add_component')
+            continue;
+        const component = op.component;
+        const type = typeof component?.type === 'string' ? component.type : undefined;
+        const elementId = typeof component?.elementId === 'string' ? component.elementId : undefined;
+        if (component === undefined || type === undefined || elementId === undefined)
+            continue;
+        const candidates = presets.filter(preset => preset === type || preset.startsWith(`${type}-`));
+        if (candidates.length === 1) {
+            component.props = { ...(component.props ?? {}), style: { $preset: candidates[0] } };
+            bindings.push({ elementId, type, preset: candidates[0] });
+        }
+        else if (candidates.length > 1) {
+            caveats.push(`${elementId} (${type}) için birden çok preset adayı var: ${candidates.join(', ')} — hangisi olacağına siz karar verin (page_schema_patch replace_prop style { $preset })`);
+        }
+    }
+    return bindings;
+}
+export function discoverPage(snapshot, screenRef, options = {}) {
+    const screens = snapshot.screens ?? [];
+    const screen = screens.find(entry => entry.nodeId === screenRef) ?? screens.find(entry => entry.name === screenRef);
+    if (screen === undefined) {
+        throw new PlatformApiError(`page_discover: '${screenRef}' anlık görüntünün screens listesinde yok (nodeId ya da name). Mevcut ekranlar: ${screens.map(entry => `${entry.name} (${entry.nodeId}, ${entry.role})`).join(' · ') || 'yok'}.`, 400);
+    }
+    const caveats = [];
+    const notes = [...(snapshot.layout?.notes ?? []), ...(screen.notes ?? [])];
+    const head = { screen: { nodeId: screen.nodeId, name: screen.name, role: screen.role }, notes };
+    const presets = Object.keys(discoverTheme(snapshot).theme.presets ?? {});
+    if (screen.role === 'shell') {
+        const example = readExample(SHELL_EXAMPLE);
+        return {
+            ...head,
+            archetype: SHELL_EXAMPLE,
+            layoutCreateArgs: { ...example.layoutCreate, name: screen.name },
+            schemaPatchOps: [],
+            flows: {},
+            presetBindings: [],
+            caveats: ['kabuk bir SAYFA değil LAYOUT kaydıdır; yan menü/üst şerit içeriğini ekran notlarına göre layout_schema_patch ile doldurun'],
+            next: 'layout_create(layoutCreateArgs) → layout_list ile id → diğer ekranların pageCreateArgs.layoutId'
+        };
+    }
+    if (screen.role === 'other') {
+        return {
+            ...head,
+            archetype: 'yok',
+            pageCreateArgs: pageArgs(screen.name, {}, options, caveats),
+            schemaPatchOps: [],
+            flows: {},
+            presetBindings: [],
+            caveats: [...caveats, "rol 'other' — arketip yok; ekran notlarına göre page_schema_patch ile elle kurun (platform_guide('page') §arketipler) ya da anlık görüntüde role list/form/detail/auth verin"],
+            next: "page_create(pageCreateArgs) → page_schema_patch(ops — elle) → page_screenshot"
+        };
+    }
+    if (screen.role === 'list') {
+        const events = readExample(LIST_EVENTS_EXAMPLE);
+        const ops = [...listSkeleton(), ...(events.schemaPatchOps ?? [])];
+        const presetBindings = bindPresets(ops, presets, caveats);
+        caveats.push("records_table props boş — kolonları ve veri kaynağını component_get('table') + flow-load-table örneğine göre verin; set_event op'larındaki '<… flow id>' yer tutucuları flow_create sonrası gerçek id ile değiştirilir");
+        return {
+            ...head,
+            archetype: LIST_ARCHETYPE,
+            pageCreateArgs: pageArgs(screen.name, {}, options, caveats),
+            schemaPatchOps: ops,
+            flows: { openRecord: events.openRecordFlowCreateArgs, newRecord: events.newRecordFlowCreateArgs },
+            presetBindings,
+            caveats,
+            next: 'page_create(pageCreateArgs) → flow_create(flows.openRecord, flows.newRecord) → set_event yer tutucularını flow id ile değiştir → page_schema_patch(schemaPatchOps) → page_screenshot'
+        };
+    }
+    const archetype = ARCHETYPES[screen.role];
+    const example = readExample(archetype.example);
+    const ops = structuredClone(example.schemaPatchOps ?? []);
+    const presetBindings = bindPresets(ops, presets, caveats);
+    const flows = Object.fromEntries(Object.entries(archetype.flows).map(([key, field]) => [key, example[field]]).filter(([, value]) => value !== undefined));
+    caveats.push(`iskelet '${archetype.example}' altın örneğinden — elementId'ler ve metinler örneğin domainindedir (${String(example.pageCreateArgs?.name ?? '')}); ekran notlarına göre alan adlarını, etiketleri ve akış adımlarını değiştirin`);
+    return {
+        ...head,
+        archetype: archetype.example,
+        pageCreateArgs: pageArgs(screen.name, example.pageCreateArgs ?? {}, options, caveats),
+        schemaPatchOps: ops,
+        flows,
+        presetBindings,
+        caveats,
+        next: 'page_create(pageCreateArgs) → page_schema_patch(pageId, schemaPatchOps) → flow_create(flows.*) ve set_event yer tutucularını flow id ile değiştir → page_screenshot'
+    };
+}

package/dist/knowledge/rules.js

@@ -47,6 +47,47 @@ function hasText(value) {
 function stepLabel(step) {
     return step.name || step.type || step.id || '?';
 }
+const GUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/**
+ * `workflow` adımının (ve `loop` içindeki `stepType: 'workflow'` çocuğunun) alt akışı çağıran
+ * kuralı. `WorkflowStep.cs` yalnız `rule.WorkflowId` + `rule.Expression` okur; girdiyi başka
+ * bir alanla göndermeye çalışan gövde ya kaydedilip okunmaz (şema üyeleri) ya da hiç
+ * kaydedilmez (şema dışı adlar, `unmappedMembers`) — iki durumda da alt akış SESSİZCE girdisiz
+ * koşar (RFQ koşusu W-7, 2026-09-14). Platform her adım kuralını `fields: []`,
+ * `customParameters: null` gibi boş varsayılanlarla geri okuttuğu için yalnız DOLU değer sayılır;
+ * aksi hâlde `workflow_get` gövdesiyle yapılan her `workflow_patch`/`update`/`preview` kendi
+ * kendine bloklanırdı.
+ */
+const WORKFLOW_STEP_SAVED_BUT_UNREAD_KEYS = ['payloadExpression', 'customParameters', 'queryParameters', 'bodyExpression', 'fields'];
+const WORKFLOW_STEP_UNMAPPED_INPUT_KEYS = ['parameters', 'parameter', 'input', 'payload', 'arguments', 'args', 'variables'];
+function carriesValue(value) {
+    if (value === undefined || value === null)
+        return false;
+    if (Array.isArray(value))
+        return value.length > 0;
+    if (typeof value === 'string')
+        return value.trim() !== '';
+    return true;
+}
+function workflowCallSites(body) {
+    return workflowSteps(body).flatMap((step) => {
+        const rule = (step.rule ?? {});
+        if (step.type === 'workflow')
+            return [{ step, rule, label: stepLabel(step) }];
+        if (step.type === 'loop' && rule.stepType === 'workflow' && rule.stepRule && typeof rule.stepRule === 'object') {
+            return [{ step, rule: rule.stepRule, label: `${stepLabel(step)} (loop çocuğu)` }];
+        }
+        return [];
+    });
+}
+function literalShapeOf(expression) {
+    const head = expression.trim().replace(/^[(\s]+/, '');
+    if (head.startsWith('{'))
+        return 'object';
+    if (head.startsWith('['))
+        return 'array';
+    return undefined;
+}
 /**
  * Start'tan başlayıp `global-error` dalları HARİÇ tüm dalları izleyerek erişilen adımlar.
  * Gateway her `workflow`/`middleware` tanımına global-error dalının ucunda bir `response` adımı
@@ -698,6 +739,45 @@ export const policyRules = [
             });
         }
     },
+    {
+        id: 'WF-032',
+        module: 'workflow',
+        appliesTo: ['create', 'update', 'preview'],
+        sourceRef: "WorkflowStep.cs EvaluateAsync: kural yalnız rule.WorkflowId ve rule.Expression okur; girdi workflow.HasParameter iken Expression'ın DataTransferObjectExpression.Eval'iyle bağlanır, başka hiçbir alan okunmaz. Studio WorkflowTrigger.svelte de yalnız bu iki alanı yazar ve expression'ı çağrılan akışın parameterScheme'inden nesne literali olarak doldurur. RFQ koşusu W-7 (2026-09-14): payloadExpression/customParameters kaydedildi, alt akış girdisiz koştu",
+        check: (definition, context) => workflowCallSites(workflowBody(definition, context.workflowKind)).flatMap(({ label, rule }) => {
+            const workflowId = rule.workflowId;
+            if (!hasText(workflowId)) {
+                return [{
+                        ruleId: 'WF-032',
+                        severity: 'block',
+                        message: `'${label}' workflow adımında rule.workflowId yok — adım hangi akışı çağıracağını bilmez. workflow_list(applicationId, type: 'workflow') ile id seçin; girdi rule.expression'a nesne literali olarak yazılır (çağrılan akışın parametre DTO'suna göre).`,
+                        guide: 'ngapps://guides/workflow'
+                    }];
+            }
+            if (!GUID_PATTERN.test(String(workflowId))) {
+                return [{
+                        ruleId: 'WF-032',
+                        severity: 'block',
+                        message: `'${label}' adımının rule.workflowId'si GUID değil: '${String(workflowId)}'. Platform alanı Guid'e çeviremediği için 400 döner; slug değil id verin (workflow_list).`,
+                        guide: 'ngapps://guides/workflow'
+                    }];
+            }
+            const savedButUnread = WORKFLOW_STEP_SAVED_BUT_UNREAD_KEYS.filter(key => carriesValue(rule[key]));
+            const unmapped = WORKFLOW_STEP_UNMAPPED_INPUT_KEYS.filter(key => carriesValue(rule[key]));
+            if (savedButUnread.length === 0 && unmapped.length === 0)
+                return [];
+            const fate = [
+                savedButUnread.length > 0 ? `${savedButUnread.map(key => `rule.${key}`).join(', ')} kaydedilir ama WorkflowStep okumaz` : '',
+                unmapped.length > 0 ? `${unmapped.map(key => `rule.${key}`).join(', ')} StepRuleDto'da yok, platform hiç kaydetmez (unmappedMembers)` : ''
+            ].filter(part => part !== '').join('; ');
+            return [{
+                    ruleId: 'WF-032',
+                    severity: 'block',
+                    message: `'${label}' adımı alt akışa girdiyi yanlış alandan gönderiyor — ${fate}. WorkflowStep yalnız rule.workflowId ve rule.expression okur: iki durumda da alt akış boş girdiyle koşar ve 200 döner (RFQ koşusu W-7). Eşlemeyi rule.expression'a nesne literali olarak yazın — her anahtar çağrılan akışın parametre DTO'sundaki bir alan, her değer bir JS ifadesi: "({ title: input.title, source: 'telemetry' })". Aynı adlı alan code adımında GÖVDE, workflow/microfunction adımında GİRDİDİR. Alan listesini workflow_step_schema (parameterScheme) ya da workflow_get(<workflowId>).parameterDtoId → dto_get verir.`,
+                    guide: 'ngapps://guides/workflow'
+                }];
+        })
+    },
     {
         id: 'WF-006',
         module: 'workflow',
@@ -2873,6 +2953,89 @@ export async function microfunctionStepFindings(platform, project, environment,
     }
     return applyPolicyMode(platform.config, findings, policyOverride);
 }
+/**
+ * WF-032'nin ikinci yarısı. `rule.expression`'ın işe yarayıp yaramayacağı gövdeden görülemez:
+ * `WorkflowStep` ifadeyi YALNIZ çağrılan akışın parametre DTO'su varken değerlendirir
+ * (`workflow.HasParameter`); DTO'suz alt akışa yazılan ifade hiç koşmaz ve girdi boş gider.
+ * Karar çağrılan akışın kaydında yaşar — gateway `workflow_get` ucunu okur ve bulguyu aynı
+ * `policyFindings` kanalına koyar; `policyOverride` / `POLICY=warn` kaçışları aynen geçerlidir.
+ *
+ * Okuma başarısız olursa kural SUSAR (WF-MF-001 ile aynı gerekçe). Uygulama kimliği ne
+ * parametrede ne gövdede varsa (automation yolu `entityId` ile çalışır) da susar: statik yarı
+ * yine koşar, canlı yarı bir kolaylıktır.
+ */
+export async function workflowStepFindings(platform, project, environment, applicationId, definition, kind, policyOverride = false) {
+    if (platform.config.policyMode === 'off')
+        return [];
+    const application = hasText(applicationId)
+        ? String(applicationId)
+        : hasText(definition.applicationId) ? String(definition.applicationId) : undefined;
+    if (application === undefined)
+        return [];
+    const sites = workflowCallSites(workflowBody(definition, kind))
+        .filter(site => GUID_PATTERN.test(String(site.rule.workflowId ?? '')));
+    if (sites.length === 0)
+        return [];
+    const guide = 'ngapps://guides/workflow';
+    const records = new Map();
+    const findings = [];
+    for (const { label, rule } of sites) {
+        const workflowId = String(rule.workflowId);
+        if (!records.has(workflowId)) {
+            try {
+                const payload = await platform.tenant('GET', project, `/workflows/${application}/${workflowId}`, { environment });
+                records.set(workflowId, (payload?.data ?? payload));
+            }
+            catch (error) {
+                records.set(workflowId, error instanceof PlatformApiError && error.status === 404 ? 'missing' : 'unreadable');
+            }
+        }
+        const record = records.get(workflowId);
+        if (record === undefined || record === 'unreadable')
+            continue;
+        if (record === 'missing') {
+            findings.push({
+                ruleId: 'WF-032',
+                severity: 'block',
+                message: `'${label}' adımının workflowId'si (${workflowId}) bu ortamda YOK (platform kaydı yalnız id ile arar, uygulama kimliğine bakmaz). Adım kuralı step_rules.workflow_id ile kayda FK'lıdır: gövde gitseydi platform 400 dönerdi. workflow_list(applicationId: '${application}', type: 'workflow') ile bu ortamdaki akışları görün — alt akış başka bir dalda ya da ortamda kalmış, ya da henüz yaratılmamış olabilir.`,
+                guide
+            });
+            continue;
+        }
+        const calleeName = String(record.name ?? record.slug ?? workflowId);
+        const parameterDtoId = hasText(record.parameterDtoId) ? String(record.parameterDtoId) : undefined;
+        const expression = hasText(rule.expression) ? String(rule.expression) : '';
+        if (expression !== '' && parameterDtoId === undefined) {
+            findings.push({
+                ruleId: 'WF-032',
+                severity: 'block',
+                message: `'${label}' adımı '${calleeName}' akışına rule.expression ile girdi geçiriyor ama o akışın parametre DTO'su YOK (parameterDtoId boş). WorkflowStep ifadeyi yalnız workflow.HasParameter iken değerlendirir: bu hâliyle ifade HİÇ çalışmaz, alt akış boş girdiyle koşar ve 200 döner. Önce alt akışa girdi sözleşmesi verin — dto_create ile alan listesini tanımlayın, sonra workflow_patch(id: '${workflowId}', ops: [{ op: 'add', path: '/parameterDtoId', value: '<dtoId>' }, { op: 'add', path: '/parameterBehavior', value: 'object' }]); alt akışın adımları girdiyi input.<alan> ile okur.`,
+                guide
+            });
+            continue;
+        }
+        if (expression === '' && parameterDtoId !== undefined) {
+            findings.push({
+                ruleId: 'WF-032',
+                severity: 'warn',
+                message: `'${label}' adımında rule.expression boş ama '${calleeName}' akışının parametre DTO'su var (parameterDtoId: ${parameterDtoId}). Alt akış input olarak boş nesne alır, kendi input.<alan> okumaları undefined döner. Girdiyi nesne literaliyle geçirin — alan listesini workflow_step_schema çıktısındaki parameterScheme ya da dto_get('${parameterDtoId}') verir.`,
+                guide
+            });
+            continue;
+        }
+        const behavior = String(record.parameterBehavior ?? '').toLowerCase();
+        const literal = literalShapeOf(expression);
+        if (literal !== undefined && ((behavior === 'array' && literal === 'object') || (behavior === 'object' && literal === 'array'))) {
+            findings.push({
+                ruleId: 'WF-032',
+                severity: 'warn',
+                message: `'${label}' adımının ifadesi ${literal === 'object' ? 'nesne' : 'dizi'} literaliyle başlıyor ama '${calleeName}' akışının parameterBehavior'ı '${behavior}': alt akış input olarak ${behavior === 'array' ? 'DİZİ bekler; nesne alınca öğe okumaları' : 'NESNE bekler; dizi alınca input.<alan> okumaları'} undefined döner. İfadeyi davranışa uydurun ya da alt akışın parameterBehavior'ını değiştirin.`,
+                guide
+            });
+        }
+    }
+    return applyPolicyMode(platform.config, findings, policyOverride);
+}
 const partialWriteOperations = new Set(['create', 'update', 'upsert']);
 const inputReferencePattern = /\binput\.([A-Za-z_$][\w$]*)/g;
 function inputReferencesOf(rule) {