@appaflytech/zeyrek-ai-mcp 0.0.40 → 0.0.42

package/dist/platform/capture/persistent-browser.js

@@ -0,0 +1,130 @@
+import { mkdir } from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+/**
+ * Tarayıcı SABİT bir profille açılır. `chromium.launch()` her başlatmada geçici bir profil
+ * kuruyordu ve Chrome her yeni profilde Windows parolasının boş olup olmadığını sınıyor; bu
+ * sınama Security log'a başarısız oturum açma (4625, LogonType 2, 0xc000006a, chrome.exe)
+ * olarak düşüyor ve 10 dakikada 10 çekim yerel hesabı kilitliyordu (0xc0000234).
+ *
+ * Profil yalnız bu araca aittir; kullanıcının gerçek Chrome profili (Google\Chrome\User Data)
+ * hiçbir koşulda kullanılmaz. Profil dizini aynı anda tek süreç tarafından açılabildiği için
+ * (iki MCP oturumu) dolu dizinde sıradaki SABİT yuvaya geçilir — yuva sayısı sınırlıdır, her
+ * yuvanın sınaması ömründe bir kez olur.
+ */
+export const screenshotProfileRoot = () => path.join(process.env.LOCALAPPDATA ?? path.join(os.homedir(), '.cache'), 'zeyrek-mcp');
+const profileSlots = ['chrome-profile', 'chrome-profile-2', 'chrome-profile-3'];
+/** Yuvaları sırayla dener; her yuvada önce verilen tarayıcı, sonra sistem Chrome'u (`channel: 'chrome'`). */
+export function persistentContextOpener(chromium, primary) {
+    return async (deviceScaleFactor) => {
+        const root = screenshotProfileRoot();
+        let firstError;
+        for (const slot of profileSlots) {
+            const userDataDir = path.join(root, slot);
+            await mkdir(userDataDir, { recursive: true });
+            for (const launch of [primary, { channel: 'chrome' }]) {
+                try {
+                    return await chromium.launchPersistentContext(userDataDir, { headless: true, deviceScaleFactor, ...launch });
+                }
+                catch (error) {
+                    firstError ??= error;
+                }
+            }
+        }
+        throw firstError;
+    };
+}
+/**
+ * Kalıcı bağlamı `ScreenshotBrowser` gibi gösterir. Kalıcı bağlamda ikinci bağlam açılamaz;
+ * çekimler seri koştuğu için (`StudioScreenshotter` kuyruğu) her `newContext` aynı bağlamın
+ * üstünde bir oturum verir. `deviceScaleFactor` yalnız açılışta verilebildiği için değişince
+ * bağlam AYNI profille yeniden açılır.
+ */
+export class PersistentScreenshotBrowser {
+    open;
+    current;
+    constructor(open) {
+        this.open = open;
+    }
+    async newContext(options) {
+        if (this.current && this.current.deviceScaleFactor !== options.deviceScaleFactor) {
+            await this.close();
+        }
+        if (!this.current) {
+            const context = await this.open(options.deviceScaleFactor);
+            const entry = { context, deviceScaleFactor: options.deviceScaleFactor };
+            // Tarayıcı düşerse sonraki çekim yeniden açsın (eski `browser.newContext` hatası gibi).
+            context.on('close', () => {
+                if (this.current === entry)
+                    this.current = undefined;
+            });
+            this.current = entry;
+        }
+        return new PersistentContextSession(this.current.context, options);
+    }
+    async close() {
+        const expired = this.current;
+        this.current = undefined;
+        await expired?.context.close();
+    }
+}
+/**
+ * Tek çekimlik oturum. Eski taze bağlamın yalıtımı korunur: başlık ve init script'i bağlama
+ * değil sayfaya yazılır (sonraki çekime sızmaz — `impersonated-user-id` dahil), kapanışta
+ * çerezler ve gezilen kökenlerin depoları (localStorage, IndexedDB, …) diskteki profilden silinir.
+ */
+class PersistentContextSession {
+    context;
+    options;
+    initScripts = [];
+    headers;
+    pages = [];
+    constructor(context, options) {
+        this.context = context;
+        this.options = options;
+    }
+    addCookies(cookies) {
+        return this.context.addCookies(cookies);
+    }
+    async addInitScript(script) {
+        this.initScripts.push(script);
+    }
+    async setExtraHTTPHeaders(headers) {
+        this.headers = headers;
+    }
+    async newPage() {
+        const page = await this.context.newPage();
+        this.pages.push(page);
+        await page.setViewportSize(this.options.viewport);
+        await page.emulateMedia({ reducedMotion: this.options.reducedMotion ?? 'no-preference' });
+        if (this.headers)
+            await page.setExtraHTTPHeaders(this.headers);
+        for (const script of this.initScripts)
+            await page.addInitScript(script);
+        return page;
+    }
+    async close() {
+        const origins = new Set();
+        for (const page of this.pages) {
+            try {
+                const origin = new URL(page.url()).origin;
+                if (origin.startsWith('http'))
+                    origins.add(origin);
+            }
+            catch {
+                // about:blank vb.
+            }
+        }
+        const probe = this.pages.find(page => !page.isClosed());
+        if (probe && origins.size > 0) {
+            const cdp = await this.context.newCDPSession(probe).catch(() => undefined);
+            for (const origin of origins) {
+                await cdp?.send('Storage.clearDataForOrigin', { origin, storageTypes: 'all' }).catch(() => undefined);
+            }
+            await cdp?.detach().catch(() => undefined);
+        }
+        await this.context.clearCookies().catch(() => undefined);
+        for (const page of this.pages)
+            await page.close().catch(() => undefined);
+    }
+}

