@appaflytech/zeyrek-ai-mcp 0.0.4 → 0.0.6

package/dist/platform/tokenVault.js

@@ -0,0 +1,89 @@
+import { PlatformApiError } from './errors.js';
+import { randomBytes } from 'node:crypto';
+/**
+ * `page_screenshot`/`page_runtime_get` açıklaması "jetonu uygulamanın kendi giriş ucundan alın
+ * (`microservice_execute`)" diyor, ama gizli alan maskesi `access_token`'ı `***` yapıyor ve o yol
+ * kapanıyor (ölçüldü 2026-09-04, benchmark 4. koşu — jeton geçici olarak maskelenmeyen bir alana
+ * taşınıp geri alınarak çalışıldı, yani uygulamanın yanıt sözleşmesi bozuldu).
+ *
+ * Kasa bu çelişkiyi jetonu bağlama HİÇ sokmadan çözer: maskelenen JWT gateway sürecinde tutulur,
+ * yanıta yalnız kısa ömürlü bir referans (`tok_…`) döner ve kimlik isteyen tool'lar referansı
+ * çözer. Jeton ne yanıtta ne günlükte açık görünür.
+ */
+const ttlMs = 15 * 60 * 1000;
+const maxEntries = 64;
+const vault = new Map();
+export const tokenRefPattern = /^tok_[0-9a-f]{16}$/;
+/** Üç base64url parçalı JWT — parola ya da API anahtarı bu şekle uymaz. */
+export function looksLikeJwt(value) {
+    return typeof value === 'string' && /^[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]{8,}$/.test(value);
+}
+function sweep(now) {
+    for (const [ref, entry] of vault) {
+        if (entry.expires <= now)
+            vault.delete(ref);
+    }
+    while (vault.size >= maxEntries) {
+        const oldest = vault.keys().next();
+        if (oldest.done)
+            break;
+        vault.delete(oldest.value);
+    }
+}
+export function rememberToken(token) {
+    const now = Date.now();
+    sweep(now);
+    for (const [ref, entry] of vault) {
+        if (entry.token === token) {
+            entry.expires = now + ttlMs;
+            return ref;
+        }
+    }
+    const ref = `tok_${randomBytes(8).toString('hex')}`;
+    vault.set(ref, { token, expires: now + ttlMs });
+    return ref;
+}
+export function resolveToken(reference) {
+    const entry = vault.get(reference);
+    if (!entry)
+        return undefined;
+    if (entry.expires <= Date.now()) {
+        vault.delete(reference);
+        return undefined;
+    }
+    return entry.token;
+}
+export function clearTokenVault() {
+    vault.clear();
+}
+/**
+ * `tok_…` referansı kasadan çözülür, ham JWT olduğu gibi geçer. Süresi dolmuş referans sessizce
+ * başlıksız isteğe DÜŞMEZ — o durumda çağrı anonim gider ve "korumalı uç 401 döndü" diye yanlış
+ * teşhis üretir. Sayfa ve uç araçları aynı sözleşmeyi paylaşsın diye burada yaşar (G-20).
+ */
+export function resolveIdentityToken(value) {
+    if (value === undefined || !tokenRefPattern.test(value))
+        return value;
+    const token = resolveToken(value);
+    if (token === undefined) {
+        throw new PlatformApiError(`'${value}' referansı geçersiz ya da süresi dolmuş (15 dk). Uygulamanın giriş ucunu microservice_execute ile yeniden çağırıp yanıttaki tokenRefs değerini kullanın.`, 400);
+    }
+    return token;
+}
+/**
+ * Kimlik iki kanalda birden taşınır: `Authorization` başlığı VE `NG_AccessToken` çerezi. Middleware
+ * jetonu çerezden okuyor (`cookie.CORE_Token || cookie.NG_AccessToken`), gateway ise yalnız başlık
+ * gönderiyordu; bu yüzden uca middleware bağlandığı anda preview/debug/execute 401'e düşüyordu
+ * (ölçüldü 2026-09-05, Corecruiter koşusu `S-21`). Uygulamanın kendi çerez adı için `cookies`.
+ */
+export function identityHeaders(asUser, cookies, callerHeaders) {
+    const token = resolveIdentityToken(asUser);
+    const cookieText = Object.entries(cookies ?? {}).map(([name, value]) => `${name}=${value}`).join('; ');
+    if (token === undefined && cookieText === '')
+        return callerHeaders;
+    return {
+        ...(token === undefined ? {} : { authorization: `Bearer ${token}` }),
+        ...callerHeaders,
+        ...(cookieText === '' ? {} : { cookie: cookieText })
+    };
+}

package/dist/platform/writeDiff.js

