@appaflytech/zeyrek-ai-mcp 0.0.40 → 0.0.42

package/dist/knowledge/platform/batchOps.js

@@ -0,0 +1,70 @@
+import { PlatformApiError } from '../../platform/errors.js';
+/**
+ * Toplu yamanın zarfı (`{ op: 'batch', gestureId?, label?, ops: [...] }`) ARAÇ GİRİŞİNDE bir kez açılır: içindeki
+ * op'lar yerlerinde ve sırayla, tek tek yazılmış sayılır; gateway'in bütün geçişleri ve platforma giden gövde düz
+ * listeyi görür (sırayı platforma kadar `schemaOps.ts` `serverOpsInOrder` taşır). Platform için zarf yalnız
+ * gruplamadır — `PageSchemaMicroOpApplier.Apply` (backend) listeyi döngüsünün başında düzleştirir, `gestureId`/`label`
+ * hiçbir yerde okunmaz — bu yüzden düz liste aynı yazımdır.
+ *
+ * Girişte açılmadan önce her geçiş zarfa kendi bakıyordu ve çoğu bakmıyordu (TOOL-058, ölçüldü 2026-10-10, gerçek uç):
+ * zarf içindeki `replace_prop` sarılmadan gidip backend'in ham 422'sini aldı; kök kapsayıcıyı silen op, adsız düğüm
+ * ve gateway'in öykündüğü `resize_component` korumalardan geçmeden platforma ulaşıyordu.
+ *
+ * İç içe zarf reddedilir: platform onu `nested-batch` ile reddeder (`PageSchemaMicroOpApplier.ApplyOne`); gateway
+ * açarken kabul etseydi sözleşmeyi sessizce genişletirdi. `ops`'u liste olmayan zarf, op nesnesi olmayan öğe ve
+ * açılınca boş kalan yama da reddedilir — platform bunları sessizce yutar (`s.Ops ?? []`, `Where(w => w is not null)`)
+ * ve değişiklik olmadan sürüm ilerletir; gateway sessiz başarıyı geçirmez.
+ */
+export function openBatchEnvelopes(tool, ops) {
+    const envelopes = ops.filter(op => op.op === 'batch');
+    if (envelopes.length === 0)
+        return { ops: [...ops], envelopes: 0 };
+    const issues = ops.flatMap((op, index) => (op.op === 'batch' ? envelopeIssues(op, index) : []));
+    if (issues.length > 0)
+        throw new PlatformApiError(`${tool}: batch gövdesi geçersiz (istek gönderilmedi): ${issues.join(' · ')}`, 400);
+    const opened = ops.flatMap(op => (op.op === 'batch' ? op.ops : [op]));
+    if (opened.length === 0) {
+        throw new PlatformApiError(`${tool}: uygulanacak micro-op yok — batch zarfının 'ops' listesi boş (istek gönderilmedi).`, 400);
+    }
+    return { ops: opened, envelopes: envelopes.length };
+}
+/** `ops[<zarfın sırası>]` ile başlar: birden çok zarf varken hangisinin bozuk olduğu mesajdan okunur. */
+function envelopeIssues(envelope, at) {
+    const where = `ops[${at}] (batch)`;
+    if (!Array.isArray(envelope.ops))
+        return [`${where} 'ops' taşımalı: { op: 'batch', ops: [ …op'lar… ] }`];
+    return envelope.ops.flatMap((entry, index) => {
+        if (!entry || typeof entry !== 'object' || Array.isArray(entry))
+            return [`${where}.ops[${index}] bir op nesnesi değil`];
+        return entry.op === 'batch'
+            ? [`${where}.ops[${index}] yine bir batch: iç içe batch yok (platform 'nested-batch' ile reddeder) — içteki op'ları dıştaki listeye taşıyın`]
+            : [];
+    });
+}
+/** Zarf açıldıysa yanıta düşen not: ajan zarfın ne kazandırdığını (hiçbir şey) görür. */
+export function batchEnvelopeNote(opened) {
+    return opened.envelopes === 0
+        ? []
+        : [`batch zarfı açıldı (${opened.envelopes} zarf → ${opened.ops.length} op): op'lar tek tek yazılmış gibi işlendi ve platforma düz listeyle gitti — platform zarfı yalnız gruplama sayar (gestureId/label okunmaz).`];
+}
+/** Ret mesajına eklenen ipucu: `#<indeks>` ajanın GÖNDERDİĞİ listeye değil, zarf açıldıktan sonrakine göredir. */
+export function batchIndexHint(opened) {
+    return opened.envelopes === 0
+        ? ''
+        : ` İndeksler batch zarfı açıldıktan sonraki (${opened.envelopes} zarf → ${opened.ops.length} op) açılmış listeye göredir: zarfın içindeki op'lar, zarfın durduğu yerde sırayla sayılır.`;
+}
+/**
+ * Zarfı açan SAF görünüm (iç içe dahil, hata vermez): op listesini okuyan bilgi kuralları için. Araç yolunda liste
+ * `openBatchEnvelopes`'tan geçtiği için zarf buraya ulaşmaz; kurallar yine de op sözlüğünün tamamını tanır — doğrudan
+ * çağrıldıklarında (testler, başka araçlar) zarfa kör kalmazlar (TOOL-057, ölçüldü 2026-10-10: doğrudan
+ * `MOB-001, MOB-028`, zarf içinde bulgu yok). Çağıranlar: `lint.ts` `profileFindings` ve `profileLintReadsSavedNodes`,
+ * `heroTag.ts`. Emsal: `normalize.ts` `orphanedFlowPlan`.
+ */
+export function flattenBatchOps(ops) {
+    return ops.flatMap(op => (op.op === 'batch' ? flattenBatchOps(batchBody(op.ops)) : [op]));
+}
+function batchBody(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.filter((entry) => Boolean(entry) && typeof entry === 'object' && !Array.isArray(entry));
+}

