@appaflytech/zeyrek-ai-mcp 0.0.41 → 0.0.43

package/dist/knowledge/normalize.js

@@ -3,8 +3,9 @@ import { PlatformApiError } from '../platform/errors.js';
 import { ensureWorkflowErrorPath } from './errorPath.js';
 import { DOCUMENT_STYLE_TYPES, TYPED_STYLE_COMPONENTS } from './styleResolve.js';
 import { STATE_STORAGE_KINDS, STEP_ALIASES } from './platform/profile.js';
-import { inlineStyleFields } from './componentCatalog.js';
+import { MOBILE_OPTIONAL_VIEW_INDEX, MOBILE_ROW_LIST_TYPES } from './mobileComponentCatalog.js';
 import { FUNCTIONS_NAMESPACE } from './functionGuards.js';
+import { retiredComponent } from './componentCatalog.js';
 const SORT_DEFAULT = { name: 'sortField', type: 'sortType', source: 'query-string' };
 const LIMIT_DEFAULT = { name: 'limit', offset: 'offset', source: 'query-string' };
 function asArray(value) {
@@ -634,16 +635,12 @@ export function codePropTemplateErrors(ops) {
  *
  * Seçici anahtarlara (`&__body`, `:hover`, `--token`) DOKUNULMAZ; yalnız `a-b` biçimli düz CSS
  * özellik adları camelCase'e çevrilir ve çevrim `gatewayNormalized` ile bildirilir.
- *
- * TB-129 — `inlineFields` verilirse o ÜST DÜZEY alanların altına hiç girilmez: `table.style.th`
- * gibi dallar satır içi `style` attribute'una basılır ve kebab-case zorunludur
- * (`INLINE_STYLE_FIELDS_BY_TYPE`). Çeviri orada stili öldürüyordu.
  */
 const styleKeyPattern = /^[a-z][a-z0-9]*(-[a-z0-9]+)+$/;
 export function isStylePropName(name) {
     return name === 'style' || /Style$/.test(name);
 }
-export function normalizeStyleKeys(value, label, fixed, inlineFields) {
+export function normalizeStyleKeys(value, label, fixed) {
     if (Array.isArray(value)) {
         for (const entry of value)
             normalizeStyleKeys(entry, label, fixed);
@@ -652,10 +649,7 @@ export function normalizeStyleKeys(value, label, fixed, inlineFields) {
     if (!value || typeof value !== 'object')
         return;
     const record = value;
-    const skipped = new Set(inlineFields ?? []);
     for (const key of Object.keys(record)) {
-        if (skipped.has(key))
-            continue;
         normalizeStyleKeys(record[key], label, fixed);
         if (!styleKeyPattern.test(key))
             continue;
@@ -798,10 +792,8 @@ export function normalizeComponentDefaults(nodes) {
         if (node.props && typeof node.props === 'object' && !Array.isArray(node.props)) {
             const props = node.props;
             const styleKeys = [];
-            // Satır içi stil dalları komponent TİPİNE göre atlanır; tip bilinmiyorsa eski davranış.
-            const inlineFields = (name) => name === 'style' ? inlineStyleFields(typeof node.type === 'string' ? node.type : undefined) : undefined;
             for (const name of Object.keys(props).filter(isStylePropName)) {
-                normalizeStyleKeys(props[name], `${String(node.elementId ?? node.name ?? '?')}.${name}`, styleKeys, inlineFields(name));
+                normalizeStyleKeys(props[name], `${String(node.elementId ?? node.name ?? '?')}.${name}`, styleKeys);
             }
             if (styleKeys.length > 0)
                 missing.push(`stil anahtarları camelCase'e çevrildi: ${styleKeys.join(' · ')}`);
@@ -878,6 +870,40 @@ export function assertAddComponentIds(ops) {
     if (errors.length > 0)
         throw new PlatformApiError(`PAGE-037 — ${errors.join(' · ')} (istek gönderilmedi). ${COMPONENT_BODY_RULE}`, 400);
 }
+/**
+ * PAGE-051 — frontend kataloğundan kaldırılmış tipteki düğümleri (çocuklar dahil) toplar. Kayıt
+ * defteri eşitlemesi kaldırılan bileşeni silmediği için platform o tipi kabul eder; runtime düğümü
+ * yerine geçen bileşenle çizer ve eski olaylar hiç yayılmaz (`RETIRED_COMPONENTS`). Ölçüldü
+ * 2026-10-13, lokal `test`: `add_component { type: 'table' }` + `set_event doubleClick` kuru koşuda
+ * `valid: true`. Yalnız EKLENEN gövdeye bakar: o tiple kayıtlı düğüme yazan op'lar durdurulmaz.
+ */
+export function retiredTypeNodes(nodes) {
+    const retired = [];
+    for (const node of asObjects(nodes)) {
+        const type = typeof node.type === 'string' ? node.type : undefined;
+        const record = retiredComponent(type);
+        if (record)
+            retired.push(`'${String(node.elementId ?? node.name ?? '?')}': '${type}' tipi katalogdan kaldırıldı — '${record.replacedBy}' kullanın`);
+        retired.push(...retiredTypeNodes(node.children));
+    }
+    return retired;
+}
+export const RETIRED_TYPE_RULE = "Kaldırılan tip kayıt defterinde durduğu için platform onu kabul eder, ama runtime düğümü yerine geçen bileşenle çizer ve eski olayları yaymaz: bağ kaydedilir, sessizce ölü kalır. Yerine geçenin sözlüğü component_get ile okunur; tablo için platform_guide('page') Kural 1e. O tiple KAYITLI düğüme yazan op'lar (replace_prop, move_component…) reddedilmez.";
+export function assertNoRetiredTypes(ops) {
+    const retired = asObjects(ops).flatMap(op => op.op === 'add_component' ? retiredTypeNodes([op.component]) : []);
+    if (retired.length > 0)
+        throw new PlatformApiError(`PAGE-051 — katalogdan kaldırılan tipte add_component (istek gönderilmedi): ${retired.join(' · ')}. ${RETIRED_TYPE_RULE}`, 400);
+}
+/**
+ * PAGE-051'in OLUŞTURMA ayağı (`page_create`, `layout_create`): orada ağacın tamamı yenidir.
+ * Güncelleme yolları (`page_update`, `layout_update`) bunu ÇAĞIRMAZ — tam şema yazımında yeni
+ * düğüm kayıtlıdan ayrılamaz, eski sayfa kaydedilemez olurdu.
+ */
+export function assertNoRetiredNodes(nodes) {
+    const retired = retiredTypeNodes(nodes);
+    if (retired.length > 0)
+        throw new PlatformApiError(`PAGE-051 — katalogdan kaldırılan tipte düğüm (istek gönderilmedi): ${retired.join(' · ')}. ${RETIRED_TYPE_RULE}`, 400);
+}
 /**
  * add_component micro-op'unun taşıdığı komponent ağacı da aynı ToDomain yolundan geçer.
  */
@@ -895,7 +921,8 @@ export function assertAddComponentIds(ops) {
  * `replace_prop` `expression` alanını HİÇ OKUMAZ — yalnız set_binding okur; eskiden sarmalı
  * `expression`'a taşıyorduk ve prop 200 dönerken `{type:'static', data:null}` kaydediliyordu.
  * İfade `ref`'tedir (PG-117); ref yoksa string `data`'dan alınır, ikisi de yoksa çağrı durur.
- * Platform code prop'unda yalnız `Ref`'i saklar (`Prop` kurucusu), `data` kalıcı değildir; ama
+ * Platform code prop'unda ifadeyi `Ref`'te saklar; `data` tasarım yedeğidir — yalnız ilkel değerken ve
+ * ifadeyi yinelemiyorsa kalır (2026-10-09, `DesignComponentProperty.SetRef`; öncesinde hiç saklanmıyordu).
  * `CreateProp` veri tipini `Data`'dan seçtiği için nesne/dizi `data` 500 verir — ref ile değiştirilir.
  * Aynı sebeple `value`'suz `expression` code sarmalına çevrilir, `value`'nun yanındaki `expression`
  * silinir. `translation` sarmalı da aynı gerekçeyle olduğu gibi gider (G-04): applier
@@ -947,7 +974,7 @@ function normalizeReplacePropValue(op) {
             notes.push(`${label}: code sarmalında ref yoktu, data'daki ifade ref'e kopyalandı — runtime ifadeyi ref'ten okur`);
         }
         if (code.data !== null && typeof code.data === 'object') {
-            notes.push(`${label}: code sarmalının nesne/dizi data'sı ref ile değiştirildi — platform code prop'unda data'yı saklamaz, nesne data'yı Dictionary<string, Prop> diye çözüp 500 verir`);
+            notes.push(`${label}: code sarmalının nesne/dizi data'sı ref ile değiştirildi — platform code prop'unda yalnız ilkel data'yı (tasarım yedeği) saklar, nesne data'yı Dictionary<string, Prop> diye çözüp 500 verir`);
             code.data = code.ref;
         }
         if (code.data === undefined)
@@ -974,12 +1001,7 @@ function normalizeReplacePropValue(op) {
     // düğümü yeniden kurmak ona yazan setter iteratee'lerinin element'ini siler (G-04, FLOW-018).
     throw new PlatformApiError(`${label}: '${propType}' tipli Prop replace_prop ile kurulmaz — bu op static, code ve translation sarmalını taşır. Komponenti silip yeniden EKLEMEYİN: ona yazan setter adımlarının hedefi silinir (FLOW-018). Akış bağı için set_event, diğer tipler için page_update(schema) ile tam şema yazın.`, 400);
 }
-/**
- * `typesByElementId` — TB-129: `replace_prop` op'u yalnız elementId taşır, stil çevirisinin
- * komponent tipine bakabilmesi için haritayı çağıran (okuduğu şemadan) verir. Verilmezse çeviri
- * tip ayrımı yapmaz; bu, harita okunamadığında yazmayı engellememek için bilinçli düşüştür.
- */
-export function normalizeSchemaOps(ops, typesByElementId) {
+export function normalizeSchemaOps(ops) {
     const components = [];
     const props = [];
     const validations = [];
@@ -987,10 +1009,7 @@ export function normalizeSchemaOps(ops, typesByElementId) {
     for (const op of asObjects(ops)) {
         if (op.op === 'replace_prop') {
             if (isStylePropName(String(op.prop ?? ''))) {
-                const inline = String(op.prop) === 'style'
-                    ? inlineStyleFields(typesByElementId?.get(String(op.target ?? '')))
-                    : undefined;
-                normalizeStyleKeys(op.value, `'${String(op.target ?? '?')}.${String(op.prop)}'`, props, inline);
+                normalizeStyleKeys(op.value, `'${String(op.target ?? '?')}.${String(op.prop)}'`, props);
             }
             props.push(...normalizeReplacePropValue(op));
             continue;
@@ -1342,7 +1361,7 @@ export function spacingLayerWarnings(nodes, unusedCode, numberCode) {
                 const hint = node.type === 'slot'
                     ? "Slot'un sayfa içeriğinden uzaklığı dış boşluğudur: appearance.marginType:'custom' + marginValue (sayı) yaz — slot'un zemini/çerçevesi olmadığı için görsel sonuç iç boşlukla aynıdır."
                     : "İç boşluk yalnız droppable kaplarda ve tipli stil modelindeki yapraklarda (box · text · container · statcard · icon · form) çizilir; kenardan uzaklık için marginType/marginValue, iç boşluk için sarmalayıcı container kullan.";
-                warnings.push(`${unusedCode}: '${label}' (${String(node.type ?? '?')}) düğümüne custom iç boşluk yazıldı ama bu düğümde iç boşluk HİÇBİR kutuya çizilmez — platform 200 döner, ekran değişmez. ${hint}`);
+                warnings.push(`${unusedCode}: '${label}' (${String(node.type ?? '?')}) düğümü custom iç boşluk taşıyor ama bu düğümde iç boşluk HİÇBİR kutuya çizilmez — platform 200 döner, ekran değişmez. ${hint}`);
             }
             walk(asObjects(node.children));
         }
@@ -2036,51 +2055,60 @@ export function splitJunctionFields(definition, isJunction) {
     return { base: { ...definition, fields: fields.filter(field => !isJunction(field)) }, deferred };
 }
 /**
- * `remove_component` şemadan bir dalı çıkarır ama etkisi dalla sınırlı DEĞİLDİR: sayfa
- * kaydedilirken artık hiçbir komponent olayının, prop'unun ya da sayfa olayının referans vermediği
- * akışlar platformca KALICI olarak silinir (`PageService.UpdateAsync` → `flowRepository
- * .DeleteRangeAsync`). Micro-op hattının "yalnız hedefe dokunur" garantisinin tek istisnası budur;
- * çoğu zaman istenen davranıştır, istenmediğinde ise uyarı tek erken sinyaldir.
- */
-/**
- * Repeater içinde repeater arar. ÖLÇÜLDÜ (2026-08-19, anket-admin probe sayfası): iç repeater
- * OKUMADA çalışır (dış satır başına doğru sayıda iç satır çizilir) ama YAZMA ölüdür —
- * iç girdiyi değiştirince dış satırın alanı değişmez ve iç repeater'ın `_repeaterValues`'ü null
- * kalır. Sebep yapısal: şemada iç repeater TEK düğümdür, dış satır başına ayrı düğüm yoktur;
- * `_repeaterValues` anahtarı iç satır id'sine göredir ve dış satırlar arasında çakışır.
- * Üstelik tek bir düzenlemeden sonra DOM bozuluyor (ölçümde girdi sayısı 3 → 19) ve ekranda
- * sürekli "Expression error: Cannot read properties of null" toast'ı çıkıyor.
+ * Satır listesinin alt ağacındaki satır listesini arar (`MOBILE_ROW_LIST_TYPES`; web'de yalnız `repeater` vardır).
+ * ÖLÇÜLDÜ (2026-08-19, anket-admin probe sayfası, repeater içinde repeater): iç liste OKUMADA çalışır (dış satır
+ * başına doğru sayıda iç satır çizilir) ama YAZMA ölüdür — iç girdiyi değiştirince dış satırın alanı değişmez ve iç
+ * listenin `_repeaterValues`'ü null kalır. Sebep yapısal: şemada iç liste TEK düğümdür, dış satır başına ayrı düğüm
+ * yoktur; `_repeaterValues` anahtarı iç satır id'sine göredir ve dış satırlar arasında çakışır. Üstelik tek bir
+ * düzenlemeden sonra DOM bozuluyor (ölçümde girdi sayısı 3 → 19) ve ekranda sürekli "Expression error: Cannot read
+ * properties of null" toast'ı çıkıyor. Öteki iki tip aynı satır kapsamını kullanır (frontend `ROW_LIST_TYPES`), bu
+ * yüzden kural üçünün çaprazına bakar (2026-10-09, plans/mobil-animasyon-sistemi faz 04 F-3).
+ * Satır kapsamı satır ŞABLONUDUR: MOBİL listenin boş görünümü (`MOBILE_OPTIONAL_VIEW_INDEX`) sayfa kapsamındadır
+ * (frontend `row-list-type.ts` `rowTemplateNodes`) — içindeki liste satır başına çoğalmaz ve iç içe sayılmaz; o alt ağaç
+ * listenin kendi dış kapsamını taşır. Web `repeater`ının görünümü yoktur (şemasında `views` yok, çizeri bütün
+ * çocukları satır başına çizer): orada `view` sıradan bir çocuktur, istisna uygulanmaz.
  * Doğru desen: iç listeyi tek bir `textarea`'da satır başına bir öğe olarak topla.
  */
-export function nestedRepeaterNodes(nodes) {
+export function nestedRepeaterNodes(nodes, platform = 'web') {
     const found = [];
-    const walk = (list, insideRepeater) => {
+    const walk = (list, insideType) => {
         for (const node of list) {
-            const isRepeater = node.type === 'repeater';
-            if (isRepeater && insideRepeater)
-                found.push(String(node.elementId ?? node.name ?? '?'));
-            walk(asObjects(node.children), insideRepeater || isRepeater);
+            const type = String(node.type ?? '');
+            const isRowList = MOBILE_ROW_LIST_TYPES.includes(type);
+            if (isRowList && insideType !== undefined)
+                found.push({ id: String(node.elementId ?? node.name ?? '?'), type, insideType });
+            const children = asObjects(node.children);
+            const emptyView = isRowList && platform === 'mobile' ? children.filter(child => child.type === 'view')[MOBILE_OPTIONAL_VIEW_INDEX[type] ?? -1] : undefined;
+            for (const child of children)
+                walk([child], isRowList && child !== emptyView ? type : insideType);
         }
     };
-    walk(asObjects(nodes), false);
+    walk(asObjects(nodes), undefined);
     return found;
 }
 /**
- * Mobil profilde gruplu listenin (gün/kategori başlığı altında satırlar) hazır bileşeni vardır:
- * `grouped-list` (ui-native, ADR 0007). Web'de karşılığı yok — web mesajı textarea tarifinde kalır.
+ * Mesaj hangi tipin hangi tipin içinde durduğunu söyler. Ölçüm cümlesi ve gruplu liste önerisi yalnız ölçülen ve
+ * önerinin karşıladığı şekilde kalır (`repeater` içinde `repeater`): mobil profilde gruplu listenin (gün/kategori
+ * başlığı altında satırlar) hazır bileşeni vardır, `grouped-list` (ui-native, ADR 0007); web'de karşılığı yok —
+ * web mesajı textarea tarifinde kalır.
  */
-export function nestedRepeaterMessage(ids, platform = 'web') {
-    const measured = `PAGE-013 — repeater içinde repeater (istek gönderilmedi): ${ids.join(' · ')}. `
-        + 'Ölçüldü (2026-08-19): iç repeater OKUMADA çalışır ama girilen değer dış satıra GERİ YAZILMAZ '
-        + '(_repeaterValues null kalır) ve tek düzenlemeden sonra DOM bozulur. Sebep yapısal: şemada iç '
-        + 'repeater tek düğümdür, dış satır başına ayrı düğüm yoktur. ';
+export function nestedRepeaterMessage(found, platform = 'web') {
+    const pairs = [...new Set(found.map(entry => `${entry.insideType} içinde ${entry.type}`))];
+    const located = pairs.map(pair => `${pair}: ${found.filter(entry => `${entry.insideType} içinde ${entry.type}` === pair).map(entry => entry.id).join(' · ')}`);
+    const repeaterInRepeater = found.some(entry => entry.type === 'repeater' && entry.insideType === 'repeater');
     const textarea = "Satır içi listeyi tek bir textarea ile topla (satır başına bir öğe) ve kaydederken split('\n') ile böl — platform_guide('page') Kural 1g.";
-    if (platform !== 'mobile')
-        return measured + textarea;
-    return measured
-        + 'Başlıklar altında gruplanmış liste (güne/kategoriye göre) için mobilde tek `grouped-list` kur: düz `rows` + '
-        + '`groupBy` alan yolu; çocuk 0 bölüm başlığı (`{{ Section.title }}`), çocuk 1 öğe şablonu (`Row`, `{{ item.<alan> }}`) — '
-        + "platform_guide('mobile') §Güne göre görev listesi. Satır içinde düzenlenen alt liste gerekiyorsa: " + textarea;
+    return `PAGE-013 — ${located.join('; ')} (istek gönderilmedi). `
+        + 'Satır kapsamı tek seviyedir: şemada iç liste tek düğümdür, dış satır başına ayrı düğüm yoktur. '
+        + (repeaterInRepeater
+            ? 'Ölçüldü (2026-08-19): iç repeater OKUMADA çalışır ama girilen değer dış satıra GERİ YAZILMAZ '
+                + '(_repeaterValues null kalır) ve tek düzenlemeden sonra DOM bozulur. '
+            : 'İç listeyi dış listenin şablonundan çıkarın (kardeşi yapın ya da ayrı sayfaya/modala taşıyın). ')
+        + (repeaterInRepeater && platform === 'mobile'
+            ? 'Başlıklar altında gruplanmış liste (güne/kategoriye göre) için mobilde tek `grouped-list` kur: düz `rows` + '
+                + '`groupBy` alan yolu; çocuk 0 bölüm başlığı (`{{ Section.title }}`), çocuk 1 öğe şablonu (`Row`, `{{ item.<alan> }}`) — '
+                + "platform_guide('mobile') §Güne göre görev listesi. Satır içinde düzenlenen alt liste gerekiyorsa: "
+            : '')
+        + textarea;
 }
 /**
  * `style` prop'u düz CSS STRING verilmiş düğümler. Çalışır (emotion string'i CSS metni sayar) ama

package/dist/knowledge/pageDiscover.js

@@ -37,7 +37,7 @@ 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 }) }
+        { op: 'add_component', parent: 'page_container', component: node('records_table', 'datatable', {}, false, { h: 40, w: 12, x: 0, y: 4 }) }
     ];
 }
 function pageArgs(screenName, base, options, caveats) {
@@ -120,7 +120,7 @@ export function discoverPage(snapshot, screenRef, options = {}) {
         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");
+        caveats.push("records_table props boş — kolonları ve veri kaynağını component_get('datatable') + flow-load-table örneğine göre verin (tek mount akışı: süzme/sıralama/sayfa değişimi mount'u yeniden tetikler); set_event op'larındaki '<… flow id>' yer tutucuları flow_create sonrası gerçek id ile değiştirilir");
         return {
             ...head,
             archetype: LIST_ARCHETYPE,

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())
+    };
+}