@@ -0,0 +1,281 @@
+import { logStep } from '../observability/trace.js';
+const maxDrops = 20;
+const maxDepth = 12;
+const missing = Symbol('missing');
+/**
+ * Platformun kendi doldurduğu alanlar. Yalnız gönderilen tarafta da varsalar (patch yolunda gövde
+ * okunup geri yazılır) fark üretirlerdi ve bu fark hep gürültüdür: `audit.updatedAt` her yazmada
+ * değişir. 09-05 koşusunda `microservice_patch` yanıtındaki iki satırdan biri buydu.
+ */
+const serverManagedKeys = new Set([
+    'audit', 'createdAt', 'updatedAt', 'createdUserId', 'createdUserName', 'updatedUserId', 'updatedUserName'
+]);
+/**
+ * Platformun KENDİ ürettiği kimlik. Gönderilen id kaydedilenden farklıysa bu bir kayıp değildir:
+ * öğe kaydedilmiştir, yalnız kimliğini platform atamıştır (`args.iteratees[].id`,
+ * `args.parameters[].id` — 09-05 koşusunda `flow_create` 19, `flow_patch` 21 sahte satır üretti ve
+ * ajan hepsini elle ayıkladı). Kaydedilen tarafta id HİÇ yoksa bu muafiyet geçmez; o gerçek bir
+ * kayıptır. Adım ve dal id'leri zaten gönderildiği gibi kaydedilir, dolayısıyla fark üretmezler.
+ */
+const platformAssignedKeys = new Set(['id']);
+/**
+ * Dizi öğelerini indeksle değil KİMLİKLE eşleştirmek için aranan alanlar, öncelik sırasıyla.
+ * Platform diziyi kendi sırasında geri döndürüyor (`flow_get` adımları kayıt sırasında vermiyor);
+ * indeksle karşılaştırma o durumda her öğeyi "değişmiş" gösterir ve diff okunamaz hâle gelir.
+ *
+ * `id` listenin SONUNDADIR: platform onu yeniden atıyor (`platformAssignedKeys`), dolayısıyla
+ * kimlik olarak en zayıf aday odur. `fieldId` başta çünkü `sourceParameters.selectFields`
+ * elemanlarının tek kararlı anahtarı odur — 2026-09-06 koşusunda o dizi başka sırada geri döndü
+ * ve indeks tabanlı karşılaştırma altı sahte satır üretti (`S-1`).
+ */
+const identityKeys = ['fieldId', 'stepId', 'elementId', 'slug', 'name', 'key', 'id'];
+/**
+ * Platformun KABUL EDİP saklamadığı kolaylık alanları. Yanıtta ya hiç yoklar ya da `null`
+ * dönerler; ikisi de kayıp değildir, alan zaten türetilebilir. Her satır hangi ölçümle eklendi:
+ *
+ * - `fieldSlug` — 2026-09-06 koşusu, üç `workflow_create` yanıtında 24 satır
+ *   (`gönderilen "id" ↔ kaydedilen null`). Platform slug'ı `fieldId`'den çözüyor, saklamıyor.
+ *
+ * Muafiyet YALNIZ saklanmama durumunu kapsar: alan dolu ama BAŞKA değerle döndüyse fark yine
+ * bildirilir — orası gerçek bir yeniden yazmadır.
+ */
+export const unstoredKeys = new Set(['fieldSlug']);
+/**
+ * Platformun kanonik adıyla sakladığı eşdeğer değerler. Fark gerçektir ama KAYIP değildir:
+ * `silentlyDropped` yerine `gatewayNormalized` ile bildirilir. Her satır hangi ölçümle eklendi:
+ *
+ * - `type: string ↔ text` — 2026-09-06 koşusu, `queryParameters.type` (`S-1`).
+ */
+const canonicalValues = {
+    type: [['string', 'text']]
+};
+/**
+ * Yolun son alan adı; `tags[0]` ya da `fields[fieldId=x]` gibi indeks/anahtar ekini atar.
+ */
+function leafKey(path) {
+    return (path.split('.').pop() ?? '').replace(/\[[^\]]*\]$/, '');
+}
+function render(value) {
+    const text = JSON.stringify(value) ?? String(value);
+    return text.length > 160 ? `${text.slice(0, 157)}…` : text;
+}
+function identityKeyFor(entries) {
+    const objects = entries.filter((entry) => Boolean(entry) && typeof entry === 'object' && !Array.isArray(entry));
+    if (objects.length === 0 || objects.length !== entries.length)
+        return undefined;
+    return identityKeys.find(key => {
+        const values = objects
+            .map(entry => entry[key])
+            .filter(value => typeof value === 'string' || typeof value === 'number')
+            .map(String);
+        return values.length === objects.length && new Set(values).size === objects.length;
+    });
+}
+function lookup(saved, key) {
+    if (typeof key === 'number')
+        return Array.isArray(saved) && key < saved.length ? saved[key] : missing;
+    if (!saved || typeof saved !== 'object' || Array.isArray(saved))
+        return missing;
+    const record = saved;
+    return Object.hasOwn(record, key) ? record[key] : missing;
+}
+function compare(sent, saved, path, sink, depth) {
+    if (sink.dropped.length >= maxDrops || depth > maxDepth)
+        return;
+    if (Array.isArray(sent)) {
+        if (saved === missing) {
+            sink.dropped.push(`${path}: gönderilen ${render(sent)} ↔ kaydedilen yok`);
+            return;
+        }
+        const key = Array.isArray(saved) ? identityKeyFor(sent) : undefined;
+        const savedByIdentity = key
+            ? new Map(saved
+                .filter((entry) => Boolean(entry) && typeof entry === 'object' && !Array.isArray(entry))
+                .map(entry => [String(entry[key]), entry]))
+            : undefined;
+        // Hiçbir kimlik örtüşmüyorsa anahtar bu dizide anlamlı değildir (öğe yeniden adlandırılmış ya
+        // da dizi baştan yazılmış olabilir); indeksle karşılaştırmak orada daha okunur bir fark üretir.
+        if (key && savedByIdentity && sent.some(entry => savedByIdentity.has(String(entry[key])))) {
+            for (const entry of sent) {
+                const identity = String(entry[key]);
+                compare(entry, savedByIdentity.has(identity) ? savedByIdentity.get(identity) : missing, `${path}[${key}=${identity}]`, sink, depth + 1);
+            }
+            return;
+        }
+        const before = sink.dropped.length;
+        sent.forEach((entry, index) => compare(entry, lookup(saved, index), `${path}[${index}]`, sink, depth + 1));
+        // Sıra tabanlı karşılaştırmada "değişmiş" görünen öğe aslında yer değiştirmiş olabilir. Tek
+        // elemanlı dizide sıra farkı imkânsız olduğu için not düşülmez (2026-09-06 · S-1).
+        if (Array.isArray(saved) && sent.length > 1 && saved.length > 1 && sink.dropped.length > before) {
+            sink.dropped.splice(before, 0, `${path}: (sıra tabanlı karşılaştırma — anahtar yok) aşağıdaki farklar platform diziyi başka sırada sakladıysa yanıltıcıdır`);
+        }
+        return;
+    }
+    if (sent && typeof sent === 'object') {
+        if (saved === missing) {
+            sink.dropped.push(`${path}: gönderilen ${render(sent)} ↔ kaydedilen yok`);
+            return;
+        }
+        for (const [key, entry] of Object.entries(sent)) {
+            if (serverManagedKeys.has(key))
+                continue;
+            compare(entry, lookup(saved, key), path === '' ? key : `${path}.${key}`, sink, depth + 1);
+        }
+        return;
+    }
+    if (sent === null || sent === undefined)
+        return;
+    const field = leafKey(path);
+    if (unstoredKeys.has(field) && (saved === missing || saved === null))
+        return;
+    if (saved === missing) {
+        sink.dropped.push(`${path}: gönderilen ${render(sent)} ↔ kaydedilen yok`);
+        return;
+    }
+    if (sent === saved)
+        return;
+    if (platformAssignedKeys.has(field))
+        return;
+    if (canonicalValues[field]?.some(group => group.includes(String(sent)) && group.includes(String(saved)))) {
+        sink.normalized.push(`${path}: gönderilen ${render(sent)} platformun kanonik adıyla ${render(saved)} olarak saklandı — eşdeğer, kayıp değil`);
+        return;
+    }
+    sink.dropped.push(`${path}: gönderilen ${render(sent)} ↔ kaydedilen ${render(saved)}`);
+}
+/**
+ * Sol taraf platforma GİDEN gövdedir (gateway normalizasyonu uygulandıktan sonrası), sağ taraf
+ * platformun döndürdüğü kayıt. Yalnız sol tarafta var olan yollar dolaşılır; sunucunun eklediği
+ * id/createdAt gibi alanlar fark üretmez. Kök hiç örtüşmüyorsa (yanıt bir kabul/kuyruk gövdesiyse)
+ * karşılaştırma yapılmaz — "her şey düştü" gürültüsü yanlış alarmdır.
+ *
+ * İki liste döner: `dropped` gerçekten kaybolan alanlar, `normalized` platformun kanonik adıyla
+ * sakladığı eşdeğerler. İkincisi `gatewayNormalized`a gider, uyarıya değil.
+ */
+export function writeDiff(sent, saved, aliases = {}) {
+    const sink = { dropped: [], normalized: [] };
+    if (!sent || typeof sent !== 'object')
+        return sink;
+    const wrapper = saved && typeof saved === 'object' && !Array.isArray(saved)
+        ? saved
+        : undefined;
+    const inner = wrapper?.data;
+    const root = inner && typeof inner === 'object' ? inner : saved;
+    // Bazı uçlar gönderilen alanı BAŞKA ADLA geri döner (query: parameters → parameterScheme).
+    // Alias verilmezse alan "sessizce düştü" diye raporlanır; bu yanlış alarm 09-04 koşusunda
+    // ajanı parametreleri kaldırmaya yöneltti ve kayıt 500 ile reddedildi (B-15).
+    const comparable = Object.fromEntries(Object.entries(sent)
+        .filter(([key]) => aliases[key] === undefined || lookup(root, aliases[key]) === missing));
+    const keys = Object.keys(comparable);
+    const shared = keys.filter(key => lookup(root, key) !== missing);
+    if (keys.length > 0 && shared.length === 0)
+        return sink;
+    compare(comparable, root, '', sink, 0);
+    if (sink.dropped.length >= maxDrops) {
+        sink.dropped.push(`… ilk ${maxDrops} fark listelendi, daha fazla fark var — gövdeyi *_get ile okuyup karşılaştırın.`);
+    }
+    return sink;
+}
+export function silentlyDropped(sent, saved, aliases = {}) {
+    return writeDiff(sent, saved, aliases).dropped;
+}
+export function withWriteDiff(payload, diff) {
+    const drops = Array.isArray(diff) ? diff : diff.dropped;
+    const normalized = Array.isArray(diff) ? [] : diff.normalized;
+    if (drops.length > 0) {
+        logStep('sessiz düşme ⚠', `${drops.length} alan gönderildi ama kayda geçmedi — platform hata vermeden yok saydı, yanıta silentlyDropped olarak eklenir`, drops);
+    }
+    if (normalized.length > 0) {
+        logStep('düzeltme', `platform ${normalized.length} alanı kanonik adıyla sakladı — eşdeğer, yanıta gatewayNormalized olarak eklenir`, normalized);
+    }
+    if (!payload || typeof payload !== 'object')
+        return payload;
+    if (drops.length === 0 && normalized.length === 0)
+        return payload;
+    const existing = payload.gatewayNormalized;
+    return {
+        ...payload,
+        ...(drops.length > 0 ? { silentlyDropped: drops } : {}),
+        ...(normalized.length > 0
+            ? { gatewayNormalized: [...(Array.isArray(existing) ? existing : []), ...normalized] }
+            : {})
+    };
+}
+/**
+ * Platform şemada her değeri bir Prop nesnesine sarar (`{ type, data, ref? }`) ve iç içe sözlükleri
+ * de sarar: `style: { padding: '40px' }` kaydedilince `style.data.padding = { type: 'static',
+ * data: '40px' }` olur. Micro-op ise HAM değer gönderir. Karşılaştırmadan önce sarmalı açmazsak
+ * doğru kaydedilmiş her prop "değişmiş" görünür.
+ */
+export function unwrapProps(value) {
+    if (Array.isArray(value))
+        return value.map(unwrapProps);
+    if (!value || typeof value !== 'object')
+        return value;
+    const record = value;
+    const isProp = typeof record.type === 'string' && (Object.hasOwn(record, 'data') || Object.hasOwn(record, 'ref'));
+    if (isProp) {
+        // `code` ve `translation` prop'larında taşıyıcı alan `ref`'tir; `data` yalnız tasarım zamanı
+        // yedeğidir (platform_guide('translation')).
+        const carrier = record.type === 'code' || record.type === 'translation'
+            ? (Object.hasOwn(record, 'ref') ? record.ref : record.data)
+            : (Object.hasOwn(record, 'data') ? record.data : record.ref);
+        return unwrapProps(carrier);
+    }
+    return Object.fromEntries(Object.entries(record).map(([key, entry]) => [key, unwrapProps(entry)]));
+}
+function findByElementId(nodes, elementId) {
+    if (!Array.isArray(nodes))
+        return undefined;
+    for (const node of nodes) {
+        if (!node || typeof node !== 'object')
+            continue;
+        const record = node;
+        if (record.elementId === elementId)
+            return record;
+        const found = findByElementId(record.children, elementId);
+        if (found)
+            return found;
+    }
+    return undefined;
+}
+/**
+ * Micro-op'un YAZMAK İSTEDİĞİ ile şemada KAYITLI olanı karşılaştırır. Tam gövde yazmalarında
+ * `silentlyDropped` gönderilen gövdeyi dönen kayıtla karşılaştırabiliyor; micro-op yolunda dönen
+ * yanıt yalnız `appliedPatch` olduğu için karşılaştırma yamadan SONRA okunan şemaya dayanır.
+ */
+export function schemaOpDrops(schema, ops) {
+    if (!Array.isArray(ops))
+        return [];
+    const drops = [];
+    for (const op of ops) {
+        if (op.op === 'add_component') {
+            const component = (op.component ?? {});
+            const elementId = String(component.elementId ?? '');
+            const saved = elementId ? findByElementId(schema, elementId) : undefined;
+            if (!elementId)
+                continue;
+            if (!saved) {
+                drops.push(`add_component '${elementId}': komponent şemada bulunamadı — yama 200 döndü ama düğüm kaydedilmemiş.`);
+                continue;
+            }
+            for (const entry of silentlyDropped(unwrapProps(component), unwrapProps(saved))) {
+                drops.push(`add_component '${elementId}' → ${entry}`);
+            }
+            continue;
+        }
+        if (op.op === 'replace_prop' && typeof op.target === 'string' && typeof op.prop === 'string') {
+            const saved = findByElementId(schema, op.target);
+            if (!saved)
+                continue;
+            const props = (saved.props ?? {});
+            if (!Object.hasOwn(props, op.prop)) {
+                drops.push(`replace_prop '${op.target}.${op.prop}': prop şemada yok — değer kaydedilmemiş.`);
+                continue;
+            }
+            for (const entry of silentlyDropped({ [op.prop]: unwrapProps(op.value) }, { [op.prop]: unwrapProps(props[op.prop]) })) {
+                drops.push(`replace_prop '${op.target}' → ${entry}`);
+            }
+        }
+    }
+    return drops.slice(0, maxDrops);
+}