package/dist/knowledge/platform/heroTag.js

@@ -0,0 +1,153 @@
+/**
+ * Paylaşılan öğe (Hero) etiketinin gateway aynası: değerin okunması, sayfanın etiketleri ve iki sayfanın eşlenmesi.
+ * Kaynak frontend'dedir (`zeyrek-frontend/packages/ng-apps-ui-native/src/motion/hero-tag.ts`, ADR
+ * `zeyrek-frontend/docs/adr/0022-hero-yolu.md`). Bu dosya onun kopyasıdır ve `test/hero-tag-parity.test.ts` ile
+ * kilitlidir: frontend'in altın vakaları (`hero-golden.json`) aynı girdiden aynı çıktıyı ve harfi harfine aynı uyarıyı
+ * vermeli. Test kırılınca test düzeltilmez, bu dosya senkronlanır.
+ */
+import { flattenBatchOps } from './batchOps.js';
+function asRecord(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : undefined;
+}
+/** Metin kırpılır, sayı metne çevrilir; boş metin ve başka her tür "etiket yok"tur. */
+export function heroTagValue(raw) {
+    if (typeof raw === 'number')
+        return Number.isFinite(raw) ? String(raw) : null;
+    if (typeof raw !== 'string')
+        return null;
+    return raw.trim() || null;
+}
+/** Düğümün ham `heroTag` prop'u (sarmalıyla): ifadeye bağlıysa değersiz, statikse metniyle; etiket yoksa `null`. */
+export function heroTagEntry(elementId, prop) {
+    const wrapped = asRecord(prop);
+    if (!wrapped)
+        return null;
+    if (wrapped.type === 'code' || wrapped.type === 'translation') {
+        return typeof wrapped.ref === 'string' && wrapped.ref.trim() ? { elementId, bound: true } : null;
+    }
+    const tag = heroTagValue(wrapped.data);
+    return tag === null ? null : { elementId, tag };
+}
+/** Sayfa şemasındaki etiketler, belge sırasıyla (önce düğüm, sonra çocukları). */
+export function heroTags(schema) {
+    if (!Array.isArray(schema))
+        return [];
+    return schema.flatMap(entry => {
+        const node = asRecord(entry);
+        if (!node)
+            return [];
+        const own = typeof node.elementId === 'string' && node.elementId ? heroTagEntry(node.elementId, asRecord(node.props)?.heroTag) : null;
+        return [...(own ? [own] : []), ...heroTags(node.children)];
+    });
+}
+function byTag(entries) {
+    const tags = new Map();
+    for (const entry of entries) {
+        if (entry.tag !== undefined)
+            tags.set(entry.tag, [...(tags.get(entry.tag) ?? []), entry.elementId]);
+    }
+    return tags;
+}
+function countBound(entries) {
+    return entries.filter(entry => entry.bound).length;
+}
+/**
+ * Bir sayfada aynı statik etiketi birden çok düğüm taşıyorsa: sayfa bir yakınlaşmanın HEDEFİ olduğunda hizalama kutusu
+ * tektir ve ilk çizilen düğüm hizalanır. Kaynak sayfada yineleme sorun değildir (kaynak dokunulan düğümdür).
+ */
+export function heroTagProblems(entries, page) {
+    return [...byTag(entries)]
+        .filter(([, nodes]) => nodes.length > 1)
+        .map(([tag, nodes]) => `${page ? `${page}: ` : ''}heroTag '${tag}' ${nodes.length} düğümde (${nodes.join(', ')}) — ilk çizilen hizalanır`);
+}
+/**
+ * İki sayfanın etiketlerini eşler. Çift, statik etiketi iki sayfada da olan iki düğümdür. Yineleme yalnız HEDEF
+ * sayfada uyarıdır. Eşi olmayan statik etiket uyarıdır — karşı sayfada ifadeye bağlı etiket yoksa (varsa eş çalışma
+ * anında oluşabilir). Bugün yalnız parite testi çağırır: sayfalar arası eşleme yazımda yapılmaz (hedef sayfa henüz
+ * yazılmamış olabilir); ayna, frontend kuralıyla birlikte hazır dursun diye taşınır.
+ */
+export function heroPairs(source, target) {
+    const sourceTags = byTag(source);
+    const targetTags = byTag(target);
+    const dynamic = { source: countBound(source), target: countBound(target) };
+    const unpaired = (tags, others, othersBound, where) => othersBound > 0 ? [] : [...tags].filter(([tag]) => !others.has(tag)).map(([tag, nodes]) => `heroTag '${tag}' (${nodes[0]}): ${where} eşi yok`);
+    return {
+        pairs: [...sourceTags].flatMap(([tag, nodes]) => {
+            const match = targetTags.get(tag);
+            return match ? [{ tag, source: String(nodes[0]), target: String(match[0]) }] : [];
+        }),
+        dynamic,
+        warnings: [
+            ...heroTagProblems(target, 'hedef sayfa'),
+            ...unpaired(sourceTags, targetTags, dynamic.target, 'hedef sayfada'),
+            ...unpaired(targetTags, sourceTags, dynamic.source, 'kaynak sayfada')
+        ]
+    };
+}
+function asList(value) {
+    return Array.isArray(value) ? value : value === undefined || value === null ? [] : [value];
+}
+function walkNodes(value, visit) {
+    for (const entry of asList(value)) {
+        const node = asRecord(entry);
+        if (!node)
+            continue;
+        if (typeof node.elementId === 'string' && node.elementId)
+            visit(node, node.elementId);
+        walkNodes(node.children, visit);
+    }
+}
+const HERO_PROP_OPS = new Set(['replace_prop', 'set_binding', 'set_prop_type']);
+/**
+ * Yama bir `heroTag` yazıyor mu: prop'u yazan op (`replace_prop`, `set_binding`, `set_prop_type`) ya da etiketli düğüm
+ * ekleyen `add_component` — toplu yamanın (`batch`) içinde de. Yinelenen etiket denetimi (MOB-030) sayfanın öteki
+ * düğümlerine bakar; yama yolu kayıtlı ağacı yalnız bu durumda okur.
+ */
+export function writesHeroTag(ops) {
+    return flattenBatchOps(ops).some(op => (HERO_PROP_OPS.has(String(op.op)) && op.prop === 'heroTag') ||
+        (op.op === 'add_component' && heroTags(asList(op.component)).length > 0));
+}
+/** Op'un `heroTag`'e yazdığı prop, saklanacağı sarmalla. `set_prop_type` kayıtlı prop'un tipini yerinde değiştirir. */
+function writtenHeroProp(op, saved) {
+    if (op.op === 'set_binding')
+        return { type: 'code', ref: typeof op.expression === 'string' ? op.expression : asRecord(op.value)?.ref ?? op.value };
+    if (op.op === 'set_prop_type') {
+        const data = op.data ?? op.value;
+        return { ...asRecord(saved), type: op.propType, ...(op.ref === undefined ? {} : { ref: op.ref }), ...(data === undefined ? {} : { data }) };
+    }
+    const wrapped = asRecord(op.value);
+    return wrapped && typeof wrapped.type === 'string' ? wrapped : { type: 'static', data: op.value };
+}
+/**
+ * Sayfanın yazımdan SONRAKİ etiketleri: kayıtlı ağaç + bu yazımın ekledikleri ve yazdıkları; kaldırılan düğümler alt
+ * ağaçlarıyla birlikte düşer. `written` bu yazımın dokunduğu düğümlerdir — MOB-030 yalnız onları içeren yinelemeyi
+ * söyler. Sıra "kayıtlılar, sonra yazılanlar"dır, belge sırası değil: yama sonrasının sırası burada bilinmez.
+ */
+export function heroTagsAfterWrite(input) {
+    const written = new Map();
+    const removed = new Set();
+    const savedProps = new Map();
+    const savedNodes = new Map();
+    walkNodes(input.savedNodes, (node, elementId) => {
+        savedNodes.set(elementId, node);
+        savedProps.set(elementId, asRecord(node.props)?.heroTag);
+    });
+    const write = (node, elementId) => written.set(elementId, heroTagEntry(elementId, asRecord(node.props)?.heroTag));
+    walkNodes(input.nodes, write);
+    for (const op of flattenBatchOps(input.ops ?? [])) {
+        const target = typeof op.target === 'string' ? op.target : '';
+        if (op.op === 'add_component')
+            walkNodes(op.component, write);
+        if (op.op === 'remove_component')
+            walkNodes(savedNodes.get(target), (_node, elementId) => removed.add(elementId));
+        if (HERO_PROP_OPS.has(String(op.op)) && op.prop === 'heroTag' && target)
+            written.set(target, heroTagEntry(target, writtenHeroProp(op, savedProps.get(target))));
+    }
+    return {
+        entries: [
+            ...heroTags(asList(input.savedNodes)).filter(entry => !written.has(entry.elementId) && !removed.has(entry.elementId)),
+            ...[...written.values()].filter((entry) => entry !== null)
+        ],
+        written: new Set(written.keys())
+    };
+}

