@appaflytech/zeyrek-ai-mcp 0.0.36 → 0.0.40

package/dist/knowledge/normalize.js

@@ -1,7 +1,9 @@
 import { logStep } from '../observability/trace.js';
 import { PlatformApiError } from '../platform/errors.js';
 import { ensureWorkflowErrorPath } from './errorPath.js';
-import { TYPED_STYLE_COMPONENTS } from './styleResolve.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 { FUNCTIONS_NAMESPACE } from './functionGuards.js';
 const SORT_DEFAULT = { name: 'sortField', type: 'sortType', source: 'query-string' };
 const LIMIT_DEFAULT = { name: 'limit', offset: 'offset', source: 'query-string' };
@@ -270,12 +272,11 @@ export function normalizeWorkflowDefinition(definition) {
  */
 /**
  * Adım tipi sözlüğü backend'in, KOŞAN tipler barındırıcının: motor yedi tip register eder, web
- * `Runtime.svelte` altı, mobil `ScreenRuntime.tsx` beş tip ekler ve aynı sayfa kaydı ikisinde de
+ * `Runtime.svelte` altı, mobil `runtime-tasks.ts` yedi tip ekler ve aynı sayfa kaydı ikisinde de
  * koşar. Register edilmemiş bir tipe gelen akış sessizce ölür (`flow-engine.ts` `process()`
  * callback bulamazsa next/completed/stopped hiç çağrılmaz), üstelik `run()` promise'i
  * çözülmediği için `__ngAppsFlowActivity.running` sıfıra inmez. İki hâl tamamen türetilebilir
- * olduğu için lint değil NORMALİZASYON — kalanı (`confirm`/`download` mobilde yok) yalnız
- * uygulama tarafında kapanabilir, `FLOW-023` onları uyarır.
+ * olduğu için lint değil NORMALİZASYON; `FLOW-023` kalan hâlleri uyarır.
  */
 function normalizeFlowHostGaps(steps, list) {
     const fixes = [];
@@ -289,12 +290,15 @@ function normalizeFlowHostGaps(steps, list) {
         .map(step => String(step.stepId ?? ''))
         .filter(id => id.length > 0));
     for (const step of list) {
-        // navigate ile redirect'in argümanı AYNI ({ path, pageId, query, targetBlank }) ama navigate'i
-        // yalnız mobil register eder; redirect ise iki barındırıcıda da koşar (mobilde aynı navigate
-        // uygulamasına eşlenir), yani redirect kesin üstün.
-        if (step.type === 'navigate') {
-            step.type = 'redirect';
-            fixes.push(`'${label(step)}': type navigate → redirect yazıldı — argüman şekli aynı ({ path, pageId, query, targetBlank }) ama navigate'i web barındırıcısı register etmez, redirect ikisinde de koşar`);
+        // navigate ile redirect'in argümanı AYNI ({ path, pageId, query, targetBlank, presentation })
+        // ama navigate'i yalnız mobil register eder; redirect ise iki barındırıcıda da koşar (mobilde
+        // aynı navigate uygulamasına eşlenir), yani redirect kesin üstün. `presentation`
+        // (push | modal | replace) yalnız mobil barındırıcıda okunur; web yok sayar.
+        const alias = STEP_ALIASES[String(step.type ?? '')];
+        if (alias) {
+            const original = String(step.type);
+            step.type = alias;
+            fixes.push(`'${label(step)}': type ${original} → ${alias} yazıldı — argüman şekli aynı ({ path, pageId, query, targetBlank, presentation }) ama ${original}'i web barındırıcısı register etmez, ${alias} ikisinde de koşar`);
         }
         if (endStepIds.size === 0)
             continue;
@@ -371,9 +375,17 @@ const REQUIRED_COLLECTIONS = ['events', 'validations', 'stateBindings', 'childre
 // PropValueType (DesignComponentProperty.cs:421) — 'translation' listeden düşünce çeviriye bağlı
 // prop'un KENDİSİ veri sanılıp static Prop'a sarılıyordu: istek 200 dönüyor, prop bozuk kuruluyordu
 // (09-04 Y-22). Enum burada eksiksiz tutulur.
-export const PROP_VALUE_TYPES = new Set(['static', 'file', 'flow', 'widget', 'element', 'page', 'code', 'translation']);
+export const PROP_VALUE_TYPES = new Set(['static', 'file', 'flow', 'widget', 'element', 'page', 'code', 'translation', 'connectData']);
+// Prop'un TAŞIYICISI da aranır: `type` tek başına yetmez, çünkü liste öğesinin kendi `type` alanı
+// olabilir ve değeri Prop tipi adıyla çakışabilir — datatable kolonunda dosya alanı tam olarak
+// böyledir (`{ name, label, type: 'file', isFilterable }`). Yalnız `type`'a bakan sürüm o öğeyi
+// kurulu bir Prop sanıp sarmadan bırakıyordu ve platform 500 JsonException veriyordu (koşu
+// bulgusu S-2'nin gateway ayağı; Studio ayağı `staticFieldListItems` ile aynı kararı verdi).
 function isPropShaped(value) {
-    return Boolean(value) && typeof value === 'object' && !Array.isArray(value) && PROP_VALUE_TYPES.has(String(value.type));
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    const candidate = value;
+    return PROP_VALUE_TYPES.has(String(candidate.type)) && ('data' in candidate || 'ref' in candidate);
 }
 function wrapPropDictionaryValues(dictionary) {
     let wrapped = false;
@@ -622,12 +634,16 @@ 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) {
+export function normalizeStyleKeys(value, label, fixed, inlineFields) {
     if (Array.isArray(value)) {
         for (const entry of value)
             normalizeStyleKeys(entry, label, fixed);
@@ -636,7 +652,10 @@ export function normalizeStyleKeys(value, label, fixed) {
     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;
@@ -663,6 +682,44 @@ function isDerivableComponentName(name) {
     const bare = name.replace(/-/g, '');
     return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(bare) && bare !== FUNCTIONS_NAMESPACE;
 }
+/**
+ * Kabın `states.isDroppable`ı KATALOĞUN kararıdır. Gateway düğümü kurarken bu alanı
+ * yazmıyordu (`DEFAULT_STATES` hepsini `false` bırakır) ve Studio kanvası düğümü kap saymıyordu:
+ * imleç `scroll-view`un İÇİNDEYKEN bırakma planı sayfa kabına düşüyor, çizgi kabın üst kenarına
+ * çiziliyordu (ölçüldü 2026-09-21, `test/mobile app` › `Satislar`). Aynı tipi paletten ekleyen
+ * Studio katalog değerini yazdığı için tek şemada iki türlü davranan kap oluyordu.
+ *
+ * Değer uygulamanın KENDİ sözlüğünden gelir (`listComponents`; mobil uygulamada `type=mobile`
+ * satırları), yani kural platformdan bağımsızdır ve kuruluşun kendi komponentlerini de kapsar.
+ * Yalnız `true` yazılır: katalog bir tipi kap saymıyorsa düğüme dokunulmaz.
+ */
+export function normalizeDroppableStates(nodes, droppable) {
+    const fixed = [];
+    if (droppable.size === 0)
+        return fixed;
+    for (const node of asObjects(nodes)) {
+        const type = typeof node.type === 'string' ? node.type : '';
+        if (droppable.get(type) === true) {
+            // `states` normalde `normalizeComponentDefaults`tan geçmiş olur; gelmediyse burada da
+            // eksiksiz kurulur — yarım `states` platformda NullReference üretir.
+            if (!node.states || typeof node.states !== 'object' || Array.isArray(node.states)) {
+                node.states = { ...DEFAULT_STATES };
+            }
+            const states = node.states;
+            if (states.isDroppable !== true) {
+                states.isDroppable = true;
+                fixed.push(`'${String(node.elementId ?? node.name ?? type)}' (${type})`);
+            }
+        }
+        fixed.push(...normalizeDroppableStates(node.children, droppable));
+    }
+    return fixed;
+}
+export function droppableStatesNote(fixed) {
+    return fixed.length === 0
+        ? []
+        : [`states.isDroppable katalogdan yazıldı (${fixed.join(' · ')}) — kataloğun kap saydığı düğüm Studio kanvasında da kap olmalı; alanı bilerek kapatmak için resize_component/set_states kullanın`];
+}
 /**
  * Y-15 — adı eksik, null ya da boş/boşluk olan düğüm runtime'ın ifade ön sözünü bozar: `getNodeNames`
  * null adı `"null"` anahtarına çevirir, `runCode` `const null = Components["null"]` satırını üretir
@@ -741,8 +798,10 @@ 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);
+                normalizeStyleKeys(props[name], `${String(node.elementId ?? node.name ?? '?')}.${name}`, styleKeys, inlineFields(name));
             }
             if (styleKeys.length > 0)
                 missing.push(`stil anahtarları camelCase'e çevrildi: ${styleKeys.join(' · ')}`);
@@ -906,12 +965,21 @@ function normalizeReplacePropValue(op) {
         }
         return notes;
     }
+    // connectData sarmalı burada değiştirilmez: gövde duvarı (CD-005, `connectDataOpIssues`) op'u
+    // set_connect_data'ya yönlendirerek rejectedOps'a yazar; burada atmak listeyi tek hataya indirirdi.
+    if (propType === 'connectData')
+        return notes;
     // Applier her sarmalın tipini korur, ama page/file/flow/widget/element taşıyıcıları başka alanlara
     // (FlowId, RedirectPageId, dosya) yazılır ve bu op'la bağları kurulmaz. Remove+add önerilmez:
     // 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);
 }
-export function normalizeSchemaOps(ops) {
+/**
+ * `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) {
     const components = [];
     const props = [];
     const validations = [];
@@ -919,7 +987,10 @@ export function normalizeSchemaOps(ops) {
     for (const op of asObjects(ops)) {
         if (op.op === 'replace_prop') {
             if (isStylePropName(String(op.prop ?? ''))) {
-                normalizeStyleKeys(op.value, `'${String(op.target ?? '?')}.${String(op.prop)}'`, props);
+                const inline = String(op.prop) === 'style'
+                    ? inlineStyleFields(typesByElementId?.get(String(op.target ?? '')))
+                    : undefined;
+                normalizeStyleKeys(op.value, `'${String(op.target ?? '?')}.${String(op.prop)}'`, props, inline);
             }
             props.push(...normalizeReplacePropValue(op));
             continue;
@@ -959,7 +1030,7 @@ export const PAGE_CONTAINER_ELEMENT_ID = 'page_container';
  * Düzen prop'ları da kurulur (2026-08-25): `ContainerComponent` şemasının `layout` varsayılanı
  * `grid` → `flex` oldu ve Studio bırakma yolu katalogdaki `definition.defaults`'u düğümün
  * props'una YAZAR (`ScreenBuilderDroppable.svelte`); sayfa kökünü kuran öbür üreticiler de aynı seti
- * yazar (Studio `DEFAULT_CONTAINER_LAYOUT_PROPS`, studio-api `generatePageContainer`, platform
+ * yazar (Studio `DEFAULT_CONTAINER_LAYOUT_PROPS`, platform
  * `CreatePageWhenApplicationCreatedEventHandler` + `SeedData`). Renderer varsayılanı
  * BİLMEZ — `isFlexLayout` yalnız düğümün kendi prop'una bakar — bu yüzden gateway'in kurduğu
  * kapsayıcı da seti açıkça taşır; yoksa Studio'dan açılan sayfa flex, MCP'den açılan ızgara olurdu.
@@ -997,11 +1068,11 @@ export function pageContainerNode() {
  * çekilirlerse sayfa içeriğinin akışına girer ve katman olarak açılmazlar.
  */
 const ROOT_LAYER_TYPES = new Set(['modal', 'drawer']);
-export function ensurePageContainer(schema) {
+export function ensurePageContainer(schema, rootContainer = pageContainerNode) {
     const nodes = asObjects(schema);
     if (nodes.some(node => node.elementId === PAGE_CONTAINER_ELEMENT_ID))
         return { schema: nodes, fixes: [] };
-    const container = pageContainerNode();
+    const container = rootContainer();
     const layers = nodes.filter(node => ROOT_LAYER_TYPES.has(String(node.type ?? '')));
     container.children = nodes.filter(node => !ROOT_LAYER_TYPES.has(String(node.type ?? '')));
     const moved = container.children.length;
@@ -1044,7 +1115,7 @@ export function clampBlockSizes(nodes, maxSizes) {
  * başlatır (`ComponentHeightType.Fixed = 0`), yani "alan yok" = "sabit yükseklik". Studio'nun
  * kendi bırakma yolu bunu ASLA yapmaz: katalogdaki `isDefaultAutoHeight`e bakıp
  * `heightType: isDefaultAutoHeight ? 'auto' : 'fixed'` yazar
- * (`ScreenBuilderDroppable.svelte:701`, `store-converter.ts:233`). Katalogda varsayılan
+ * (`ScreenBuilderDroppable.svelte:701`, `store-converter.ts` `createDefaultSchemaNode`). Katalogda varsayılan
  * `true`'dur (`ZeyrekComponent.ts:62`); `false` diyen yalnız sekiz tip var — auth-layout, html,
  * image, layout, qrcode, table, text-editor, video.
  *
@@ -1449,10 +1520,9 @@ function collectLayout(nodes, collected) {
  */
 const MAX_REORDER_PASSES = 8;
 /**
- * Studio'da komponent tuvale bırakıldığında ızgara çakışmasını studio-api'nin sayfa kurma servisi
- * çözer: `SchemaHelper.mergeComponents` yeni komponenti kardeşlerine ekleyip `reorderComponents` →
- * `draggableElement.moveItem` ile çakışan kardeşleri aşağı iter (NgApps.UI
- * `apps/studio-api/src/domain/page/shared/page-schema.helper.ts:28`). Gateway o servisten geçmez —
+ * Studio'da komponent tuvale bırakıldığında ızgara çakışmasını Studio'nun ızgara motoru çözer:
+ * `moveItem` çakışan kardeşleri aşağı iter (`@ng-apps/screen-builder`
+ * `src/draggable/draggable.element.ts`). Gateway o motordan geçmez —
  * `page_create`/`page_update` şemayı POST/PUT ile KOMPLE yazar (`page_build` tool'u yok) — bu yüzden
  * ajanın verdiği koordinatlar olduğu gibi kayda giriyor ve aynı hücreleri isteyen komponentler
  * Studio tuvalinde üst üste biniyor. Burada aynı algoritma şemanın TAMAMINA uygulanır: en dıştaki
@@ -1830,19 +1900,18 @@ export function viewAliasNote(fixes) {
     return [`view alanlarının entity bağı id'den alias'a çevrildi (${fixes.join(', ')}): yazma tarafı viewEntityAlias ister, okuma tarafı viewEntityId döndürür — alias boş kalsa platform tüm alanları ilk tabloya düşürürdü`];
 }
 /**
- * Değişken seti tek bir kayıtta yaşar: `CreateAppVariableCommand`/`CreatePageVariableCommand`
- * yalnız `Data` alanı taşır (Studio uygulama başına ve sayfa başına TEK satır tutar —
- * `IsVariableExistForApplicationAsync` doluysa create update'e döner). Studio'nun gönderdiği şekil
- * `data`'nın **JSON string** olmasıdır: "[{\"key\":\"MyTest\",\"value\":{\"isActive\":true}}]".
- * `Data` tipi `object` olduğu için platform her gövdeyi kabul eder; alan adı tutmayan bir gövde
- * (name/type/defaultValue gibi) `Data`'yı null bırakır ve istek 200 döner ama HİÇBİR ŞEY yazılmaz
- * (17/Ç1). Okuma tarafı da aynı string'i geri verir (`AppVariablesDto.Map` → GetRawText).
+ * `storage` kayıtta isteğe bağlıdır (`docs/adr/0004-state-saklama-turu.md`). Tanınmayan tür ya da
+ * metin olmayan değer çalışma zamanında da yok sayılır (`@ng-apps/ui-native` `variableStorageKinds`);
+ * gateway onu taşımaz ki bir sonraki yazım bozuk değeri kalıcılaştırmasın.
  */
 export function parseVariableEntries(data) {
     const source = typeof data === 'string' ? safeParse(data) : data;
     return asObjects(source)
         .filter(entry => typeof entry.key === 'string' && entry.key !== '')
-        .map(entry => ({ key: String(entry.key), value: entry.value }));
+        .map(entry => {
+        const storage = STATE_STORAGE_KINDS.find(kind => kind === entry.storage);
+        return { key: String(entry.key), value: entry.value, ...(storage ? { storage } : {}) };
+    });
 }
 function safeParse(value) {
     try {
@@ -1857,17 +1926,29 @@ function safeParse(value) {
  * mevcut seti okuyup anahtar bazında birleştirir; `replace: true` verilirse bilinçli olarak ezer.
  */
 export function mergeVariableEntries(existing, incoming, replace) {
+    const stored = (entry, current) => {
+        const storage = entry.storage === undefined ? current?.storage : STATE_STORAGE_KINDS.find(kind => kind === entry.storage);
+        const value = entry.value === undefined ? (current ? current.value : null) : entry.value;
+        return { key: entry.key, value, ...(storage ? { storage } : {}) };
+    };
     if (replace)
-        return { entries: incoming, fixes: [] };
+        return { entries: incoming.map(entry => stored(entry)), fixes: [] };
     const merged = [...existing];
     const kept = [];
+    const keptStorage = [];
+    const keptValue = [];
     for (const entry of incoming) {
         const index = merged.findIndex(current => current.key === entry.key);
         if (index === -1) {
-            merged.push(entry);
+            merged.push(stored(entry));
             continue;
         }
-        merged[index] = entry;
+        const current = merged[index];
+        if (entry.storage === undefined && current?.storage)
+            keptStorage.push(`'${entry.key}' → ${current.storage}`);
+        if (entry.value === undefined)
+            keptValue.push(`'${entry.key}'`);
+        merged[index] = stored(entry, current);
     }
     for (const entry of existing) {
         if (!incoming.some(current => current.key === entry.key))
@@ -1875,9 +1956,17 @@ export function mergeVariableEntries(existing, incoming, replace) {
     }
     return {
         entries: merged,
-        fixes: kept.length > 0
-            ? [`mevcut değişkenler korundu (${kept.join(', ')}): uç seti komple değiştirir, gateway anahtar bazında birleştirdi — kasten silmek için replace: true verin`]
-            : []
+        fixes: [
+            ...(kept.length > 0
+                ? [`mevcut değişkenler korundu (${kept.join(', ')}): uç seti komple değiştirir, gateway anahtar bazında birleştirdi — kasten silmek için replace: true verin`]
+                : []),
+            ...(keptStorage.length > 0
+                ? [`saklama türü korundu (${keptStorage.join(', ')}): gelen değişken storage taşımıyordu, kayıttaki tür silinmedi — belleğe çevirmek için storage: 'memory' verin`]
+                : []),
+            ...(keptValue.length > 0
+                ? [`değer korundu (${keptValue.join(', ')}): gelen değişken value taşımıyordu, kayıttaki değer silinmedi — boşaltmak için value: null verin`]
+                : [])
+        ]
     };
 }
 export function blockSizeNote(clamped) {
@@ -1958,12 +2047,22 @@ export function nestedRepeaterNodes(nodes) {
     walk(asObjects(nodes), false);
     return found;
 }
-export function nestedRepeaterMessage(ids) {
-    return `PAGE-013 — repeater içinde repeater (istek gönderilmedi): ${ids.join(' · ')}. `
+/**
+ * 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. 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.";
+        + 'repeater tek düğümdür, dış satır başına ayrı düğüm yoktur. ';
+    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;
 }
 /**
  * `style` prop'u düz CSS STRING verilmiş düğümler. Çalışır (emotion string'i CSS metni sayar) ama
@@ -1977,7 +2076,7 @@ export function stringStyleNodes(nodes) {
         for (const node of list) {
             const props = (node.props ?? {});
             const style = props.style;
-            if (style && typeof style.data === 'string' && style.data.includes(':')) {
+            if (style && typeof style.data === 'string' && style.data.includes(':') && !DOCUMENT_STYLE_TYPES.has(String(node.type))) {
                 found.push(String(node.elementId ?? node.name ?? '?'));
             }
             walk(asObjects(node.children));
@@ -2108,6 +2207,95 @@ export function flowBindings(schema, hostEvents) {
         visitNode(node);
     return bindings;
 }
+/**
+ * TB-125 — op listesi UYGULANDIKTAN sonra şemada (ve düzey olaylarında) hâlâ referanslı olan
+ * akışlar. Simülasyon yalnız akış referansını umursar: eklenen düğüm ağacın köküne konur (konum
+ * sayıma girmez), silinen düğüm ağaçtan çıkarılır, olay op'ları olay dizisini günceller.
+ * `batch` op'u iç listesiyle düzleştirilir.
+ */
+function survivingFlowRefs(nodes, hostEvents, ops) {
+    const simulated = structuredClone(nodes);
+    const simulatedHostEvents = structuredClone(hostEvents);
+    const removeNode = (list, target) => {
+        const index = list.findIndex(node => node.elementId === target);
+        if (index >= 0) {
+            list.splice(index, 1);
+            return true;
+        }
+        for (const node of list) {
+            if (Array.isArray(node.children) && removeNode(node.children, target))
+                return true;
+        }
+        return false;
+    };
+    const eventsOf = (target) => {
+        if (target === 'page')
+            return simulatedHostEvents;
+        const node = findNodeByElementId(simulated, target);
+        if (!node)
+            return undefined;
+        if (!Array.isArray(node.events))
+            node.events = [];
+        return node.events;
+    };
+    const apply = (op) => {
+        if (op.op === 'batch') {
+            for (const inner of asObjects(op.ops))
+                apply(inner);
+            return;
+        }
+        if (op.op === 'add_component' && op.component && typeof op.component === 'object') {
+            simulated.push(structuredClone(op.component));
+            return;
+        }
+        const target = String(op.target ?? '');
+        if (target === '')
+            return;
+        if (op.op === 'remove_component') {
+            removeNode(simulated, target);
+            return;
+        }
+        if (op.op !== 'set_event' && op.op !== 'add_event' && op.op !== 'remove_event')
+            return;
+        const events = eventsOf(target);
+        if (events === undefined)
+            return;
+        const eventName = String(op.event ?? '');
+        const eventValue = typeof op.eventValue === 'string' ? op.eventValue : undefined;
+        const named = events.filter(event => String(event.name ?? '') === eventName && typeof event.value === 'string' && event.value !== '');
+        if (op.op === 'add_event') {
+            if (eventValue !== undefined)
+                events.push({ name: eventName, value: eventValue });
+            return;
+        }
+        if (op.op === 'set_event') {
+            // set_event adın BÜTÜN bağlarını tek kayda indirir.
+            for (const event of named)
+                events.splice(events.indexOf(event), 1);
+            if (eventValue !== undefined)
+                events.push({ name: eventName, value: eventValue });
+            return;
+        }
+        // Değersiz remove_event çoklu bağda platformda ambiguous-event ile düşer: hiçbir bağ kalkmaz.
+        const removed = eventValue === undefined
+            ? (named.length === 1 ? named : [])
+            : named.filter(event => event.value === eventValue);
+        for (const event of removed)
+            events.splice(events.indexOf(event), 1);
+    };
+    for (const op of ops)
+        apply(op);
+    const surviving = new Set();
+    for (const event of simulatedHostEvents) {
+        if (typeof event.value === 'string')
+            surviving.add(event.value);
+    }
+    for (const node of simulated) {
+        for (const flowId of collectFlowRefs(node))
+            surviving.add(flowId);
+    }
+    return surviving;
+}
 /**
  * Bir yamanın SİLECEĞİ akışlar. Platform referanssız kalan akışı KALICI siler; uyarı yamadan sonra
  * geldiğinde "önce yedekle" tavsiyesi uygulanamaz hâle geliyordu (09-05 koşusu: sekiz adımlı giriş
@@ -2116,26 +2304,15 @@ export function flowBindings(schema, hostEvents) {
  */
 export function orphanedFlowPlan(schema, pageEvents, ops) {
     const nodes = asObjects(schema);
-    const opList = asObjects(ops);
+    // `batch` açılır: içindeki silme de plana girer (kapı yalnız üst düzeye bakınca batch'teki
+    // `remove_component` akışı uyarısız siliyordu).
+    const opList = asObjects(ops).flatMap(op => op.op === 'batch' ? asObjects(op.ops) : [op]);
     const plan = [];
-    const survivingRefs = (skipElementId, skipEvent) => {
-        const surviving = new Set();
-        for (const event of asObjects(pageEvents)) {
-            if (typeof event.value === 'string')
-                surviving.add(event.value);
-        }
-        collectFlowRefsExcept(nodes, skipElementId, surviving);
-        if (skipEvent !== undefined) {
-            const node = findNodeByElementId(nodes, skipElementId);
-            for (const event of asObjects(node?.events)) {
-                if (String(event.name ?? '') !== skipEvent && typeof event.value === 'string')
-                    surviving.add(event.value);
-            }
-            for (const flowId of collectFlowRefs({ ...(node ?? {}), events: [] }))
-                surviving.add(flowId);
-        }
-        return surviving;
-    };
+    // TB-125 — hayatta kalan referanslar yamanın SONUCUNDAN okunur, op op özgün ağaçtan değil. Eski
+    // hesap her op'a tek başına baktığı için aynı yamada başka bir düğüme bağlanan akışı da
+    // "referanssız" sayıyor ve düğüm taşıyan her yamayı ikiye böldürüyordu (S2-35). İstek atomik
+    // olduğuna göre doğru soru tektir: yama bittiğinde bu akışa referans kalıyor mu?
+    const surviving = survivingFlowRefs(nodes, asObjects(pageEvents), opList);
     for (const op of opList) {
         const target = String(op.target ?? '');
         if (target === '')
@@ -2145,7 +2322,6 @@ export function orphanedFlowPlan(schema, pageEvents, ops) {
             if (!doomed)
                 continue;
             const losing = collectFlowRefs(doomed);
-            const surviving = survivingRefs(target);
             const orphaned = [...losing].filter(flowId => !surviving.has(flowId));
             if (orphaned.length > 0)
                 plan.push({ target, op: 'remove_component', flowIds: orphaned });
@@ -2167,10 +2343,7 @@ export function orphanedFlowPlan(schema, pageEvents, ops) {
         // oraya bağlı akış kapıdan geçip kalıcı silinirdi. Düzey olayı olmayan widget'ta applier da
         // düğüm aramasına düşer.
         if (op.op === 'remove_event' && target === 'page' && Array.isArray(pageEvents)) {
-            const hostEvents = asObjects(pageEvents);
-            const removed = removedBy(boundTo(hostEvents));
-            const surviving = new Set(hostEvents.filter(event => !removed.includes(event) && typeof event.value === 'string').map(event => String(event.value)));
-            collectFlowRefsExcept(nodes, '', surviving);
+            const removed = removedBy(boundTo(asObjects(pageEvents)));
             const flowIds = [...new Set(removed.map(event => String(event.value)))].filter(flowId => !surviving.has(flowId));
             if (flowIds.length > 0)
                 plan.push({ target, op: 'remove_event', flowIds });
@@ -2182,11 +2355,6 @@ export function orphanedFlowPlan(schema, pageEvents, ops) {
         const losing = op.op === 'set_event' ? named.filter(event => event.value !== eventValue) : removedBy(named);
         if (losing.length === 0)
             continue;
-        const surviving = survivingRefs(target, eventName);
-        for (const event of named) {
-            if (!losing.includes(event))
-                surviving.add(String(event.value));
-        }
         const flowIds = [...new Set(losing.map(event => String(event.value)))].filter(flowId => !surviving.has(flowId));
         if (flowIds.length > 0)
             plan.push({ target, op: String(op.op), flowIds });

package/dist/knowledge/outlines.js

@@ -357,3 +357,39 @@ export function functionOutline(definition) {
         view: 'outline'
     };
 }
+export function processOutline(payload) {
+    const model = (payload.definition && typeof payload.definition === 'object' ? payload.definition : payload);
+    const describeAssignee = (value) => {
+        if (!value || typeof value !== 'object' || Array.isArray(value))
+            return value ?? null;
+        const assignee = value;
+        const rule = [assignee.rule, assignee.arg].filter(part => part !== undefined && part !== null).join(':');
+        return assignee.of ? `${rule} of ${String(assignee.of)}` : rule;
+    };
+    const describeNodes = (nodes, depth) => asArray(nodes).flatMap(node => [{
+            id: node.id,
+            type: node.type,
+            depth,
+            editable: node.editable ?? 'locked',
+            description: node.description ?? null,
+            assignee: describeAssignee(node.assignee ?? node.to),
+            policy: node.policy ?? null,
+            sla: Array.isArray(node.sla) ? asArray(node.sla).map(sla => sla.duration) : node.sla ?? null,
+            on: asArray(node.on).map(handler => `${String(handler.event)} → ${String(handler.handler?.type ?? '?')}${handler.afterHandlers ? ` (${String(handler.afterHandlers)})` : ''}`)
+        }, ...describeNodes(node.nodes, depth + 1)]);
+    const nodes = describeNodes(model.nodes, 0);
+    return {
+        id: payload.id ?? null,
+        slug: model.slug ?? payload.slug,
+        name: model.name ?? payload.name,
+        version: payload.version ?? null,
+        activeVersionId: payload.activeVersionId ?? null,
+        versions: asArray(payload.versions).map(version => ({ number: version.number, state: version.state })),
+        nodeCount: nodes.length,
+        nodes,
+        edgeCount: asArray(model.edges).length,
+        on: asArray(model.on).map(handler => String(handler.event)),
+        view: 'outline',
+        hint: "Tek düğüm için process_definition_get view:'part', part:'definition.nodes[id=<düğüm>]'; değişiklik için process_definition_patch (yol /nodes[id=<düğüm>]/…)."
+    };
+}