package/dist/resources/examples/layout-app-shell.json

@@ -12,7 +12,7 @@
     "slotRowIsOpenEnded": "Slot'un grid satırı açık uçludur (runtime 'y / auto' yazar): sayfa uzadıkça slot uzar. Slot'a sabit yükseklik vermeye çalışma.",
     "positionComesFromBlocks": "Konum ve boyut blocks[]'ten gelir. layout-region'daki dock prop'u konum DEĞİL biçim belirler; bu örnekte region hiç kullanılmıyor.",
     "gridStacksFlexDoesNot": "Bu örnek layout:'flex' — fill'in 'kalanı doldur' anlamı flex'te tanımlıdır (sütunda flex:1 1 auto, satırda align-self:stretch). Bedeli MOBİL: runtime'ın mobil kuralı yalnız ızgara özelliklerini ezer, flex satırı telefonda yan yana kalır (375px'te ölçüldü: 49/310px). Telefonda alt alta düşmesi gereken kabuk için kökü layout:'grid' kur; o zaman yükseklik yine blocks satırlarından gelir.",
-    "fixedPxWidthIsFlexOnly": "Bu örnek flex olduğu için yan menüye appearance.widthPx:240 verilebilir; verilmezse genişlik kolon payıdır (12'de 2 ≈ 1440px tasarım genişliğinde 240px). Izgara kabında widthPx okunmaz.",
+    "fixedPxWidthIsFlexOnly": "Bu örnek flex olduğu için yan menüye appearance.widthType:'fixed' + appearance.widthString:'240px' verilebilir (serbest CSS uzunluğu; string yalnız 'fixed' modda okunur). Öteki modlar: 'fill' kabın tüm genişliği, 'auto' içerik kadar; widthType hiç verilmezse genişlik kolon payıdır (12'de 2 ≈ 1440px tasarım genişliğinde 240px). Izgara kabında widthString okunmaz. Üç modun bir arada örneği: ngapps://examples/page-flex-sections.",
     "navigationsStyleIsDead": "navigations'ın style prop'u hiçbir şey yapmaz (Navigations.svelte style prop'u kabul etmiyor) — menü satırı biçimlendirmeye çalışma.",
     "verifyWithRuntime": "Layout'un kendi serve URL'i yok: gerçek çıktıyı layout'a bağlı bir sayfada page_runtime_get ile, slot kurgusunu page_state.layoutSlots ile doğrula.",
     "wrapperRoot": "Kök, sayfanın page_container'ının yerleşim ikizidir: states.isWrapper:true (çerçevesiz, başlıksız, saydam) + blocks x0/w12. Sarmalayıcı olmayan bir kök kenarlıklı beyaz bir kart olarak çizilir.",