package/dist/knowledge/platform/lint.js

@@ -1,9 +1,19 @@
 import { IMAGE_SOURCE_PROPS, IMAGE_SOURCE_PROP_NAMES, MOBILE_RULES, REDIRECT_PRESENTATIONS, fileIdImageExpression, missingComponentAdvice, styleReplacement } from './mobileRules.js';
+import { flattenBatchOps } from './batchOps.js';
+import { heroTagProblems, heroTagsAfterWrite, writesHeroTag } from './heroTag.js';
+import { PAGE_TRANSITIONS, resolveTransition } from './pageTransition.js';
 import { findingLine } from './profile.js';
 import { SURFACE_KEYS } from '../styleResolveNative.js';
+import { MOTION_BINDING_TYPES, MOTION_FIELDS, motionFieldBinding, motionValue } from '../motionResolve.js';
 import { DOCUMENT_STYLE_TYPES } from '../styleResolve.js';
 import { listThemeVarNames } from '../themeResolve.js';
 import { closestArgument } from '../../platform/argumentAliases.js';
+/**
+ * Uyarının yazımı durdurmadığını söyleyen cümle. OLAYI değil KURALI anlatır: aynı bulgu kuru koşuda
+ * (`page_schema_validate`) da döner ve orada hiçbir şey yazılmamıştır — "Yazım platforma gitti" kuru koşuda yanlıştı
+ * (TOOL-060, ölçüldü 2026-10-10, gerçek uç). Regresyon: `test/dry-run-wording.test.ts`.
+ */
+const NOT_BLOCKING = 'Yazım reddedilmez, platforma gider.';
 function asRecord(value) {
     return value && typeof value === 'object' && !Array.isArray(value) ? value : undefined;
 }
