@appaflytech/zeyrek-ai-mcp 0.0.45 → 0.0.46

package/dist/knowledge/mobileComponentCatalog.js

@@ -319,7 +319,7 @@ export const mobileComponentKnowledge = {
             '`imageFit` RN `resizeMode`a çevrilir: cover→cover, contain→contain, fill→stretch, none→center.',
             '`surfaceStyle` (mobile özgü) kartın ÇERÇEVESİDİR: köşe, kenar, zemin, gölge sınıf tabanını ezer (`radius: "28px 28px 0 0"` üstü yuvarlak kart). Kabuk grubu ikinci kez çizmez.',
             "`image` `image` bileşeniyle aynı çözümden geçer: kayıttaki FILE alanını nesne olarak verin (`{{ item.foto }}`) ya da `.absolute_path` yazın; `.value` dosya kimliğidir (GUID), görsel çizilmez (MOB-011).",
-            'Kartın TAMAMI dokunulabilir: gövdeye dokunmak `click` yayar. Kartın düğmesi (`buttonText`) web `Card.svelte` sırasıyla önce kendi `buttonClick`ini, ardından kartın `click`ini yayar (2026-09-27, f-02 H10) — düğmeye ayrı akış bağlamak için `buttonClick`i kullanın; `click` akışı iki dokunuşta da koşar. Liste satırına dokunmak repeater şablonundaki kartın `click`idir. Kart çocuk ALMAZ — satırın alanlarını `title`/`description` kod bağıyla (`{ type: \'code\', ref: \'{{ item.alan }}\' }`) verin.'
+            'Kartın gövdesi yalnız `click`e akış BAĞLIYKEN dokunulabilirdir ve dokunuş `click` yayar; bağlı değilse gövde düz kutudur, dokunuş üstteki basılabilir satıra (`itemPressable` repeater → `itemPress`) geçer (2026-10-20, ARC-338: bağsız kart da düğmeydi, satırın `itemPress`i hiç koşmuyordu). Kartın düğmesi (`buttonText`) web `Card.svelte` sırasıyla önce kendi `buttonClick`ini, ardından kartın `click`ini yayar (2026-09-27, f-02 H10) — düğmeye ayrı akış bağlamak için `buttonClick`i kullanın; `click` akışı iki dokunuşta da koşar. Liste satırına dokunmak repeater\'ın `itemPress` olayıdır (`itemPressable: true`); satırdaki karta ayrıca `click` bağlanırsa dokunuşu kart alır ve satırın `itemPress`i koşmaz. Kart çocuk ALMAZ — satırın alanlarını `title`/`description` kod bağıyla (`{ type: \'code\', ref: \'{{ item.alan }}\' }`) verin.'
         ]
     },
     emptystate: {

package/dist/knowledge/platform/lint.js

@@ -378,10 +378,18 @@ export function profileFindings(profile, input) {
     const badPresentation = new Map();
     const badTransition = new Map();
     const unusedTransition = new Map();
+    const statusNetwork = [];
     walkSteps(input.steps, step => {
         const type = String(step.type ?? '');
         if (profile.steps.infoOnly.has(type))
             hit(infoSteps, type, String(step.stepId ?? step.name ?? '?'));
+        // MOB-033 (bilgi): ağ hatasını 503 ile ayıran ifade. Akış hangi adımın argümanında olursa olsun ifadeyi metin olarak
+        // taşır (koşul, alert şablonu, setter), bu yüzden argümanların tamamı taranır. Kural metinseldir: uygulamanın veri
+        // önbelleği açık mı, lint bilmez — mesaj koşulu söyler. Adım `error.network`'ü de okuyorsa (`== 503 && !…network`,
+        // `network || == 503`) sunucu arızasını ağdan ayıran doğru desendir: not düşmez.
+        const argsText = JSON.stringify(step.args ?? null);
+        if (STATUS_503.test(argsText) && !READS_NETWORK.test(argsText))
+            statusNetwork.push(String(step.stepId ?? step.name ?? '?'));
         // MOB-008: sunum biçimi yalnız `redirect`te anlamlı ve kümesi kapalı.
         // Alan YOKSA bulgu yok — varsayılan `push` ve yazımların çoğu onu yazmaz.
         if (type !== 'redirect')
@@ -435,6 +443,15 @@ export function profileFindings(profile, input) {
             guide: "platform_guide('page') §Kural 1g-2"
         });
     }
+    if (statusNetwork.length > 0) {
+        findings.push({
+            code: MOBILE_RULES['MOB-033'].id,
+            severity: 'info',
+            target: statusNetwork.join(', '),
+            message: "akış ağ hatasını error.status 503 karşılaştırmasıyla ayırıyor — 503'ü sunucu da döner (bakım, aşırı yük). Uygulamanın veri önbelleği açıksa (properties.mobile.offline.data: true) yanıt alınamayan istekte Steps.<ad>.error.network true olur ve status yine 503 kalır: 'bağlantı yok' demek için error.network'e bakın. Önbellek kapalıyken network alanı yazılmaz, 503 karşılaştırması tek yoldur.",
+            guide: "platform_guide('page') §Kural 1g-4"
+        });
+    }
     for (const [type, stepIds] of infoSteps) {
         findings.push({
             code: MOBILE_RULES['MOB-005'].id,
@@ -447,6 +464,12 @@ export function profileFindings(profile, input) {
     }
     return findings;
 }
+/**
+ * `error.status == 503` ya da `503 === … error.status` (`!=`, `?.`, tırnaklı `'503'` dahil — argümanlar JSON metnidir,
+ * çift tırnak `\"` olur); `5030` gibi uzun sayı eşleşmez.
+ */
+const STATUS_503 = /error\??\.status\s*[!=]==?\s*\\?['"]?503(?!\d)|(?<![\w.])503\\?['"]?\s*[!=]==?\s*[\w$.?]*error\??\.status/;
+const READS_NETWORK = /error\??\.network/;
 function walkSteps(value, visit) {
     if (!Array.isArray(value))
         return;

package/dist/knowledge/platform/mobileOffline.js

@@ -0,0 +1,45 @@
+export const MOBILE_OFFLINE_MAX_AGE_DAYS = [1, 7, 30];
+export const MOBILE_OFFLINE_DEFAULTS = { screens: true, data: false, maxAgeDays: 7, banner: true };
+const FIELDS = Object.keys(MOBILE_OFFLINE_DEFAULTS);
+/** `properties.mobile.offline`'ın HAM değeri; alan yoksa `undefined`. */
+export function rawMobileOffline(properties) {
+    const mobile = properties?.mobile;
+    return mobile && typeof mobile === 'object' ? mobile.offline : undefined;
+}
+/** Cihazın okuduğu ayar: küme dışı ya da yanlış tipli değer varsayılana düşer. */
+export function readMobileOffline(properties) {
+    const raw = rawMobileOffline(properties);
+    const offline = raw && typeof raw === 'object' ? raw : {};
+    return {
+        screens: typeof offline.screens === 'boolean' ? offline.screens : MOBILE_OFFLINE_DEFAULTS.screens,
+        data: typeof offline.data === 'boolean' ? offline.data : MOBILE_OFFLINE_DEFAULTS.data,
+        maxAgeDays: MOBILE_OFFLINE_MAX_AGE_DAYS.includes(offline.maxAgeDays) ? offline.maxAgeDays : MOBILE_OFFLINE_DEFAULTS.maxAgeDays,
+        banner: typeof offline.banner === 'boolean' ? offline.banner : MOBILE_OFFLINE_DEFAULTS.banner
+    };
+}
+/**
+ * MOB-033'in ayar ayağı. Backend `properties`'i doğrulamaz (jsonb serbest) ve cihazın okuyucusu okuyamadığı değeri
+ * SESSİZCE varsayılana düşürür — uyarının söylendiği tek yer burasıdır. Yazım yine platforma gider.
+ */
+export function mobileOfflineProblems(properties) {
+    const raw = rawMobileOffline(properties);
+    if (raw === undefined || raw === null)
+        return [];
+    if (typeof raw !== 'object' || Array.isArray(raw)) {
+        return [`properties.mobile.offline nesne olmalı (gelen: ${JSON.stringify(raw)}) — cihaz okumaz, varsayılanlar geçerli (screens: true, data: false, maxAgeDays: 7, banner: true)`];
+    }
+    const offline = raw;
+    const problems = [];
+    for (const field of ['screens', 'data', 'banner']) {
+        if (offline[field] !== undefined && typeof offline[field] !== 'boolean') {
+            problems.push(`properties.mobile.offline.${field} boolean olmalı (gelen: ${JSON.stringify(offline[field])}) — yok sayılır, varsayılan (${MOBILE_OFFLINE_DEFAULTS[field]}) geçerli`);
+        }
+    }
+    if (offline.maxAgeDays !== undefined && !MOBILE_OFFLINE_MAX_AGE_DAYS.includes(offline.maxAgeDays)) {
+        problems.push(`properties.mobile.offline.maxAgeDays ${JSON.stringify(offline.maxAgeDays)} kümede değil (${MOBILE_OFFLINE_MAX_AGE_DAYS.join(' | ')}) — sayı olarak yazılır; yok sayılır, ${MOBILE_OFFLINE_DEFAULTS.maxAgeDays} gün geçerli`);
+    }
+    for (const key of Object.keys(offline).filter(key => !FIELDS.includes(key))) {
+        problems.push(`properties.mobile.offline içinde tanınmayan anahtar '${key}' — cihaz okumaz (${FIELDS.join(' | ')})`);
+    }
+    return problems;
+}

package/dist/knowledge/platform/mobileRules.js

@@ -132,6 +132,12 @@ export const MOBILE_RULES = {
         severity: 'info',
         sourceRef: 'zeyrek-frontend/packages/ng-apps-ui-native/src/motion/hero-tag.ts (kural; ayna heroTag.ts); zeyrek-frontend/docs/adr/0022-hero-yolu.md; simülatör ölçümü 2026-10-10',
         summary: "Aynı sayfada aynı statik heroTag'i birden çok düğüm taşıyor — sayfa yakınlaşmanın hedefi olduğunda ilk çizilen hizalanır; kaynak sayfada sorun değildir"
+    },
+    'MOB-033': {
+        id: 'MOB-033',
+        severity: 'warn',
+        sourceRef: 'docs/adr/0023-mobil-cevrimdisi-yerel-kopya-ve-uygulama-paketi.md K13, K8; zeyrek-frontend/packages/ng-apps-ui-native/src/shell/mobile-offline.ts (okuyucu; ayna mobileOffline.ts); ng-apps-flow tasks/microservice/microservice.ts (error.network yalnız veri önbelleği açıkken)',
+        summary: "properties.mobile.offline okunamıyor (nesne değil, boolean olmayan screens/data/banner, 1 | 7 | 30 dışı maxAgeDays, tanınmayan anahtar) — cihaz varsayılana düşer; akış ağ hatasını error.status 503 ile ayırıyor (bilgi: error.network)"
     }
 };
 /**

package/dist/knowledge/rules.js

@@ -155,11 +155,13 @@ export function readsBeforeGuard(source, root) {
  * KENDİSİ tanır (ADR 0004, ZM-07/g-02): bağlıysa hata anında `always` hiç koşmaz, sürer
  * (microservice.ts:182 `hasBranch`) — eski motor tanımadığı dalı hiç aramadığı için bu ekleme
  * geriye dönük zararsızdır. `validation` tüm kurallar geçince 'success', biri düşünce 'error' dalına,
- * ardından her durumda 'always'e gider (validation.ts; kök ADR 0014, g-18).
+ * ardından her durumda 'always'e gider (validation.ts; kök ADR 0014, g-18). microservice'in 'queued' dalı mobilde,
+ * `offlineWritable` serviste ağ hatası kuyruğa alınınca koşar (kök ADR 0022, plans/mobil-cevrimdisi-calisma g-02);
+ * mobil/bildirim koşulunu tanım taşımadığı için akış aracı FLOW-043 ile platformdan okur.
  */
-const flowBranchNames = {
+export const flowBranchNames = {
     start: ['always'],
-    microservice: ['always', 'success', 'error'],
+    microservice: ['always', 'success', 'error', 'queued'],
     validation: ['always', 'success', 'error'],
     confirm: ['yes', 'no', 'always'],
     function: ['always'],
@@ -654,6 +656,26 @@ export const policyRules = [
                 }];
         }
     },
+    {
+        id: 'MS-025',
+        module: 'microservice',
+        appliesTo: ['create', 'update'],
+        sourceRef: "Kök ADR 0022 (b-03, g-02): 'offlineWritable' kuyruktan gelen yazmayı kabul eder; okuyan uç hiç kuyruğa girmez — akış okumayı veri önbelleğinden alır (faz 04). Okuyan: tablo 'get'/'count' (MicroserviceTableOperation'da 'list' yoktur) ve görünüm kaynağı (ViewMicroserviceExecutor yalnız arar). Bildirim orada anlamsızdır ve okunan ucu 'yazan' gibi gösterir",
+        check: definition => {
+            const parameters = (definition.sourceParameters ?? {});
+            const source = String(definition.source ?? '').toLowerCase();
+            const operation = String(parameters.operation ?? '').toLowerCase();
+            const reads = source === 'view' || (source === 'table' && ['get', 'count'].includes(operation));
+            if (definition.offlineWritable !== true || !reads)
+                return [];
+            return [{
+                    ruleId: 'MS-025',
+                    severity: 'warn',
+                    message: `offlineWritable bir okuma ucuna verilmiş (${source === 'view' ? "kaynak: 'view'" : `operation: '${operation}'`}): kuyruk yalnız yazmaları tutar, okuma çevrimdışıyken veri önbelleğinden gelir (uygulamanın 'mobile.offline.data' ayarı). Bildirimi kaldırın; yazan uçta (create/update/upsert/delete ya da yazan iş akışı) kalsın.`,
+                    guide: 'ngapps://guides/page'
+                }];
+        }
+    },
     {
         id: 'QRY-006',
         module: 'query',

package/dist/resources/examples/mobile-offline-list.json

@@ -0,0 +1,357 @@
+{
+  "_meta": {
+    "synthetic": true,
+    "note": "Mobil uygulamada çevrimdışı okunan liste (kök ADR 0023): uygulamanın veri önbelleği açıktır; 'siparisler' mount'ta GET servisini çağırır, satırları repeater'a ve 'son güncelleme' satırını adımın önbellek işaretinden (Steps.<ad>.cache.at) yazar. Ağ varken satır gizli kalır; ağ yokken son başarılı yanıt saklandığı anla birlikte çizilir. Kayıt da yoksa hata dalı 'bağlantı yok'u Steps.<ad>.error.network'ten ayırır. Sayfa mizanpaj sözleşmesine uyar, akış mobil profilden bulgusuz geçer (test/mobile-rules.test.ts, test/mobile-layout-lint.test.ts).",
+    "pairsWith": "mobile-list-detail-form (aynı liste deseninin satıra dokunma ve form ayağı), mobile-app-shell-stack ya da mobile-app-shell-tab (kabuk)",
+    "sourceRef": "platform_guide('page') §Kural 1g-4; MOB-033; kök docs/adr/0023-mobil-cevrimdisi-yerel-kopya-ve-uygulama-paketi.md K2, K8, K13"
+  },
+  "_rules": {
+    "setting": "Veri önbelleği uygulamanın ayarıdır: application_update properties.mobile.offline = { data: true } (isteğe bağlı maxAgeDays: 1 | 7 | 30, varsayılan 7; screens varsayılan açık, yazılmaz). properties gövdesi REPLACE'tir: application_get'teki properties'in TAMAMI (mobile.tabs, mobile.transition ve öteki anahtarlar) aynen gönderilir, yalnız mobile.offline eklenir — eksik gönderilen anahtar silinir. Okunamayan değer MOB-033 uyarısıdır; cihaz onu varsayılana düşürür.",
+    "whatIsStored": "Saklanan: isRaw: false yazılmış GET servis adımlarının yanıtı (isRaw yazılmamış ya da true olan, dosya/akış sonucu dönen adım saklanmaz) ve connectData okumaları (list, describe, lookup). Yazma servisleri (POST/PUT/DELETE) ve connectData yazmaları saklanmaz, ağ yokken hata verir. Kayıtlar kullanıcıya ve ortama bağlıdır; çıkışta ve kullanıcı değişince silinir.",
+    "cacheMark": "Önbellekten yanıtlanan adım BAŞARI yolundan sürer ve storage'ında cache: { at } taşır (at: saklandığı an, ms). Ağdan gelen yanıtta cache alanı YOKTUR — satırın gizli kalmasını buradan alın: isHidden = !Steps.load_orders.cache.",
+    "networkError": "Yanıt hiç alınamadıysa (bağlantı yok; saklanan okumalarda 8 sn süre sınırı da) ve kayıt yoksa adım hata dalına gider: Steps.<ad>.error.network true, status 503. 503'ü sunucu da döner — 'bağlantı yok' için network'e bakın (MOB-033 bilgi notu; status == 503 && !network sunucu arızasını ayıran doğru desendir, not almaz). network alanı yalnız veri önbelleği açık uygulamada yazılır. Saklanmayan isteklerde süre sınırı yoktur: yanıt vermeyen sunucuda adım bekler.",
+    "stale": "Önbellek son başarılı yanıtı aynen verir: her çağrıda değişen bir GET (sayaç, zaman, rastgele) ağ yokken eski değerini döner. Parametreler ve veri dili isteğin parçasıdır; başka parametreli çağrı başka kayıttır.",
+    "detailFromSteps": "Satırlar ve güncelleme satırı SETTER adımıyla yazılır: `{{ Steps.… }}` kod bağı ilk çizimde okunur, Steps'e yazmak düğümü yeniden okutmaz (mobile-list-detail-form ile aynı desen).",
+    "preview": "Önizleme (/dev, Studio, page_screenshot) önbellek KULLANMAZ — ayar açık olsa da her okuma ağdan gider ve cache alanı hiç yazılmaz; güncelleme satırı önizlemede gizli kalır. page_screenshot ağı kesemez: çevrimdışı davranış yalnız cihazda (uçak modu) görülür.",
+    "verify": "page_runtime_get ile sayfa paketi ve akış okunur; page_screenshot({ applicationSlug: '<uygulama>', pageSlug: 'siparisler' }) satırları çizer, txt_guncelleme görünmez."
+  },
+  "pages": [
+    {
+      "applicationUpdateArgs": {
+        "properties": {
+          "...": "<application_get'teki properties'in öteki anahtarları — gövde REPLACE, hepsi aynen gönderilir>",
+          "mobile": {
+            "...": "<mevcut properties.mobile anahtarları (tabs, transition) aynen>",
+            "offline": {
+              "data": true
+            }
+          }
+        }
+      },
+      "pageCreateArgs": {
+        "name": "Siparişler",
+        "slug": "siparisler"
+      },
+      "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": "Siparişler"
+              },
+              "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": "txt_guncelleme",
+            "name": "txt_guncelleme",
+            "type": "text",
+            "kind": "component",
+            "props": {
+              "content": {
+                "type": "static",
+                "ref": null,
+                "data": ""
+              },
+              "type": {
+                "type": "static",
+                "ref": null,
+                "data": "small"
+              },
+              "isHidden": {
+                "type": "static",
+                "ref": null,
+                "data": true
+              }
+            },
+            "appearance": {
+              "marginType": "none",
+              "widthType": "fill"
+            },
+            "blocks": [],
+            "events": [],
+            "validations": [],
+            "stateBindings": [],
+            "children": []
+          }
+        },
+        {
+          "op": "add_component",
+          "parent": "page_container",
+          "component": {
+            "elementId": "scr_siparis",
+            "name": "scr_siparis",
+            "type": "scroll-view",
+            "kind": "component",
+            "props": {
+              "refreshable": {
+                "type": "static",
+                "ref": null,
+                "data": true
+              }
+            },
+            "appearance": {
+              "marginType": "none",
+              "widthType": "fill",
+              "heightType": "fill"
+            },
+            "blocks": [],
+            "events": [],
+            "validations": [],
+            "stateBindings": [],
+            "children": []
+          }
+        },
+        {
+          "op": "add_component",
+          "parent": "scr_siparis",
+          "component": {
+            "elementId": "lst_siparis",
+            "name": "lst_siparis",
+            "type": "repeater",
+            "kind": "component",
+            "props": {
+              "rows": {
+                "type": "static",
+                "ref": null,
+                "data": []
+              }
+            },
+            "appearance": {
+              "marginType": "none",
+              "widthType": "fill"
+            },
+            "blocks": [],
+            "events": [],
+            "validations": [],
+            "stateBindings": [],
+            "children": [
+              {
+                "elementId": "lst_siparis_satir",
+                "name": "lst_siparis_satir",
+                "type": "view",
+                "kind": "component",
+                "props": {},
+                "blocks": [],
+                "children": [
+                  {
+                    "elementId": "row_siparis",
+                    "name": "row_siparis",
+                    "type": "card",
+                    "kind": "component",
+                    "props": {
+                      "title": {
+                        "type": "code",
+                        "ref": "{{ item.no }}"
+                      },
+                      "description": {
+                        "type": "code",
+                        "ref": "{{ item.durum }}"
+                      }
+                    },
+                    "appearance": {
+                      "marginType": "none",
+                      "widthType": "fill"
+                    },
+                    "blocks": [],
+                    "events": [],
+                    "validations": [],
+                    "stateBindings": [],
+                    "children": []
+                  }
+                ]
+              },
+              {
+                "elementId": "lst_siparis_bos_gorunum",
+                "name": "lst_siparis_bos_gorunum",
+                "type": "view",
+                "kind": "component",
+                "props": {},
+                "blocks": [],
+                "children": [
+                  {
+                    "elementId": "lst_siparis_bos",
+                    "name": "lst_siparis_bos",
+                    "type": "emptystate",
+                    "kind": "component",
+                    "props": {
+                      "title": {
+                        "type": "static",
+                        "data": "Sipariş yok"
+                      }
+                    },
+                    "blocks": [],
+                    "children": []
+                  }
+                ]
+              }
+            ]
+          }
+        }
+      ],
+      "mountFlowCreateArgs": {
+        "host": "page",
+        "hostId": "<siparisler sayfa id>",
+        "name": "siparisler mount",
+        "slug": "siparisler-mount",
+        "steps": [
+          {
+            "stepId": "start",
+            "name": "start",
+            "type": "start",
+            "kind": "normal",
+            "args": {},
+            "branches": [
+              {
+                "id": "<GUID>",
+                "name": "always",
+                "nextStepId": "load_orders"
+              }
+            ]
+          },
+          {
+            "stepId": "load_orders",
+            "name": "load_orders",
+            "type": "microservice",
+            "kind": "normal",
+            "args": {
+              "microserviceId": "<sipariş listesi GET microservice id>",
+              "isRaw": false,
+              "parameters": []
+            },
+            "branches": [
+              {
+                "id": "<GUID>",
+                "name": "success",
+                "nextStepId": "apply_rows"
+              },
+              {
+                "id": "<GUID>",
+                "name": "error",
+                "nextStepId": "warn_offline"
+              }
+            ]
+          },
+          {
+            "stepId": "apply_rows",
+            "name": "apply_rows",
+            "type": "setter",
+            "kind": "normal",
+            "args": {
+              "iteratees": [
+                {
+                  "id": "<GUID>",
+                  "type": "change",
+                  "source": "component",
+                  "element": "lst_siparis",
+                  "property": "rows",
+                  "mapping": {
+                    "source": "",
+                    "mappings": {}
+                  },
+                  "value": {
+                    "type": "code",
+                    "ref": "Steps.load_orders.data"
+                  }
+                },
+                {
+                  "id": "<GUID>",
+                  "type": "change",
+                  "source": "component",
+                  "element": "txt_guncelleme",
+                  "property": "content",
+                  "mapping": {
+                    "source": "",
+                    "mappings": {}
+                  },
+                  "value": {
+                    "type": "code",
+                    "ref": "Steps.load_orders.cache ? `Son güncelleme: ${new Date(Steps.load_orders.cache.at).toLocaleString()}` : ''"
+                  }
+                },
+                {
+                  "id": "<GUID>",
+                  "type": "change",
+                  "source": "component",
+                  "element": "txt_guncelleme",
+                  "property": "isHidden",
+                  "mapping": {
+                    "source": "",
+                    "mappings": {}
+                  },
+                  "value": {
+                    "type": "code",
+                    "ref": "!Steps.load_orders.cache"
+                  }
+                }
+              ]
+            },
+            "branches": [
+              {
+                "id": "<GUID>",
+                "name": "always",
+                "nextStepId": null
+              }
+            ]
+          },
+          {
+            "stepId": "warn_offline",
+            "name": "warn_offline",
+            "type": "alert",
+            "kind": "normal",
+            "args": {
+              "message": "{{ Steps.load_orders.error?.network ? 'Bağlantı yok ve bu liste daha önce açılmamış' : 'Siparişler yüklenemedi' }}",
+              "alertType": "info"
+            },
+            "branches": [
+              {
+                "id": "<GUID>",
+                "name": "always",
+                "nextStepId": null
+              }
+            ]
+          }
+        ]
+      },
+      "bindOps": [
+        {
+          "op": "set_event",
+          "target": "page_container",
+          "event": "mount",
+          "eventValue": "<mount akış id>"
+        },
+        {
+          "op": "set_event",
+          "target": "scr_siparis",
+          "event": "refresh",
+          "eventValue": "<mount akış id>"
+        }
+      ]
+    }
+  ]
+}

package/dist/resources/examples/mobile-offline-queue.json

@@ -0,0 +1,82 @@
+{
+  "_meta": {
+    "synthetic": true,
+    "note": "Mobil uygulamada ağ yokken yapılan yazma (kök ADR 0022): bir dozu 'alındı' işaretleyen akış. Servis tanımı offlineWritable bildirir; akışın microservice adımında queued dalı bağlıdır. Ağ yokken çağrı cihazın kuyruğuna girer ve queued dalı 'bağlantı gelince işlenecek' der; bağlantı gelince kayıt aynı Idempotency-Key ile bir kez gönderilir. Akış mobil profilden ve kendi lint kurallarından bulgusuz geçer (test/mobile-rules.test.ts).",
+    "pairsWith": "mobile-offline-list (okuma tarafı: veri önbelleği ve error.network), mobile-list-detail-form (satırdan işlem)",
+    "sourceRef": "platform_guide('page') §Kural 1g-4; FLOW-043; MS-025; kök docs/adr/0022-mobil-yazma-kuyrugu.md; plans/mobil-cevrimdisi-calisma/00-sozlesme.md"
+  },
+  "_rules": {
+    "declare": "Servis tarafı: microservice_patch ile /offlineWritable = true. Anlamı 'aynı istek iki kez gelirse bir kez uygulanır, çakışmada son yazan kazanır'. Okuyan uca (tablo get/count, görünüm) verilirse MS-025 uyarır.",
+    "branch": "Akış tarafı: microservice adımına queued dalı (yalnız mobil). Ağ hatasında (yanıt hiç yok) dal bağlıysa, yöntem yazansa ve dosya parametresi yoksa çağrı kuyruğa girer ve queued koşar: Steps.<ad>.data null, Steps.<ad>.queued = { clientRequestId, at }. Dal bağlı değilse adım bugünkü gibi error'a gider. HTTP hatası (4xx, 5xx, önündeki vekil sunucunun 502'si) kuyruğa girmez.",
+    "serverDecides": "Cihaz servisin bildirimini bilmez — kararı sunucu verir. queued dalı bağlı yazmanın İLK isteği de Idempotency-Key taşır ve kuyruğa aynı kimlikle girer: yanıtı yolda kaybolan yazma kuyruktan gelince 200 { code: 'Duplicate' } alır, ikinci kez uygulanmaz. Bildirimsiz servis anahtarlı isteği 422 OfflineReplayNotAllowedException ile reddeder — adım çevrimiçiyken de her çağrıda error'a gider. Bildirimsiz servise queued bağlamayı FLOW-043 yazımda uyarır.",
+    "visibility": "Kaydın sonucu akışa dönmez. Bekleyen ve reddedilen sayısı Device.offline.queue = { pending, rejected }, reddedilenler Device.offline.rejected (id, service, at, status, code, message). Kod adımında Page.offline.list(), Page.offline.count(), Page.offline.sync() ve Page.offline.resolve(id, 'retry' | 'discard').",
+    "sync": "Gönderim: bağlantının dönüşü, uygulamanın ön plana dönüşü ve ağla soğuk açılış. Sıra kuyruğa giriş zamanı; tek tek; 4xx kaydı reddeder ve sıra sürer, oturum (401/403), 408, 429, 5xx ve ağ hatası sırayı durdurur.",
+    "limits": "Kuyruktaki kayda bağlı ikinci işlem yok: queued yolu Steps.<ad>.data okumaz (dönen kimliği bekleyen adım çevrimdışıyken koşamaz). Dosya parametreli çağrı kuyruğa girmez — adım error'a gider, Steps.<ad>.error.code = 'fileNotQueued'. Kayıt 7 günde gönderilemezse 'expired' ile reddedilir. Kayıtlar kullanıcıya bağlıdır: başkasının bekleyeni gönderilmez, çıkışta silinmez.",
+    "preview": "Studio önizlemesi ve web çalışma zamanında kuyruk yoktur (barındırıcı depo vermez): queued dalı hiç koşmaz. page_screenshot ağı kesemez; davranış yalnız cihazda görülür. Açık ekran ilk çizildiği kopyayla kalır: akışa eklenen queued dalı ekran bir sonraki açılışta etkindir.",
+    "verify": "microservice_get ile offlineWritable, flow_get ile queued dalı okunur. Cihazda: bağlantıyı kes, dozu işaretle (queued dalı koşar), bağlantıyı aç; row_list'te tek kayıt."
+  },
+  "microservicePatchArgs": {
+    "applicationId": "<uygulama id ya da slug>",
+    "id": "<doz-isle microservice id>",
+    "operations": [{ "op": "add", "path": "/offlineWritable", "value": true }]
+  },
+  "flowCreateArgs": {
+    "host": "page",
+    "hostId": "<bugun sayfa id>",
+    "name": "doz-al",
+    "slug": "doz-al",
+    "steps": [
+      {
+        "stepId": "start",
+        "name": "start",
+        "type": "start",
+        "kind": "normal",
+        "args": {},
+        "branches": [{ "id": "<GUID>", "name": "always", "nextStepId": "al" }]
+      },
+      {
+        "stepId": "al",
+        "name": "al",
+        "type": "microservice",
+        "kind": "normal",
+        "args": {
+          "microserviceId": "<doz-isle microservice id>",
+          "isRaw": false,
+          "parameters": [
+            { "name": "dozSaatiId", "type": "text", "source": "body", "value": { "type": "code", "ref": "Row.dozSaatiId" } },
+            { "name": "durum", "type": "text", "source": "body", "value": { "type": "code", "ref": "'alindi'" } }
+          ]
+        },
+        "branches": [
+          { "id": "<GUID>", "name": "always", "nextStepId": "tamam" },
+          { "id": "<GUID>", "name": "error", "nextStepId": "hata" },
+          { "id": "<GUID>", "name": "queued", "nextStepId": "kuyrukta" }
+        ]
+      },
+      {
+        "stepId": "tamam",
+        "name": "tamam",
+        "type": "alert",
+        "kind": "normal",
+        "args": { "message": "Doz kaydedildi", "alertType": "success" },
+        "branches": [{ "id": "<GUID>", "name": "always", "nextStepId": null }]
+      },
+      {
+        "stepId": "hata",
+        "name": "hata",
+        "type": "alert",
+        "kind": "normal",
+        "args": { "message": "{{ Steps.al.error?.code === 'fileNotQueued' ? 'Dosyalı işlem bağlantı gerektirir' : 'Doz kaydedilemedi' }}", "alertType": "error" },
+        "branches": [{ "id": "<GUID>", "name": "always", "nextStepId": null }]
+      },
+      {
+        "stepId": "kuyrukta",
+        "name": "kuyrukta",
+        "type": "alert",
+        "kind": "normal",
+        "args": { "message": "{{ Steps.al.queued ? 'Doz kuyruğa alındı — bağlantı gelince işlenecek' : '' }}", "alertType": "info" },
+        "branches": [{ "id": "<GUID>", "name": "always", "nextStepId": null }]
+      }
+    ]
+  }
+}