package/dist/resources/examples/microservice-table-list.json

@@ -1,7 +1,7 @@
 {
   "_meta": {
     "synthetic": true,
-    "note": "hr + sms projelerinde doğrulanmış şekil. Kurallar: operation 'list' YOK → get + isSingle:false; kökte entityId zorunlu; selectFields'ta fieldId zorunlu + alias = entity slug; join'li alanlarda path = ilişki alanı id zinciri (kök alanlarda path yazılmaz), joins[].path = kökEntityId + aynı zincir — path boş bırakılırsa runtime çalışır ama Studio join alanlarını seçili gösteremez; sort/limit her zaman verilir yoksa Studio formu null'da patlar; filtre value alanı JavaScript ifadesidir."
+    "note": "hr + sms projelerinde doğrulanmış şekil. Kurallar: operation 'list' YOK → get + isSingle:false; kökte entityId zorunlu; selectFields'ta fieldId zorunlu + alias = entity slug; join'li alanlarda path = ilişki alanı id zinciri (kök alanlarda path yazılmaz), joins[].path = kökEntityId + aynı zincir — path boş bırakılırsa runtime çalışır ama Studio join alanlarını seçili gösteremez; sort/limit her zaman verilir yoksa Studio formu null'da patlar; filtre value alanı JavaScript ifadesidir. isReturnSchemaArray/isParameterSchemaArray örnekten ÇIKARILDI (2026-09-07): ikisi de yalnız okuma modelinde (MicroserviceDto) var, Create/UpdateMicroserviceCommand'da yok — gönderilirse sessizce yok sayılırlar."
   },
   "definition": {
     "name": "Get Products",
@@ -43,8 +43,6 @@
         "source": "query-string"
       }
     },