@@ -49,6 +59,7 @@ function label(node) {
 }
 const GRID_LAYOUTS = new Set(['grid', 'cssgrid']);
 const RELATIVE_UNIT = /\b\d*\.?\d+(em|rem)\b|calc\(/i;
+const TEMPLATE_VALUE = /\{\{[\s\S]*\}\}/;
 /**
  * THEME-012: mobil çizici `var(--ng-…)`'yi yalnız temanın yaydığı değişkenlerden çözer
  * (`compose-native-style.ts` `resolveThemeToken`); web'deki bileşen yerel değişkenleri (`--ng-nav-bg` …)
@@ -103,6 +114,7 @@ export function profileFindings(profile, input) {
     const floorImages = [];
     const namelessIconButtons = [];
     const unknownTokens = [];
+    const motionSkips = [];
     const hit = (map, key, target) => map.set(key, [...(map.get(key) ?? []), target]);
     const inspectTokens = (target, value) => {
         for (const name of unknownThemeTokens(value)) {
@@ -136,6 +148,42 @@ export function profileFindings(profile, input) {
                 hit(styleHits, `surfaceStyle.${key}`, target);
         }
     };
+    // MOB-028: hareket çözücüsü tanımadığı alt anahtarı ve okuyamadığı değeri ATLAR, nesne olmayan grubu hareket
+    // saymaz (frontend `resolve-motion.ts`) — yazım kabul edilir, hareket uyarısız eksik çıkar. Uyarı metni
+    // çözücününkidir. İfadeye bağlı GRUP (`code`/`translation` sarmalı; `data`sı yalnız tasarım yedeğidir) çalışma
+    // anında çözülür: burada okunamaz, denetlenmez. Grubun içindeki TEK alan ifadeye (`code`) bağlıysa o da çalışma
+    // anında değerlendirilir (frontend ADR 0020): uyarı değildir, yalnız tasarım yedeği denetlenir. Alanda çözülmeyen
+    // yazım (şablon metni, `code` dışı bağ) söylenir (`motionFieldBinding`).
+    const inspectMotion = (target, value) => {
+        if (boundWrapper(value))
+            return;
+        const raw = asRecord(value);
+        // Veri taşımayan sarmal yalnız BİLİNEN bir değer türüyse sarmaldır: alanı yanlışlıkla `type` diye yazılmış ham
+        // grup (`{ type: 'fade', duration: 300 }`) sarmal sanılıp denetimsiz geçiyordu.
+        if (raw && typeof raw.type === 'string' && (raw.type === 'static' || MOTION_BINDING_TYPES.includes(raw.type)) && !('data' in raw))
+            return;
+        const group = propValue(value);
+        if (group === undefined || group === null || group === '' || (typeof group === 'string' && TEMPLATE_VALUE.test(group)))
+            return;
+        const fields = asRecord(group);
+        if (!fields) {
+            motionSkips.push(`${target}: motionStyle: ${typeof group === 'string' ? `'${group}'` : JSON.stringify(group)} nesne değil — alanlar nesnenin içinde yazılır ({ enter: 'fade' }), hareket yok sayılır`);
+            return;
+        }
+        for (const [key, wrapped] of Object.entries(fields)) {
+            const binding = motionFieldBinding(key, wrapped);
+            if (binding?.kind === 'unresolved')
+                motionSkips.push(`${target}: ${binding.warning}`);
+            const field = binding ? binding.fallback : propValue(wrapped);
+            if (field === undefined || field === null || field === '')
+                continue;
+            const warning = MOTION_FIELDS.includes(key)
+                ? motionValue(key, field).warning
+                : `motionStyle.${key}: tanınmayan alan, atlandı`;
+            if (warning)
+                motionSkips.push(`${target}: ${warning}`);
+        }
+    };
     const inspectNode = (node) => {
         const target = label(node);
         const type = String(node.type ?? '');
@@ -154,6 +202,7 @@ export function profileFindings(profile, input) {
             gridNodes.push(`${target} (layout:${layout})`);
         inspectAppearance(target, asRecord(node.appearance));
         inspectSurface(target, props.surfaceStyle);
+        inspectMotion(target, props.motionStyle);
         for (const group of STYLE_GROUP_PROPS)
             inspectTokens(target, props[group]);
         if (type === 'image' && !imageHasDefiniteHeight(asRecord(node.appearance)))
@@ -182,7 +231,9 @@ export function profileFindings(profile, input) {
     walk(input.nodes, inspectNode);
     const savedTypes = new Map();
     walk(input.savedNodes, node => savedTypes.set(label(node), String(node.type ?? '')));
-    for (const op of input.ops ?? []) {
+    // Toplu yamanın zarfı açılır: içindeki op'lar tek tek yazılmış gibi denetlenir (TOOL-057).
+    const ops = flattenBatchOps(input.ops ?? []);
+    for (const op of ops) {
         const target = typeof op.target === 'string' ? op.target : '?';
         if (op.op === 'add_component')
             walk(op.component, inspectNode);
@@ -203,6 +254,8 @@ export function profileFindings(profile, input) {
                 hit(styleHits, 'hoverStyle', target);
             if (prop === 'surfaceStyle')
                 inspectSurface(target, op.value);
+            if (prop === 'motionStyle')
+                inspectMotion(target, op.value);
             if (STYLE_GROUP_PROPS.has(prop))
                 inspectTokens(target, op.value);
             // MOB-011: var olan düğümün tipi op'ta yok — tip biliniyorsa (aynı yazımda eklendi) ona, yoksa prop adına bakılır.
@@ -220,7 +273,7 @@ export function profileFindings(profile, input) {
             message: [
                 blockNodes.length > 0 ? `blok (12 sütun ızgara) mobil çizerde yok sayılır: ${[...new Set(blockNodes)].join(', ')}` : '',
                 gridNodes.length > 0 ? `grid/cssgrid yerleşimi yok, kap flex çizilir: ${gridNodes.join(', ')}` : ''
-            ].filter(Boolean).join(' · ') + ". Sıra dizi indeksinden, yerleşim flex'ten gelir (direction/gap/horizontalAlign). Yazım platforma gitti.",
+            ].filter(Boolean).join(' · ') + ". Sıra dizi indeksinden, yerleşim flex'ten gelir (direction/gap/horizontalAlign). " + NOT_BLOCKING,
             guide: "platform_guide('mobile')"
         });
     }
@@ -229,7 +282,33 @@ export function profileFindings(profile, input) {
             code: MOBILE_RULES['MOB-002'].id,
             severity: 'warn',
             target: [...new Set(targets)].join(', '),
-            message: `'${key}' mobilde çizilmez — ${styleReplacement(key.split(' ')[0] ?? key)}. Yazım platforma gitti.`
+            message: `'${key}' mobilde çizilmez — ${styleReplacement(key.split(' ')[0] ?? key)}. ${NOT_BLOCKING}`
+        });
+    }
+    // MOB-030: aynı sayfada aynı statik heroTag (frontend `hero-tag.ts`; ayna heroTag.ts). Sayfanın yazımdan SONRAKİ
+    // etiketleri okunur ve yalnız bu yazımın dokunduğu bir düğümü içeren yineleme söylenir — kayıtlı ağaçta zaten duran
+    // yineleme ilgisiz her yazımda yinelenmez. Bilgidir: yineleme yalnız sayfa bir yakınlaşmanın HEDEFİ olduğunda
+    // belirsizdir; kaynak sayfada aynı etiketli kartlar olağandır (kaynak dokunulan düğümdür).
+    const hero = heroTagsAfterWrite({ nodes: input.nodes, savedNodes: input.savedNodes, ops });
+    const heroDuplicates = [...new Set(hero.entries.filter(entry => entry.tag !== undefined).map(entry => entry.tag))]
+        .map(tag => hero.entries.filter(entry => entry.tag === tag))
+        .filter(group => group.length > 1 && group.some(entry => hero.written.has(entry.elementId)));
+    if (heroDuplicates.length > 0) {
+        findings.push({
+            code: MOBILE_RULES['MOB-030'].id,
+            severity: 'info',
+            target: heroDuplicates.flatMap(group => group.map(entry => entry.elementId)).join(', '),
+            message: `${heroDuplicates.flatMap(group => heroTagProblems(group)).join(' · ')}. Yalnız bu sayfa bir yakınlaşmanın HEDEFİ olduğunda önemlidir: hizalama kutusu tektir. Kaynak sayfada aynı etiketli kartlar ve liste satırları sorun değildir (kaynak dokunulan düğümdür); hedefte ayrı öğelerse ayrı etiket verin.`,
+            guide: "platform_guide('page') §Kural 1g-3"
+        });
+    }
+    if (motionSkips.length > 0) {
+        findings.push({
+            code: MOBILE_RULES['MOB-028'].id,
+            severity: 'warn',
+            target: [...new Set(motionSkips.map(entry => entry.split(':')[0] ?? entry))].join(', '),
+            message: `motionStyle'da çözücünün atladığı alan var, hareket eksik çıkar: ${[...new Set(motionSkips)].join(' · ')}. Alanlar: ${MOTION_FIELDS.join(', ')}. ${NOT_BLOCKING}`,
+            guide: "platform_guide('mobile')"
         });
     }
     if (unknownTokens.length > 0) {
@@ -237,7 +316,7 @@ export function profileFindings(profile, input) {
             code: 'THEME-012',
             severity: 'warn',
             target: [...new Set(unknownTokens.map(entry => entry.split(':')[0] ?? entry))].join(', '),
-            message: `temada tanımlı olmayan jeton cihazda çözülmez (zemin saydam kalır, iOS gölgesi içeriğe düşer): ${[...new Set(unknownTokens)].join(' · ')}. Geçerli adlar temanın yaydığı değişkenlerdir (theme_get); bilerek kullanıyorsanız yedek verin: var(--ad, #fff). Yazım platforma gitti.`,
+            message: `temada tanımlı olmayan jeton cihazda çözülmez (zemin saydam kalır, iOS gölgesi içeriğe düşer): ${[...new Set(unknownTokens)].join(' · ')}. Geçerli adlar temanın yaydığı değişkenlerdir (theme_get); bilerek kullanıyorsanız yedek verin: var(--ad, #fff). ${NOT_BLOCKING}`,
             guide: "platform_guide('theme')"
         });
     }
@@ -291,12 +370,14 @@ export function profileFindings(profile, input) {
             code: MOBILE_RULES['MOB-011'].id,
             severity: 'warn',
             target: fileIdSources.map(source => source.target).join(', '),
-            message: `${[...new Set(fileIdSources.map(source => `'${source.expression}'`))].join(', ')} '.value' ile bitiyor — kayıttan okunan FILE alanı { type: 'ref', value: <dosya id>, absolute_path: <url> } döner ve '.value' dosya KİMLİĞİDİR (GUID), görsel çizilmez. Nesnenin kendisini verin ('${object}') ya da '.absolute_path' yazın. Gateway alan tipini sayfa şemasından bilemez: yol FILE alanı değilse (ör. URL taşıyan metin alanı) uyarıyı yok sayın. Yazım platforma gitti.`,
+            message: `${[...new Set(fileIdSources.map(source => `'${source.expression}'`))].join(', ')} '.value' ile bitiyor — kayıttan okunan FILE alanı { type: 'ref', value: <dosya id>, absolute_path: <url> } döner ve '.value' dosya KİMLİĞİDİR (GUID), görsel çizilmez. Nesnenin kendisini verin ('${object}') ya da '.absolute_path' yazın. Gateway alan tipini sayfa şemasından bilemez: yol FILE alanı değilse (ör. URL taşıyan metin alanı) uyarıyı yok sayın. ${NOT_BLOCKING}`,
             guide: "platform_guide('mobile') §Dosya ve fotoğraf"
         });
     }
     const infoSteps = new Map();
     const badPresentation = new Map();
+    const badTransition = new Map();
+    const unusedTransition = new Map();
     walkSteps(input.steps, step => {
         const type = String(step.type ?? '');
         if (profile.steps.infoOnly.has(type))
@@ -307,10 +388,24 @@ export function profileFindings(profile, input) {
             return;
         const args = asRecord(step.args);
         const presentation = args?.presentation;
+        const stepId = String(step.stepId ?? step.name ?? '?');
+        // MOB-029: geçişin kararını çalışma zamanının çözücüsü verir (ayna: pageTransition.ts) — lint ikinci bir kural
+        // yazmaz. Alan YOKSA bulgu yok: adım uygulamanın varsayılanını kullanır. Sekme hedefi burada bilinmez
+        // (lint sekme ayarını görmez); o durumda da geçiş kullanılmaz ve rehber bunu söyler.
+        // Akış araçları bu lint'i BAŞARILI yazımdan sonra koşar ve küme dışı değeri backend 422 ile önce reddeder: uyarı
+        // dalı bugün yalnız backend'in doğrulamadığı bir yazım yolunda konuşur (MOB-008 ile aynı durum); bilgi dalı canlıdır.
+        if (args?.transition !== undefined && args.transition !== null && args.transition !== '') {
+            const resolved = resolveTransition({ step: args.transition, presentation }, { reduceMotion: false });
+            const written = typeof args.transition === 'string' ? args.transition : JSON.stringify(args.transition);
+            if (resolved.warnings.length > 0)
+                hit(badTransition, written, stepId);
+            else if (resolved.fixedBy === 'modal')
+                hit(unusedTransition, written, stepId);
+        }
         if (presentation === undefined || presentation === null || presentation === '')
             return;
         if (!REDIRECT_PRESENTATIONS.has(String(presentation))) {
-            hit(badPresentation, String(presentation), String(step.stepId ?? step.name ?? '?'));
+            hit(badPresentation, String(presentation), stepId);
         }
     });
     for (const [value, stepIds] of badPresentation) {
@@ -322,6 +417,24 @@ export function profileFindings(profile, input) {
             guide: "platform_guide('mobile')"
         });
     }
+    for (const [value, stepIds] of badTransition) {
+        findings.push({
+            code: MOBILE_RULES['MOB-029'].id,
+            severity: 'warn',
+            target: stepIds.join(', '),
+            message: `redirect.transition '${value}' tanınmıyor — ${PAGE_TRANSITIONS.join(', ')} bekleniyor. Backend doğrulayıcısı 422 döner; alanı yazmazsanız adım uygulamanın varsayılan geçişiyle açılır.`,
+            guide: "platform_guide('page') §Kural 1g-2"
+        });
+    }
+    for (const [value, stepIds] of unusedTransition) {
+        findings.push({
+            code: MOBILE_RULES['MOB-029'].id,
+            severity: 'info',
+            target: stepIds.join(', '),
+            message: `redirect.transition '${value}' modal sunumla birlikte yazılmış — modal sistemin kağıt animasyonuyla açılır, geçiş kullanılmaz (hedef bir sekme sayfasıysa da kullanılmaz: sekme değişir).`,
+            guide: "platform_guide('page') §Kural 1g-2"
+        });
+    }
     for (const [type, stepIds] of infoSteps) {
         findings.push({
             code: MOBILE_RULES['MOB-005'].id,
@@ -345,6 +458,15 @@ function walkSteps(value, visit) {
         walkSteps(step.steps, visit);
     }
 }
+/**
+ * Denetim bu yama için kayıtlı ağacı ister mi (`ProfileLintInput.savedNodes`): `style` yazımında hedefin tipi (belge
+ * CSS'i taşıyan düğüm mü — MOB-002), `heroTag` yazımında sayfanın öteki etiketleri (MOB-030). Çağıran ağacı yalnız bu
+ * durumda okur. Denetimle AYNI op listesine bakar (zarf açılır): 2026-10-10'da denetim zarfı açıp çağıran açmayınca
+ * kayıtlı `html` düğümünün belge CSS'i zarf içinde yanlış MOB-002 aldı (regresyon `test/batch-profile-lint.test.ts`).
+ */
+export function profileLintReadsSavedNodes(ops) {
+    return writesHeroTag(ops) || flattenBatchOps(ops).some(op => (op.op === 'replace_prop' || op.op === 'set_binding') && op.prop === 'style');
+}
 /** Bulguları `layoutWarnings[]` satırlarına çevirir. */
 export function findingLines(findings) {
     return findings.map(findingLine);

package/dist/knowledge/platform/mobile.js

@@ -116,7 +116,7 @@ export const mobileProfile = Object.freeze({
     },
     style: { freeStyle: false, hoverStyle: false, resolver: 'native' },
     steps: {
-        registered: new Set([...ENGINE_STEP_TYPES, 'alert', 'confirm', 'redirect', 'navigate', 'storage', 'setcookie', 'download', 'share', 'haptic', 'location', 'notification-permission', 'notification-schedule', 'notification-cancel', 'permission', 'open-settings', 'ad-show']),
+        registered: new Set([...ENGINE_STEP_TYPES, 'alert', 'confirm', 'redirect', 'navigate', 'storage', 'setcookie', 'download', 'share', 'haptic', 'location', 'notification-permission', 'notification-schedule', 'notification-cancel', 'permission', 'open-settings', 'ad-show', 'back', 'scan-code']),
         aliases: STEP_ALIASES,
         infoOnly: new Set(['download', 'setcookie'])
     },

package/dist/knowledge/platform/mobileLayoutLint.js

@@ -1,4 +1,4 @@
-import { MOBILE_DROPPABLE_TYPES, MOBILE_OUT_OF_FLOW_TYPES, MOBILE_TRANSPARENT_WRAPPER_TYPES } from '../mobileComponentCatalog.js';
+import { MOBILE_DROPPABLE_TYPES, MOBILE_OPTIONAL_VIEW_INDEX, MOBILE_OUT_OF_FLOW_TYPES, MOBILE_TRANSPARENT_WRAPPER_TYPES } from '../mobileComponentCatalog.js';
 import { PAGE_CONTAINER_ELEMENT_ID } from '../normalize.js';
 import { OVERLAY_TYPES, firstDrawn, safeAreaEdges, topSafeAreaMissing } from './mobile.js';
 import { MOBILE_RULES } from './mobileRules.js';
@@ -82,6 +82,8 @@ export function mobileLayoutFindings(input) {
             return;
         if (type === 'safe-area' && ancestors.length === 0)
             return;
+        if (isOptionalView(node, ancestors.at(-1)))
+            return;
         findings.push({ ...rule('MOB-018', label(node), `boş ${type}: ekranda boş şerit bırakır${type === 'safe-area' ? ` (edges: '${safeAreaEdges(node)}' payı kadar)` : ''}. İçeriğini ekleyin ya da silin`), severity: 'info' });
     });
     if (screenRoot)
@@ -282,6 +284,11 @@ function key(finding) {
 function rule(code, target, message) {
     return { code: MOBILE_RULES[code].id, severity: MOBILE_RULES[code].severity, target, message, guide: "platform_guide('mobile-layout')" };
 }
+/** Sabit görünümlü sahibinin bilerek boş bırakılabilen görünümü: veri yokken açılan görünüm (`MOBILE_OPTIONAL_VIEW_INDEX`). */
+function isOptionalView(node, parent) {
+    const index = MOBILE_OPTIONAL_VIEW_INDEX[String(parent?.type ?? '')];
+    return index !== undefined && asNodes(parent?.children).filter(child => child.type === 'view')[index] === node;
+}
 function asNodes(value) {
     return Array.isArray(value) ? value.filter((item) => !!item && typeof item === 'object') : [];
 }

package/dist/knowledge/platform/mobileRules.js

@@ -114,6 +114,24 @@ export const MOBILE_RULES = {
         severity: 'info',
         sourceRef: 'zeyrek-mcp guides/mobile-layout.md §Sözleşme S5/S7/S11',
         summary: 'Ölçek dışı değer: özel boşluk ya da sayısal gap 0/4/8/16/24/32 dışında, ham yarıçap, px yazı boyu'
+    },
+    'MOB-028': {
+        id: 'MOB-028',
+        severity: 'warn',
+        sourceRef: 'zeyrek-frontend/packages/ng-apps-ui-native/src/motion/resolve-motion.ts (tanınmayan alan ve okunamayan değer atlanır)',
+        summary: "Mobil motionStyle'da tanınmayan alt anahtar ya da küme/aralık dışı değer — çözücü atlar, hareket eksik çıkar"
+    },
+    'MOB-029': {
+        id: 'MOB-029',
+        severity: 'warn',
+        sourceRef: 'zeyrek-frontend/packages/ng-apps-ui-native/src/motion/resolve-transition.ts (çözücü; ayna pageTransition.ts); zeyrek-backend FlowDtoValidator (StepTransition); simülatör ölçümü 2026-10-10',
+        summary: "redirect.transition ya da properties.mobile.transition kümede değil (default | none | fade | slide | slideUp) — adımda backend 422; modal sunumda yazılan geçiş kullanılmaz (bilgi)"
+    },
+    'MOB-030': {
+        id: 'MOB-030',
+        severity: 'info',
+        sourceRef: 'zeyrek-frontend/packages/ng-apps-ui-native/src/motion/hero-tag.ts (kural; ayna heroTag.ts); zeyrek-frontend/docs/adr/0022-hero-yolu.md; simülatör ölçümü 2026-10-10',
+        summary: "Aynı sayfada aynı statik heroTag'i birden çok düğüm taşıyor — sayfa yakınlaşmanın hedefi olduğunda ilk çizilen hizalanır; kaynak sayfada sorun değildir"
     }
 };
 /**

package/dist/knowledge/platform/pageTransition.js

@@ -0,0 +1,57 @@
+/**
+ * Mobil sayfa geçişinin gateway aynası: sözlük ve çözücü. Kaynak frontend'dedir
+ * (`zeyrek-frontend/packages/ng-apps-ui-native/src/motion/` — `transition-fields.ts`, `resolve-transition.ts`;
+ * uygulama ayarının okuyucusu `src/shell/mobile-transition.ts`). Bu dosya onun kopyasıdır ve
+ * `test/page-transition-parity.test.ts` ile kilitlidir: frontend'in altın vakaları (`transition-golden.json`) aynı
+ * girdiden aynı çıktıyı ve harfi harfine aynı uyarıyı vermeli; aynı dosyanın `values` listesi backend enum'unun
+ * (`StepTransition`) kopyasına da kilitlidir. Test kırılınca test düzeltilmez, bu dosya senkronlanır.
+ *
+ * Değerler ürünün dilidir; yerel yığının adları (`slide_from_right`) burada geçmez. Kuralların ölçümü:
+ * simülatör, 2026-10-10 (`zeyrek-frontend/docs/features/mobile-runtime.md` §Sayfa geçişi).
+ */
+export const PAGE_TRANSITIONS = ['default', 'none', 'fade', 'slide', 'slideUp'];
+/** Boş değer ne değer ne uyarıdır (seçilmemiş); kümede olmayan değer `value` taşımaz. */
+export function transitionValue(raw, source) {
+    if (raw === undefined || raw === null || (typeof raw === 'string' && raw.trim() === ''))
+        return {};
+    if (typeof raw === 'string' && PAGE_TRANSITIONS.includes(raw))
+        return { value: raw };
+    return {
+        warning: `${source}: ${typeof raw === 'string' ? `'${raw}'` : JSON.stringify(raw)} geçersiz — ${PAGE_TRANSITIONS.join(', ')}, atlandı`
+    };
+}
+export const TRANSITION_SOURCES = { step: 'redirect.transition', application: 'properties.mobile.transition' };
+/**
+ * "Bu gezinmede hangi geçiş oynar." Öncelik: adım → uygulama varsayılanı → `default`; okunamayan değer uyarısıyla
+ * atlanır. Sekme hedefi ve `modal` sunum seçimi kullanmaz (sekme önce gelir). "Hareketi azalt"ta seçilmiş geçiş
+ * `none` olur, `default` sisteme kalır.
+ */
+export function resolveTransition(input, context) {
+    const step = transitionValue(input.step, TRANSITION_SOURCES.step);
+    const application = transitionValue(input.application, TRANSITION_SOURCES.application);
+    const warnings = [step.warning, application.warning].filter((warning) => warning !== undefined);
+    if (input.tabTarget)
+        return { transition: 'default', fixedBy: 'tab', warnings };
+    if (input.presentation === 'modal')
+        return { transition: 'default', fixedBy: 'modal', warnings };
+    const chosen = step.value ?? application.value ?? 'default';
+    return { transition: context.reduceMotion && chosen !== 'default' ? 'none' : chosen, warnings };
+}
+/**
+ * `properties.mobile.transition`'ın HAM değeri; alan yoksa `undefined`. Frontend'in `readMobileTransition`'ı doğrulanmış
+ * değeri verir ve bozuk olanı sessizce düşürür; gateway uyarmak için ham değeri ister — adı bu yüzden farklı.
+ */
+export function rawMobileTransition(properties) {
+    const mobile = properties?.mobile;
+    return mobile && typeof mobile === 'object' ? mobile.transition : undefined;
+}
+/**
+ * MOB-029'un uygulama ayarı ayağı. Backend `properties`'i doğrulamaz (jsonb serbest) ve cihazın okuyucusu sözlük
+ * dışı değeri SESSİZCE düşürür — uyarının verildiği tek yer burasıdır.
+ */
+export function mobileTransitionProblems(properties) {
+    const { warning } = transitionValue(rawMobileTransition(properties), TRANSITION_SOURCES.application);
+    return warning
+        ? [`${warning} — cihaz değeri okumaz, geçişini seçmemiş yönlendirme adımları sistemin geçişiyle açılır`]
+        : [];
+}

package/dist/knowledge/platform/web.js

@@ -20,7 +20,7 @@ export const webProfile = Object.freeze({
     },
     style: { freeStyle: true, hoverStyle: true, resolver: 'css' },
     steps: {
-        registered: new Set([...ENGINE_STEP_TYPES, 'alert', 'confirm', 'redirect', 'download', 'storage', 'setcookie', 'share', 'haptic', 'location', 'notification-permission', 'notification-schedule', 'notification-cancel', 'permission', 'open-settings', 'ad-show']),
+        registered: new Set([...ENGINE_STEP_TYPES, 'alert', 'confirm', 'redirect', 'download', 'storage', 'setcookie', 'share', 'haptic', 'location', 'notification-permission', 'notification-schedule', 'notification-cancel', 'permission', 'open-settings', 'ad-show', 'back', 'scan-code']),
         aliases: STEP_ALIASES,
         infoOnly: new Set()
     },