package/dist/platform/capture/summary.js

@@ -45,7 +45,10 @@ export function domSummaryScript(viewportHeight) {
     var field = node.querySelector('input, select, textarea');
     var chosen = node.querySelector('.selected-item');
     var holder = field || chosen;
-    var value = !owned(holder) ? '' : (field ? (field.type === 'password' ? '***' : clean(field.value)) : clean(chosen.textContent));
+    // 37 S-23: OTP'nin gizli girdisi type=text'tir ve kod özet satırında açık yazıyordu; sır sinyali
+    // tarayıcının otomatik tamamlama ipucudur (one-time-code · current-password · new-password).
+    var secret = !!field && (field.type === 'password' || /(^|\\s)(one-time-code|[\\w-]*-password)(\\s|$)/i.test(String(field.getAttribute('autocomplete') || '')));
+    var value = !owned(holder) ? '' : (field ? (secret ? '***' : clean(field.value)) : clean(chosen.textContent));
     var media = node.querySelector('img, svg, canvas, video, iframe');
     // İç içe <li> hem grubu hem alt mesajları sayıyordu: tek grup + 2 alt hata 3 görünüyordu (B-7).
     var errorItems = Array.prototype.slice.call(node.querySelectorAll('.form-validation-errors li:not(:has(li))'))

package/dist/resources/examples/flow-list-to-form.json

@@ -1,22 +1,23 @@
 {
   "_meta": {
     "synthetic": false,
-    "note": "Liste sayfasından kayıt sayfasına geçiş: satıra çift tıkla → edit (?id=), 'Yeni' butonu → create (parametresiz). Tek yeni kavram redirect adımıdır; query alanı SABİT DEĞİL İFADEDİR.",
-    "harvestedFrom": "qm projesi '[SY] Departmanlar' sayfası (table-doubleClick + button-click akışları), 2026-08-17; ayrıntı: zeyrek-mcp/docs/18-sayfa-arketipleri.md §2",
+    "note": "Liste sayfasından kayıt sayfasına geçiş: satıra çift tıkla → edit (?id=), 'Yeni' butonu → create (parametresiz). Tek yeni kavram redirect adımıdır; query alanı SABİT DEĞİL İFADEDİR. Tablo `datatable`'dır: olay `rowDoubleClick`, liste tek `mount` akışıyla dolar.",
+    "harvestedFrom": "qm projesi '[SY] Departmanlar' sayfası (table-doubleClick + button-click akışları), 2026-08-17; ayrıntı: zeyrek-mcp/docs/18-sayfa-arketipleri.md §2. 2026-10-13'te kaldırılan `table` bileşeninden `datatable`'a taşındı (olay adları ve bağ sayısı değişti; redirect adımları aynı).",
     "pairsWith": "page-form-upsert (geçilen sayfa), flow-load-table (listenin kendisini dolduran akış)"
   },
   "_rules": {
     "queryIsExpression": "redirect.args.query bir İFADEDİR, sabit string değil: template literal (`id=${…}`) ve koşullu ifade yazılabilir. Sayfalar arası parametre geçmenin yolu budur; hedef sayfa Page.queryParams.<ad> ile okur. variable_create gerekmez.",
-    "selfAndNames": "İfade içinde `self` tetikleyen komponenttir (self.selectedRow.id). Komponente adıyla da erişilir (table?.selectedRow?.id) — addaki '-' silinir. Sözlük: platform_guide('expressions') §2.",
+    "selfAndNames": "İfade içinde `self` tetikleyen komponenttir (self.selectedRow.id). Komponente adıyla da erişilir (records_table?.selectedRow?.id) — addaki '-' silinir. Sözlük: platform_guide('expressions') §2.",
     "pageIdAndPath": "redirect args'ında pageId (bağlayıcı referans) ve path (slug) birlikte verilir; sabit URL yazma — slug değişince pageId referansı ayakta kalır.",
-    "eventsAreSeparate": "Bu örnek `table` komponentini varsayar: olaylar AYRI akışlara bağlanır (mount = yükle · pagination · filter · sort · doubleClick = kaydı aç). `datatable` seçersen tek `mount` akışı yeterlidir — o komponent süzme/sıralama/sayfalamayı kendi içinde yapıp prop'ları yazdıktan sonra mount'u yeniden tetikler (Kural 1e). Hangi olayların var olduğunu component_get ile doğrulayın; olay adları `on` öneki ALMAZ (button → click).",
+    "singleMountFlow": "Tablo `datatable`'dır ve liste TEK `mount` akışıyla dolar: kullanıcı süzünce/sıralayınca/sayfa değiştirince komponent kendi filters/sortField/sortType/offset prop'larını yazar ve `mount`'u yeniden tetikler (Kural 1e) — pagination/filter/sort diye ayrı olay YOKTUR, bağlamaya çalışmak PAGE-008 ile reddedilir. Kaydı açan olay `rowDoubleClick`'tir (tek tık için `rowClick`); ikisi de olaydan ÖNCE tıklanan satırı self.selectedRow'a yazar. Hangi olayların var olduğunu component_get ile doğrulayın; olay adları `on` öneki ALMAZ (button → click).",
+    "editModeAndDoubleClick": "editMode none DIŞINDAYKEN çift tık satırı ayrıca düzenlemeye açar; liste → form geçişi için tabloyu editMode: none bırakın (ya da geçişi satır aksiyonuyla kurun: actions[].flow).",
     "newButton": "'Yeni' butonu ayrı bir komponenttir ve akışı parametresiz redirect'tir; hedef sayfa parametre görmediği için create kipine düşer."
   },
   "openRecordFlowCreateArgs": {
     "host": "page",
     "hostId": "<liste sayfası id>",
-    "name": "records_table - doubleClick",
-    "slug": "records-table-doubleclick",
+    "name": "records_table - rowDoubleClick",
+    "slug": "records-table-rowdoubleclick",
     "steps": [
       {
         "stepId": "start", "name": "start", "type": "start", "kind": "normal", "args": {},
@@ -56,10 +57,7 @@
   },
   "schemaPatchOps": [
     { "op": "set_event", "target": "records_table", "event": "mount", "eventValue": "<liste yükleme flow id>" },
-    { "op": "set_event", "target": "records_table", "event": "doubleClick", "eventValue": "<openRecord flow id>" },
-    { "op": "set_event", "target": "records_table", "event": "pagination", "eventValue": "<liste yükleme flow id>" },
-    { "op": "set_event", "target": "records_table", "event": "filter", "eventValue": "<liste yükleme flow id>" },
-    { "op": "set_event", "target": "records_table", "event": "sort", "eventValue": "<liste yükleme flow id>" },
+    { "op": "set_event", "target": "records_table", "event": "rowDoubleClick", "eventValue": "<openRecord flow id>" },
     { "op": "set_event", "target": "btn_new", "event": "click", "eventValue": "<newRecord flow id>" }
   ]
 }

package/dist/resources/examples/flow-load-table.json

@@ -1,7 +1,7 @@
 {
   "_meta": {
     "synthetic": true,
-    "note": "Komponentin mount olayına bağlanan flow tabloya veri yükler: yükleniyor bayrağı → microservice → satır eşleme + toplam kayıt. Bu dosyanın 2026-08-16 öncesi sürümü ÜÇ HATA taşıyordu ve ürettiği akışlar ne Studio'da çiziliyor ne runtime'da çalışıyordu; aşağıdaki şekil UI kodu okunarak düzeltildi (bkz. _rules).",
+    "note": "Komponentin mount olayına bağlanan flow tabloya (`datatable`) veri yükler: yükleniyor bayrağı → microservice → satır eşleme + toplam kayıt. Aynı akış süzme/sıralama/sayfa değişiminde de koşar: `datatable` kendi filters/sortField/sortType/offset prop'larını yazıp `mount`'u yeniden tetikler, bu yüzden adım parametreleri o prop'lardan okunur. Bu dosyanın 2026-08-16 öncesi sürümü ÜÇ HATA taşıyordu ve ürettiği akışlar ne Studio'da çiziliyor ne runtime'da çalışıyordu; aşağıdaki şekil UI kodu okunarak düzeltildi (bkz. _rules).",
     "harvestedFrom": "kod doğrulaması: NgApps.UI packages/ng-apps-flow + apps/studio/src/features/event-actions (2026-08-16)"
   },
   "_rules": {

package/dist/resources/examples/mobile-app-shell-drawer.json

@@ -12,6 +12,7 @@
     "catalog": "app-bar, slot ve drawer mobil kataloğun Dalga 1 bileşenleridir. component_list mobil uygulamada bunları döndürmüyorsa katalog henüz yazılmamıştır ve layout_create 422 unknown-type alır (MOB-003).",
     "verify": "Kabuğu layout'a bağlı bir sayfada page_screenshot ile doğrula (mobilde varsayılan device: 'phone').",
     "menuTarget": "app-bar.menuTarget çekmecenin elementId'sidir (nav_drawer); iç rol app_bar__menu düğmesidir — page_screenshot actions:[{ action:'click', target:'app_bar__menu' }] çekmeceyi açar.",
+    "drawerButtons": "Çekmecedeki düğmeler ŞABLONDUR: mobile_app_create her sayfa için bir düğme üretir — elementId menu_<slug> (slug'daki tire ve diğer işaretler alt çizgiye döner: ana-sayfa → menu_ana_sayfa), metin pageName. Buradaki iki düğme bu örneğin kendi pages listesine (gorevler, profil) karşılıktır; başka uygulamaya kopyalanmaz (37 S-9).",
     "drawerFlows": "Menü düğmelerine akış ayrı adımda bağlanır: flow_create (host: 'layout', adım redirect { path: '<sayfa slug'ı>' }) → layout_schema_patch set_event { target: 'menu_gorevler', event: 'click' }.",
     "drawerNode": "Çekmece mobil kataloğun `drawer` bileşenidir (kind 'component', çocuk alır): layout'a doğrudan yazılır, prop'ları katalogdakilerdir (`position`, `size`, `title`, `isDismissDisabled`); kapalı doğar, `app-bar` menüsü `isOpen: true` yazarak açar. Katalogda olmayan prop (ör. `width`, `overlay`) ya da seçenek dışı değer (düğmede `variant: 'ghost'` — geçerli olanlar `solid`/`text`/`outline`) layout_create'i 422 ile düşürür.",
     "layoutContract": "Mizanpaj sözleşmesi: üst güvenli alan tek yerde, kabukta (app-bar 'safe-area' edges:'top' içinde; sayfa ikinci pay vermez). Ekran kenarı boşluğu tek değer (16) ve tek yerde: slot'un yatay ve üst margin'i — içerik app-bar'ın 16 dp altından başlar, kabuksuz sayfadaki gibi. shell_root 'shrink' ve padding'siz — düz container olduğu için tip yazılmazsa runtime 10 dp padding verir ve app-bar kenardan kopar.",

package/dist/resources/examples/mobile-list-detail-form.json

@@ -3,7 +3,7 @@
     "synthetic": true,
     "note": "Mobil uygulamada üç sayfalık liste → detay → form akışı (G6 koşusunun girdisi): 'gorevler' mount'ta görevleri yükleyip repeater'a yazar, satıra dokunmak 'detay'ı id ile açar, 'yeni' formu kaydedip toast gösterir ve listeye döner. Yerleşim flex (blocks yok), görünüm tipli gruplarla.",
     "pairsWith": "mobile-app-shell-stack ya da mobile-app-shell-tab (kabuk), microservice-table-list (liste ucu), page-form-upsert (web'deki form ikizi)",
-    "sourceRef": "platform_guide('mobile') §Kurulum sırası, §Akış adımları; ngapps://examples/flow-list-to-form (redirect query sözleşmesi)"
+    "sourceRef": "platform_guide('mobile') §Kurulum sırası; platform_guide('mobile-steps') §Adım sözlüğü; ngapps://examples/flow-list-to-form (redirect query sözleşmesi)"
   },
   "_rules": {
     "order": "Önce kabuk ve sayfalar (mobile_app_create), sonra microservice'ler, sonra her sayfanın schemaPatchOps'u, en son akışlar (flow_create) ve bağları (set_event).",
@@ -15,7 +15,7 @@
     "verify": "page_screenshot({ applicationSlug: 'saha', pageSlug: 'yeni', actions: [{ action: 'set', target: 'in_title', value: 'Sayaç okuma' }, { action: 'submit', target: 'frm_task' }] }) → submitVia 'bridge', flowRuns ≥ 1, son kare 'gorevler'.",
     "propNames": "Prop adları mobil kataloğun adlarıdır (component_get): metin `text.content`, satırlar `repeater.rows`. Mobilde istemci tarafı form doğrulaması yok (`isRequired` prop'u yok) — zorunlu alanı kayıt akışı denetler. Kod bağı ifadeyi `ref`'te taşır: `{ type: 'code', ref: '{{ item.title }}' }` — `data`'ya yazılan ifade çizilmez (boş metin).",
     "detailFromSteps": "Detay alanları uçtan gelen veriyi SETTER adımıyla alır (`fill_detail`, `value.type: 'storage'`): `{{ Steps.… }}` kod bağı ilk çizimde okunur ve `Steps`'e yazmak düğümü yeniden okutmaz — sayfa boş kalırdı (web `page-detail-profile` ile aynı desen).",
-    "mobileBehavior": "Çekerek yenile listenin değil onu saran `scroll-view`'ın işidir (`refreshable: true` + `refresh` olayı). `redirect.presentation` push | modal | replace alır; küme dışı değer MOB-008 uyarısı ve backend 422'sidir. Sekme hedefine giden redirect'te modal `navigate`'e düşer.",
+    "mobileBehavior": "Çekerek yenile listenin değil onu saran `scroll-view`'ın işidir (`refreshable: true` + `refresh` olayı). `redirect.presentation` push | modal | replace alır; küme dışı değer MOB-008 uyarısı ve backend 422'sidir. Sekme hedefine giden redirect'te modal `navigate`'e düşer. `redirect.transition` hedefin nasıl gireceğini söyler: default | none | fade | slide | slideUp (küme dışı değeri backend 422 ile reddeder); alan yoksa uygulamanın varsayılanı (`properties.mobile.transition`) geçerlidir. `modal` sunumda ve sekme hedefinde geçiş KULLANILMAZ: 'yeni' formunun kayıttan sonraki dönüşü (`go_list`) `fade` yazar ve bu yalnız yığın kabuğunda (mobile-app-shell-stack) oynar — sekme kabuğunda (mobile-app-shell-tab) 'gorevler' bir sekme sayfasıdır, sekme değişir ve geçiş oynamaz. Liste → detay adımı (`go_detail`) `modal` olduğu için geçiş taşımaz.",
     "layoutContract": "Mizanpaj sözleşmesi platform_guide('mobile-layout'): başlık text type (fontSize değil), form direction:'column' + horizontalAlign:'stretch' (yönü yazılmamış form satırdır), aralık gap'ten. Sayfalar MOB-015…021'den sıfır bulguyla geçer."
   },
   "pages": [
@@ -85,6 +85,7 @@
                 "type": "view",
                 "kind": "component",
                 "props": {},
+                "blocks": [],
                 "children": [
                   {
                     "elementId": "row_card",
@@ -118,6 +119,7 @@
                 "type": "view",
                 "kind": "component",
                 "props": {},
+                "blocks": [],
                 "children": [
                   {
                     "elementId": "lst_tasks_bos",
@@ -130,6 +132,7 @@
                         "data": "Kayıt yok"
                       }
                     },
+                    "blocks": [],
                     "children": []
                   }
                 ]
@@ -678,7 +681,8 @@
             "args": {
               "pageId": "<gorevler sayfa id>",
               "path": "gorevler",
-              "query": ""
+              "query": "",
+              "transition": "fade"
             },
             "branches": [
               {

package/dist/resources/examples/mobile-scan-code.json

@@ -0,0 +1,285 @@
+{
+  "_meta": {
+    "synthetic": true,
+    "note": "Mobil sayfada kod tarama (scan-code adımı, kök ADR 0017): 'Barkod okut' düğmesi tam ekran tarayıcıyı açar; okunan değer barkod alanına yazılır, kullanıcı vazgeçerse ya da kamera kullanılamıyorsa error dalı tek bir uyarı gösterir. Tek yeni kavram scan-code adımıdır ve iki dalı da bağlıdır. Sayfa mizanpaj sözleşmesine uyar (MOB-015…021 bulgusuz), akış FLOW-042'den temiz geçer (test/mobile-rules.test.ts, test/mobile-layout-lint.test.ts).",
+    "pairsWith": "mobile-app-shell-stack (kabuk), mobile-form-screen (alanın içinde durduğu form düzeni), mobile-list-detail-form (okunan değerle kayıt arama / kaydetme akışı)",
+    "sourceRef": "platform_guide('mobile-steps') §Adım sözlüğü — scan-code satırı; FLOW-042; FLOW-022 (metin şablonu)"
+  },
+  "_rules": {
+    "value": "args.value izinli kod türleridir: sözlükten virgüllü DÜZ METİN — ifade, dizi ya da büyük harf değil (FLOW-042). Boş bırakılırsa bütün türler okunur; ürün barkodu için daraltmak yanlış okumayı azaltır. upc_a yoktur: UPC-A etiketi ean13 adıyla ve başında 0 ile on üç hane döner. types / formats / barcodeTypes gibi anahtarlar okunmaz.",
+    "title": "args.title tarayıcı ekranındaki yönergedir ve METİN ŞABLONUDUR (FLOW-022): düz metin olduğu gibi çizilir, çeviri için \"{{ t('urun.barkod.okut') }}\" yazılır. Boşsa ekranın kendi yönergesi çizilir.",
+    "result": "Sonuç Steps.<adım adı>.data = { value, type, source }. source 'camera' ya da 'manual' (ekrandaki 'Elle gir'); elle girişte adım birden çok tür istiyorsa type null gelir — türe göre dallanacaksan null'u da ele al.",
+    "errorBranch": "Kullanıcının tarayıcıyı kapatması bir HATADIR. error dalı bağlı değilse akışın hata akışı (errorSteps) koşar; o da yoksa akış always ile sürer ve yazma adımı Steps.scan.data.value yerine null okur. error dalında Steps.<adım adı>.error = { status, message }: cancelled (kapattı) · denied (kamera izni yok) · unavailable (derleme kamerayı taşımıyor ya da tarayıcı zaten açık) · unsupported (web uygulaması) · invalid (sözlük dışı tür). Buradaki uyarı vazgeçmeyi öteki durumlardan ayırır; error dalı koşunca always KOŞMAZ.",
+    "setter": "Okunan değer setter ile alana yazılır (element + property 'value', değer kaynağı code: Steps.scan.data.value). Değeri bir uca gönderecekseniz setter yerine microservice adımının parametresine aynı ifadeyi yazın.",
+    "placement": "Tarama düğmesi SAYFADA durur. Özel sekme çubuğunun (tabs.style: custom) bileşenindeki bir düğmeden başlatılan tarama sonuç vermez: tarayıcı açılınca çubuk sökülür ve akışı durur (bilinen açık — koddan okundu, cihazda ölçülmedi: zeyrek-frontend/docs/issues.md ARC-298).",
+    "focus": "Tarayıcı kapanınca sayfanın focus akışları koşar (başka ekrandan dönüş bir odaktır) — taramanın devamından SONRA. Odakta alanı sıfırlayan bir akış varsa okunan değeri ezer.",
+    "preview": "Önizleme (/dev, page_screenshot) kamera açmaz, telefon çerçevesinin içinde 'kod gir' penceresi çizer. page_screenshot ile sürmek için captureUnready: true ŞARTTIR — akış pencereyi beklerken 'koşuyor' sayılır ve araç onsuz 'akış hâlâ koşuyor' ile düşer: actions [click btn_tara, set __scan-value, click __scan-type-<tür> (çok türlü adımda), click __scan-confirm]; error dalı için __scan-cancel. Pencere açıkken her eylem bekleme bütçesini (15 sn) doldurur. Ölçüldü 2026-10-12: onaydan sonra in_barkod value=8690000000017, txt_kaynak 'ean13 · elle girildi'; vazgeçince runtimeErrors code 'cancelled'.",
+    "build": "Kamera izni ve modülü mağaza derlemesine kendiliğinden girer: adım production'daki bir akıştaysa derleme kamerayı taşır. Kamerayı taşımayan derleme (adım derlemeden SONRA deploy edildiyse) unavailable döner; 0.5.0'dan eski kabuk adımı hiç tanımaz. İkisinde de kullanıcıya yeni sürüm gerekir — yayın ön kontrolünün P-14 satırı söyler (platform_guide('mobile-publish'))."
+  },
+  "pages": [
+    {
+      "pageCreateArgs": {
+        "name": "Ürün sorgula",
+        "slug": "urun-sorgula"
+      },
+      "schemaPatchOps": [
+        {
+          "op": "add_component",
+          "parent": "page_container",
+          "component": {
+            "elementId": "txt_baslik",
+            "name": "txt_baslik",
+            "type": "text",
+            "kind": "component",
+            "props": {
+              "content": {
+                "type": "static",
+                "ref": null,
+                "data": "Ürün sorgula"
+              },
+              "type": {
+                "type": "static",
+                "ref": null,
+                "data": "h2"
+              }
+            },
+            "appearance": {
+              "marginType": "none",
+              "widthType": "fill"
+            },
+            "blocks": [],
+            "events": [],
+            "validations": [],
+            "stateBindings": [],
+            "children": []
+          }
+        },
+        {
+          "op": "add_component",
+          "parent": "page_container",
+          "component": {
+            "elementId": "grp_barkod",
+            "name": "grp_barkod",
+            "type": "container",
+            "kind": "component",
+            "props": {
+              "direction": {
+                "type": "static",
+                "ref": null,
+                "data": "column"
+              },
+              "horizontalAlign": {
+                "type": "static",
+                "ref": null,
+                "data": "stretch"
+              },
+              "gap": {
+                "type": "static",
+                "ref": null,
+                "data": "medium"
+              }
+            },
+            "appearance": {
+              "marginType": "none",
+              "widthType": "fill",
+              "paddingType": "none"
+            },
+            "blocks": [],
+            "events": [],
+            "validations": [],
+            "stateBindings": [],
+            "children": [
+              {
+                "elementId": "in_barkod",
+                "name": "in_barkod",
+                "type": "textinput",
+                "kind": "component",
+                "props": {
+                  "label": {
+                    "type": "static",
+                    "ref": null,
+                    "data": "Barkod"
+                  },
+                  "placeholder": {
+                    "type": "static",
+                    "ref": null,
+                    "data": "Okut ya da yaz"
+                  }
+                },
+                "appearance": {
+                  "marginType": "none",
+                  "widthType": "fill"
+                },
+                "blocks": [],
+                "events": [],
+                "validations": [],
+                "stateBindings": [],
+                "children": []
+              },
+              {
+                "elementId": "txt_kaynak",
+                "name": "txt_kaynak",
+                "type": "text",
+                "kind": "component",
+                "props": {
+                  "content": {
+                    "type": "static",
+                    "ref": null,
+                    "data": ""
+                  }
+                },
+                "appearance": {
+                  "marginType": "none",
+                  "widthType": "fill"
+                },
+                "blocks": [],
+                "events": [],
+                "validations": [],
+                "stateBindings": [],
+                "children": []
+              },
+              {
+                "elementId": "btn_tara",
+                "name": "btn_tara",
+                "type": "button",
+                "kind": "component",
+                "props": {
+                  "text": {
+                    "type": "static",
+                    "ref": null,
+                    "data": "Barkod okut"
+                  }
+                },
+                "appearance": {
+                  "marginType": "none",
+                  "widthType": "fill"
+                },
+                "blocks": [],
+                "events": [],
+                "validations": [],
+                "stateBindings": [],
+                "children": []
+              }
+            ]
+          }
+        }
+      ],
+      "scanFlowCreateArgs": {
+        "host": "page",
+        "hostId": "<urun-sorgula sayfa id>",
+        "name": "barkod okut",
+        "slug": "barkod-okut",
+        "steps": [
+          {
+            "stepId": "start",
+            "name": "start",
+            "type": "start",
+            "kind": "normal",
+            "args": {},
+            "branches": [
+              {
+                "id": "<GUID>",
+                "name": "always",
+                "nextStepId": "scan"
+              }
+            ]
+          },
+          {
+            "stepId": "scan",
+            "name": "scan",
+            "type": "scan-code",
+            "kind": "normal",
+            "args": {
+              "value": "ean13,ean8,qr",
+              "title": "Ürünün barkodunu okut"
+            },
+            "branches": [
+              {
+                "id": "<GUID>",
+                "name": "always",
+                "nextStepId": "write_code"
+              },
+              {
+                "id": "<GUID>",
+                "name": "error",
+                "nextStepId": "warn"
+              }
+            ]
+          },
+          {
+            "stepId": "write_code",
+            "name": "write_code",
+            "type": "setter",
+            "kind": "normal",
+            "args": {
+              "iteratees": [
+                {
+                  "id": "<GUID>",
+                  "type": "change",
+                  "source": "component",
+                  "element": "in_barkod",
+                  "property": "value",
+                  "mapping": {
+                    "source": "",
+                    "mappings": {}
+                  },
+                  "value": {
+                    "type": "code",
+                    "ref": "Steps.scan.data.value"
+                  }
+                },
+                {
+                  "id": "<GUID>",
+                  "type": "change",
+                  "source": "component",
+                  "element": "txt_kaynak",
+                  "property": "content",
+                  "mapping": {
+                    "source": "",
+                    "mappings": {}
+                  },
+                  "value": {
+                    "type": "code",
+                    "ref": "`${Steps.scan.data.type ?? 'tür bilinmiyor'} · ${Steps.scan.data.source === 'camera' ? 'kameradan' : 'elle girildi'}`"
+                  }
+                }
+              ]
+            },
+            "branches": [
+              {
+                "id": "<GUID>",
+                "name": "always",
+                "nextStepId": null
+              }
+            ]
+          },
+          {
+            "stepId": "warn",
+            "name": "warn",
+            "type": "alert",
+            "kind": "normal",
+            "args": {
+              "message": "{{ Steps.scan.error.status === 'cancelled' ? 'Kod okunmadı' : 'Kamera kullanılamıyor; barkodu elle yazabilirsin' }}",
+              "alertType": "info"
+            },
+            "branches": [
+              {
+                "id": "<GUID>",
+                "name": "always",
+                "nextStepId": null
+              }
+            ]
+          }
+        ]
+      },
+      "bindOps": [
+        {
+          "op": "set_event",
+          "target": "btn_tara",
+          "event": "click",
+          "eventValue": "<barkod okut akış id>"
+        }
+      ]
+    }
+  ]
+}

package/dist/resources/guides/component.md

@@ -88,7 +88,7 @@ arayüzdür**, yetkiyi backend her istekte yeniden denetler.
 
 - **Satır metası.** Table-source uçtan dönen satırda korumalı alan varsa
   `__protected: { <alanSlug>: 'masked' | 'plain' }` bulunur; `hidden` alan satırda hiç yoktur.
-  `table` · `datatable` · `detailview` · `text` (`record` + `recordField` ile) `masked` alanı
+  `datatable` · `detailview` · `text` (`record` + `recordField` ile) `masked` alanı
   kilitli maske olarak çizer; "Göster" → gerekçe → değer 30 sn görünür, sonra yeniden maskelenir.
   "Göster" yalnız erişim özeti yüklüyken çıkar: `off`'ta (basit proje hep `off`) hiç çıkmaz —
   backend her reveal'i reddeder; `shadow`'da çıkar — backend reveal'i yine denetler, yetkisiz
@@ -109,7 +109,7 @@ arayüzdür**, yetkiyi backend her istekte yeniden denetler.
   maskeli okumak yazmayı kapatmaz. Maskeli hücre düzenlemeye **boş** açılır, yazılan değer gider, boş bırakılan
   maske gitmez; hücre seçimine girmez, toplu düzenleme maskeli kolonu sunmaz. Korumalı alanı güncellemek için
   form kurmak zorunlu değildir. Eski değeri görerek düzeltmek gerekiyorsa önce "Göster" (30 sn, editöre ön
-  doldurulmaz). Bağlı olmayan tabloda ve `table` bileşeninde maskeli hücre düzenlenmez.
+  doldurulmaz). Bağlı olmayan tabloda maskeli hücre düzenlenmez.
 - **Boş değerin gönderilmemesi isteğin kuruluşuna bağlıdır.** Microservice çağrısının parametre
   bağı boş (`null`/`''`) değeri gövdeye koymaz → saklı değer korunur. Gövdeyi akış kodunda ya da
   setter göreviyle elle kuruyorsan (`{ tckn: TextInput1.value }`) `null` gider: `canWrite` yoksa
@@ -278,7 +278,7 @@ Yol joker olabilir: `series[].data` kaydı `series.1.data` prop'unu kapsar. Bağ
 
 ## Komponent seçimi
 
-"Hangi işe hangi komponent" tablosu ve `table` / `datatable` karşılaştırması:
+"Hangi işe hangi komponent" tablosu ve `datatable` kurulumu:
 `platform_guide('page')` Kural 1e ve 7e. Kaçınılacak tek şey yarım kurulumdur (süzme
 arayüzü açık, arkası statik uç). Hazır komponentlerin hiçbiri işi karşılamıyorsa `html`
 kaçış kapısıdır — yeteneklerini `platform_guide('html')` anlatır; "platform bunu yapamaz"

package/dist/resources/guides/entity.md

@@ -453,6 +453,8 @@ Companion'ı adından değil **ana entity'nin `localizationEntityId` alanından*
   UUIDv7) anahtar doğru kurulmuştur.
 
 Gateway bu iki kuralı ENT-006 (PK identity/tip uyumu) ve ENT-007 (enum şekli) olarak denetler.
+`identity: true` olup `properties.generationType` 0/1 taşımayan anahtar ENT-006 **block**'tur: platform
+create'te de update'te de 400 "Please select a valid generation type" döner (38 S-1).
 
 > **Çok dilli bir entity TEK adımda silinir.** `entity_delete` ana entity'ye uygulanır, companion
 > da onunla düşer. (Aynı gün daha erken bir ölçümdeki "önce companion'ı sil" adımı artık geçersiz;
@@ -486,6 +488,20 @@ boş bırakmak geçerli bir tercihtir** (ENT-002 warn'ı bunu hatırlatır, zoru
 > yolunda bu çeviriyi **platform** yapar; ham PUT atarken **siz yapmazsanız her güncelleme bağı
 > sessizce siler.**
 
+Var olan entity'yi `entity_patch` ile uygulamaya bağlamanın çalışan şekli — yamalanan belge
+`entity_get`'in okuma şeklidir, yol `/applications`, öğe `{ applicationId }`:
+
+```jsonc
+// Bağ listesini yazar (var olan bağlar da listede olmalı — replace tam listedir)
+{ "op": "replace", "path": "/applications", "value": [{ "applicationId": "<application id>" }] }
+// Tek bağ ekler
+{ "op": "add", "path": "/applications/-", "value": { "applicationId": "<application id>" } }
+```
+
+`/applicationIds` yolu belgede yoktur; çıplak guid öğesi platformda 500 `JsonException`, `{ id }`
+öğesi boş `applicationId` ile yanıltıcı "This record is in use. Related table: 'Applications'" verir
+(37 S-1). Gateway üçünü de yukarıdaki şekle çevirir ve `gatewayNormalized` ile söyler.
+
 ## İlişkiler (doğru şekil — 57 alanla doğrulandı)
 
 ```jsonc