-    "entityId": "<products entity id>",
-    "isReturnSchemaArray": true,
-    "isParameterSchemaArray": false
+    "entityId": "<products entity id>"
   }
 }

package/dist/resources/examples/page-dynamic-form.json

@@ -11,7 +11,7 @@
     "twoWayBinding": "Çocuk komponentin prop'u {type:'code', ref:'{{ item.<alan> }}'} kalıbına TAM uyuyorsa kullanıcı değiştirdiğinde runtime değeri rows.data[<index>].<alan>'a geri yazar (repeater.handler.ts → handleRepeaterItemPropertySet). Flow gerekmez. Kalıp bozulursa ('{{ item.answer || \"\" }}') okur ama YAZMAZ.",
     "rowId": "Satırlara kalıcı bir id ver: getRepeaterRowId sırayla row._id / row.id / index'e bakar; id yoksa index'e düşer ve liste değişince girilen değerler kayar.",
     "variantsSameCell": "Satır tipine göre farklı alan göstermek için TÜM varyantları AYNI blocks[].position'a koy ve isHidden ile ayır — alt alta dizersen gizli olanların ızgara satırları boş kalır. Bu yalnız page_schema_patch yolunda güvenlidir (micro-op hattı çakışma normalizasyonu uygulamaz).",
-    "isHiddenGap": "isHidden her komponentte YOK (radio/textarea/container/form/button var; text ve multi-select yok). Gizlenecek komponenti isHidden'ı olan bir container'a sar ve koşulu SARMALAYICIYA bağla. Sarmalayıcı states.isWrapper:false olmalı (isWrapper → min-height:80vh).",
+    "isHiddenGap": "isHidden artık 101 kaydın 99'unda tanımlıdır (2026-08-26 toplu eklemesi; tanımlamayan yalnız slot ve widget-area) — text ve multi-select dahil çoğu komponente doğrudan yazılabilir. Sarmalayıcı yalnız birden çok düğümü TEK koşulla gizlemek gerektiğinde kullanılır; o zaman states.isWrapper:false olmalı (isWrapper → min-height:80vh).",
     "readBack": "Toplu okuma flow'da <repeaterAdı>.rows'tur; microservice parametresinin value.type:'code' ifadesinde ve condition expression'ında komponentlere ADIYLA erişilir. Kod bağlamında satırlar HAM gelir; machine.getNode ile bakarsan {data,type} sarılı görünür.",
     "perRowValidation": "Satır BAŞINA validation kurulamaz — validations komponentin kendisindedir ve tüm satırlar paylaşır. Zorunluluğu satır verisinde taşı (required) ve gönderim akışının ilk condition adımında denetle (guard adımı).",
     "flowGuids": "branches[].id ve iteratees[].id GUID'leri TÜM projede tekildir. Başka bir akıştan kopyaladığın gövdeyi aynı GUID'lerle gönderirsen platform RowAlreadyExists döner ve hata slug çakışması gibi okunur — bütün id alanlarını yenile.",
@@ -33,7 +33,7 @@
       "│        ├─ a_choice (radio)   y:2   isHidden: {{ !(item.is_single || item.is_yesno) }}",
       "│        ├─ a_text (textarea)  y:2   isHidden: {{ !item.is_text }}",
       "│        └─ box_multi (container) y:2  isHidden: {{ !item.is_multi }}",
-      "│           └─ a_multi (multi-select)  ← kendi isHidden'ı yok, o yüzden sarmalı",
+      "│           └─ a_multi (multi-select)  ← kendi isHidden'ı artık VAR; sarmal bu örneğin geçmişinden kaldı",
       "├─ box_state (container, isHidden:true) → t_state (text)   ← hata şeridi",
       "└─ btn_submit (button, type:'button')"
     ]

package/dist/resources/examples/page-flex-sections.json

@@ -0,0 +1,99 @@
+{
+  "_meta": {
+    "synthetic": true,
+    "note": "Flex boyut modeli (2026-09-01) örneği: wrap:true satır kapsayıcı içinde üç genişlik modu bir arada — 'fixed'+widthString sabit yan sütun, 'fill' kalan alanı alan ana bölge, widthType'sız (eski 12 kolon payı) tam genişlik alt şerit. Hücreler Studio Quick Stack iskeletiyle aynı desendedir (hücre tipi box, states.isQuickStack). page_schema_patch'in ops alanına olduğu gibi verilebilir.",
+    "pairsWith": "layout-app-shell (kabuk tarafındaki fixed/fill kullanımı), page-detail-profile (ızgara yerleşimli sayfa)",
+    "sourceRef": "platform_guide('page') Kural 1f-2; platform_guide('component') §appearance; zeyrek-frontend packages/ng-apps-screen-builder/src/flex-layout.ts (getFlexChildStyle, normalizeCssSize), apps/studio/src/components/screen-builder/quick-stack.functions.ts, zeyrek-frontend/docs/features/quick-stack.md"
+  },
+  "_rules": {
+    "explicitWidthType": "Flex çocuğun genişliği appearance.widthType'tan gelir — öncelik fill > fixed(+widthString) > auto > eski blocks.size.w payı (widthType hiç yoksa). Şemayı sen kuruyorsan modu AÇIKÇA yaz; cell_footer'daki mod eksikliği bilinçli bir fallback gösterimidir.",
+    "stringNeedsFixedMode": "widthString/heightString YALNIZ ilgili *Type:'fixed' iken okunur. 'fill'/'auto' moda string yazmak ölüdür — gateway PAGE-017 uyarısı verir, Studio paneli mod değişiminde string'i siler.",
+    "cssSizeAcceptance": "Boyut string'i kabul kuralı (normalizeCssSize): çıplak sayı px sayılır, birimler px/%/vw/vh/vmin/vmax/rem/em/ch, calc(...) geçer. Negatif, pt, fr, 'auto' GEÇMEZ — platform 200 döner ama panel ve runtime değeri sessizce düşürür (PAGE-018).",
+    "wrapDefaultTrue": "wrap varsayılanı 2026-09-01'den beri AÇIK: w:12 çocuklar alt satıra sararak dikey akar. Bu örnekte de açık bırakıldı; kapatırsan üç hücre tek satıra sıkışır.",
+    "gapThemeVars": "gap preset'leri tema değişkenidir (small/medium/large → var(--ng-spacing-sm/md/lg)); alan allowCustom'dır, '18px' gibi ham CSS de geçer.",
+    "quickStackSkeleton": "Studio'nun Quick Stack üreteci hücre olarak DAİMA box kurar, ebeveyne layout:'flex' + direction:'row' + wrap:true yazar ve satır span'ları 12'ye tamamlanır. states.isQuickStack yalnız editör süsüdür (kesikli çerçeve) — runtime'da hiçbir etkisi yoktur.",
+    "orderFromBlocks": "Flex'te sıra blocks[].position'dan gelir (önce y, sonra x) ve y yalnız SIRADIR; boşluk çizilmez. Yine de bitişik ver ki grid'e dönüşte şema geçerli kalsın.",
+    "heightStringOnlyFixed": "heightType:'fixed' ölçüyü heightString'den alır ('30vh' gibi), o yoksa size.h×10px'ten. heightType:'auto' içerik kadar, 'fill' ebeveynin bıraktığı yer."
+  },
+  "schemaPatchOps": [
+    {
+      "op": "add_component",
+      "parent": "page_container",
+      "component": {
+        "elementId": "sections_row",
+        "name": "sections_row",
+        "kind": "component",
+        "type": "container",
+        "props": {
+          "title": { "type": "static", "ref": null, "data": "" },
+          "layout": { "type": "static", "ref": null, "data": "flex" },
+          "direction": { "type": "static", "ref": null, "data": "row" },
+          "horizontalAlign": { "type": "static", "ref": null, "data": "left" },
+          "verticalAlign": { "type": "static", "ref": null, "data": "stretch" },
+          "size": { "type": "static", "ref": null, "data": "shrink" },
+          "gap": { "type": "static", "ref": null, "data": "medium" },
+          "wrap": { "type": "static", "ref": null, "data": true }
+        },
+        "states": { "isSticky": false, "isDroppable": true, "isScrollable": false, "isWrapper": false },
+        "appearance": { "heightType": "auto", "widthType": "fill", "marginType": "none", "paddingType": "none" },
+        "blocks": [{ "breakpoint": 1024, "size": { "w": 12, "h": 24 }, "position": { "x": 0, "y": 0 } }],
+        "children": [
+          {
+            "elementId": "cell_sidebar",
+            "name": "cell_sidebar",
+            "kind": "component",
+            "type": "box",
+            "props": {
+              "layout": { "type": "static", "ref": null, "data": "flex" },
+              "direction": { "type": "static", "ref": null, "data": "column" }
+            },
+            "states": { "isSticky": false, "isDroppable": true, "isScrollable": false, "isWrapper": false, "isQuickStack": true },
+            "appearance": { "heightType": "fixed", "heightString": "30vh", "widthType": "fixed", "widthString": "240px" },
+            "blocks": [{ "breakpoint": 1024, "size": { "w": 4, "h": 6 }, "position": { "x": 0, "y": 0 } }],
+            "children": [],
+            "events": [],
+            "validations": [],
+            "stateBindings": []
+          },
+          {
+            "elementId": "cell_main",
+            "name": "cell_main",
+            "kind": "component",
+            "type": "box",
+            "props": {
+              "layout": { "type": "static", "ref": null, "data": "flex" },
+              "direction": { "type": "static", "ref": null, "data": "column" }
+            },
+            "states": { "isSticky": false, "isDroppable": true, "isScrollable": false, "isWrapper": false, "isQuickStack": true },
+            "appearance": { "heightType": "auto", "widthType": "fill" },
+            "blocks": [{ "breakpoint": 1024, "size": { "w": 8, "h": 6 }, "position": { "x": 4, "y": 0 } }],
+            "children": [],
+            "events": [],
+            "validations": [],
+            "stateBindings": []
+          },
+          {
+            "elementId": "cell_footer",
+            "name": "cell_footer",
+            "kind": "component",
+            "type": "box",
+            "props": {
+              "layout": { "type": "static", "ref": null, "data": "flex" },
+              "direction": { "type": "static", "ref": null, "data": "row" }
+            },
+            "states": { "isSticky": false, "isDroppable": true, "isScrollable": false, "isWrapper": false, "isQuickStack": true },
+            "appearance": { "heightType": "auto" },
+            "blocks": [{ "breakpoint": 1024, "size": { "w": 12, "h": 6 }, "position": { "x": 0, "y": 6 } }],
+            "children": [],
+            "events": [],
+            "validations": [],
+            "stateBindings": []
+          }
+        ],
+        "events": [],
+        "validations": [],
+        "stateBindings": []
+      }
+    }
+  ]
+}

package/dist/resources/examples/page-sign-in.json

@@ -9,10 +9,11 @@
     "cookieNameContract": "setcookie'deki ad ile auth middleware'inin okuduğu ad BİREBİR aynı olmalı (burada APP_Token → middleware'de cookie.APP_Token). Uyuşmazlık 'her istek 401' olarak görünür ve teşhisi zordur.",
     "signInEndpoint": "Sign-in ucu bir workflow'dur: kullanıcıyı e-postayla bulur, şifreyi karşılaştırır, system.generateToken({...claims}) ile token üretir. Claim anahtarları neyse middleware onları okur (claims.userId gibi) — token.data.id diye evrensel bir alan YOKTUR. Bkz. platform_guide('expressions') ve platform_guide('middleware') Tarif 1.",
     "conditionAlways": "Token kontrolü condition ile yapılır; `always` dalı buton durumunu her koşumda sıfırlar, kural dalları başarı/hata yolunu ayırır.",
+    "submitButtonType": "Formun `submit` olayına akış bağlamak TEK BAŞINA yetmez: `button` varsayılan olarak `type=\"button\"` çizilir ve HTML form submit'i HİÇ doğmaz — tıklamak da alanda Enter da uca istek göndermez ve hiçbir hata çıkmaz (ölçüldü 2026-09-05; teşhis ancak gerçek tıklamayla mümkün oldu, `page_screenshot` `actions`). Bu yüzden butona `props.type = 'submit'` veriliyor. Alternatif: aynı akışı butonun `click` olayına da bağlamak. Gateway ikisi de yoksa FORM-003 ile uyarır.",
     "rawRedirect": "redirect isRaw:true iken path ÇOK SATIRLI JS bloğudur ve son ifadenin değeri hedef adrestir. 'Korunan sayfaya gitmek isterken login'e düşen kullanıcıyı geri gönderme' deseni budur; yoksa sabit bir sayfaya gidilir (pageId + path).",
     "objectProp": "Prop değeri nesne olabilir: icon → { type:'static', ref:{ name:'progress_activity' } }.",
     "pageIsPublic": "Giriş sayfasına middlewareIds BAĞLANMAZ (guard'lı olsaydı kullanıcı giriş yapamazdı). Buna karşılık diğer sayfalar ve korunan uçlar middlewareIds ile bağlanır.",
-    "notificationIsHidden": "notification KATALOĞUNDA isHidden YOKTUR: şemaya props.isHidden yazmak 'unknown-prop' ile reddedilir (bu örneğin eski hâli öyleydi — crm koşumu B-10). Runtime'da gizleme her komponentte çalışır ama prop'u SETTER yazar. Başlangıçta gizli göstermek için komponenti isHidden'ı OLAN bir container'a (box_message) sar ve koşulu sarmalayıcıya bağla; appearance.isHidden bir çözüm DEĞİLDİR — runtime onu hiç okumaz.",
+    "notificationIsHidden": "notification'ın şemasında isHidden 2026-08-26'dan beri VARDIR: props.isHidden'ı doğrudan bildirime yazabilirsin. Bu örnekteki box_message sarmalayıcısı o dönemin kalıntısıdır (crm koşumu B-10) ve tek bir bildirim için ARTIK GEREKMEZ — burada duruyor çünkü şeridi bir kaba sarıp birden çok parçayı birlikte gösterip gizliyor. appearance.isHidden ise hiçbir zaman çözüm DEĞİLDİR — runtime onu hiç okumaz.",
     "validationShape": "Validation gövdesi DÖRT alan taşır: { type, message, value, isActive }. 'name' anahtarı JsonIgnore'dur — {name, value, message} yazarsan tip enum varsayılanına düşer ve alan sessizce REGEX doğrulamasına döner. Tip adları TİRELİDİR (max-length / min-length / max-value / min-value); 'maxLength' backend'e yazılır ama runtime doğrulayıcı onu tanımaz ve doğrulama hiç koşmaz. Gateway düzeltebildiğini düzeltir, kalanını PAGE-016 ile reddeder."
   },
   "pageCreateArgs": {
@@ -103,7 +104,7 @@
       "parent": "sign_in_form",
       "component": {
         "elementId": "btn_sign_in", "kind": "component", "type": "button", "name": "btn_sign_in",
-        "props": { "text": { "type": "static", "data": "Giriş yap" } },
+        "props": { "text": { "type": "static", "data": "Giriş yap" }, "type": { "type": "static", "data": "submit" } },
         "states": { "isSticky": false, "isDroppable": false, "isScrollable": false, "isWrapper": false },
         "blocks": [{ "breakpoint": 1024, "size": { "h": 4, "w": 12 }, "position": { "x": 0, "y": 10 } }],
         "children": [], "events": [], "validations": [], "stateBindings": []