@appaflytech/zeyrek-ai-mcp 0.0.50 → 0.0.52

package/dist/knowledge/rules.js

@@ -8,7 +8,7 @@ import { accessPolicyRules } from './access.js';
 import { isGuid } from '../platform/refs.js';
 import { themePolicyRules } from './themeRules.js';
 import { processPolicyRules } from './process.js';
-import { mobileStorePolicyRules } from './mobileStore.js';
+import { PRODUCT_KEY_PATTERN, mobileStorePolicyRules, workflowBalanceFindings } from './mobileStore.js';
 const terminalStepTypes = new Set(['response', 'convert', 'revert']);
 const DESCRIPTION_EXEMPT_STEPS = new Set(['start']);
 const stepKindMatrix = {
@@ -30,7 +30,8 @@ const stepKindMatrix = {
     redirect: ['middleware'],
     response: ['workflow', 'middleware'],
     convert: ['workflow'],
-    revert: ['automation']
+    revert: ['automation'],
+    balance: ['workflow', 'automation', 'middleware']
 };
 function asArray(value) {
     return Array.isArray(value) ? value : [];
@@ -177,6 +178,9 @@ export const flowBranchNames = {
     'biometric-auth': ['always', 'error'],
     back: ['always'],
     'scan-code': ['always', 'error'],
+    purchase: ['always', 'error'],
+    'restore-purchases': ['always', 'error'],
+    'balance-spend': ['always', 'error'],
     end: []
 };
 /**
@@ -189,7 +193,7 @@ export const knownFlowStepTypes = new Set([
     'start', 'end', 'query', 'setter', 'download', 'condition', 'redirect', 'setcookie', 'alert', 'confirm',
     'microservice', 'validation', 'flow-trigger', 'storage', 'navigate', 'code', 'function', 'share',
     'haptic', 'location', 'notification-permission', 'notification-schedule', 'notification-cancel', 'bpm',
-    'permission', 'open-settings', 'ad-show', 'back', 'biometric-auth', 'scan-code'
+    'permission', 'open-settings', 'ad-show', 'back', 'biometric-auth', 'scan-code', 'purchase', 'restore-purchases', 'balance-spend'
 ]);
 /**
  * Cihaz yeteneği adımlarının kapalı kümeleri — `@ng-apps/flow` `tasks/device/device.functions.ts`
@@ -215,6 +219,22 @@ export const biometricFallbacks = new Set(['device', 'none']);
  * `upc_a` bilerek yok: UPC-A etiketi iki platformda `ean13` ve on üç haneyle döner.
  */
 export const scanCodeTypes = new Set(['aztec', 'codabar', 'code39', 'code93', 'code128', 'datamatrix', 'ean8', 'ean13', 'itf14', 'pdf417', 'qr', 'upc_e']);
+/**
+ * `purchase` ve `restore-purchases` adımlarının hata sözlüğü (`Steps.<ad>.error.status`) ve `purchase`'ın tek argümanı —
+ * `@ng-apps/flow` `purchase-golden.json` `errors` / `argument`'ın aynası; backend `TestData/flows/purchase-golden.json` aynı
+ * dosyanın bayt bayt kopyasıdır (`test/flow-step-parity.test.ts` üçünü bağlar). Kök ADR 0027 madde 8.
+ */
+export const purchaseErrorStatuses = new Set(['cancelled', 'pending', 'failed', 'unavailable', 'unsupported', 'invalid']);
+export const purchaseStepArguments = new Set(['value']);
+/**
+ * `balance-spend` adımının hata sözlüğü (`Steps.<ad>.error.status`) ve argümanları (`value` = bakiye adı, `title` = miktar; ikisi de
+ * metin şablonu) — `@ng-apps/flow` `balance-spend-golden.json` `errors` / `argument`'ın aynası; backend
+ * `TestData/flows/balance-spend-golden.json` aynı iki listeyi taşır (`test/flow-step-parity.test.ts` üçünü bağlar). Kök ADR 0027 bakiye bölümü.
+ */
+export const balanceSpendErrorStatuses = new Set(['insufficient', 'unavailable', 'unsupported', 'invalid', 'failed']);
+export const balanceSpendStepArguments = new Set(['value', 'title']);
+/** `purchase.value` statikse bu desende bir katalog anahtarıdır (`knowledge/mobileStore.ts` `PRODUCT_KEY_PATTERN`, backend aynası). */
+export const purchaseProductKeyPattern = PRODUCT_KEY_PATTERN;
 /** `permission` adımının kipleri — `@ng-apps/flow` `PERMISSION_MODES`'un aynası (kök ADR 0010); tür adını gateway bilmez, backend doğrular. */
 export const permissionStepModes = new Set(['request', 'check']);
 /**
@@ -898,7 +918,7 @@ export const policyRules = [
                 return [{
                         ruleId: 'WF-005',
                         severity: 'block',
-                        message: `'${stepLabel(step)}' step'i (${step.type}) ${kind} tipinde kullanılamaz. İzin matrisi: variable/set-user/setcookie/redirect yalnız middleware; convert yalnız workflow; revert yalnız automation; response workflow+middleware; process workflow+automation.`,
+                        message: `'${stepLabel(step)}' step'i (${step.type}) ${kind} tipinde kullanılamaz. İzin matrisi: variable/set-user/setcookie/redirect yalnız middleware; convert yalnız workflow; revert yalnız automation; response workflow+middleware; process workflow+automation; balance üçünde de serbest.`,
                         guide: 'ngapps://guides/workflow'
                     }];
             });
@@ -2905,6 +2925,149 @@ export const policyRules = [
             return findings;
         })
     },
+    {
+        id: 'FLOW-045',
+        module: 'flow',
+        appliesTo: ['create', 'update'],
+        sourceRef: "Satın alma adımları (kök docs/adr/0027-uygulama-ici-satin-alma.md madde 8): purchase.value ürünün Zeyrek ANAHTARIDIR ve METİN ŞABLONUDUR (@ng-apps/flow resolveStepText — düz 'premium_yillik' ya da '{{ Components.plan.value }}'; {{ }} dışındaki ifade harfi harfine anahtar sayılır); restore-purchases argümansızdır. Backend FlowDtoValidator HasPurchaseProduct boş değeri 422 FlowStepPurchaseProductMissing ile reddeder, anahtarın katalogda olduğunu denetlemez (iş sahibi kararı b-04, 2026-10-23: Studio → Core bağımlılığı açılmaz; mağaza yayını ön kontrolü P-23 purchases_unknown_product uyarır) — cihaz ve önizleme bilinmeyen anahtarda 'invalid' döner. Katalog denetimi araç katmanındadır ve REDDEDER: {{ }} şablonu olmayan, katalogda olmayan değer block (tools/flows.ts purchaseChecks → knowledge/mobileStore.ts purchaseCatalogFindings; katalog okunamazsa susar). productKey/product/sku gibi anahtarlar StepManagementArgument sözleşmesinde YOK, 200 ile sessizce düşer. İki adım da kapıdır: error dalı → hata akışı → o da yoksa akış adımda BİTER (device.functions.ts settle 'stop')",
+        check: definition => {
+            const errorSteps = flowStepList(definition.errorSteps);
+            const errorFlow = errorSteps.some(step => step.type !== 'start');
+            const statuses = [...purchaseErrorStatuses].join(', ');
+            return flowAllSteps(definition)
+                .filter(step => step.type === 'purchase' || step.type === 'restore-purchases')
+                .flatMap((step) => {
+                const label = flowStepLabel(step);
+                const resultName = step.name || label;
+                const args = (step.args ?? {});
+                const findings = [];
+                if (step.type === 'purchase') {
+                    const value = typeof args.value === 'string' ? args.value.trim() : '';
+                    const stray = ['productKey', 'product', 'productId', 'sku', 'key'].filter(key => args[key] !== undefined && args[key] !== null && args[key] !== '');
+                    const unquoted = value.replace(/^['"`](.*)['"`]$/, '$1');
+                    if (!value) {
+                        findings.push({
+                            ruleId: 'FLOW-045',
+                            severity: 'block',
+                            message: `'${label}' purchase adımının ürünü yok: args.value ürünün Zeyrek anahtarını ister (platform 422 FlowStepPurchaseProductMissing döner) — düz anahtar ('premium_yillik') ya da şablon ('{{ Components.plan.value }}'). Anahtarlar: mobile_product_list.`,
+                            guide: 'ngapps://guides/mobile-steps'
+                        });
+                    }
+                    else if (!value.includes('{{') && !purchaseProductKeyPattern.test(value)) {
+                        findings.push({
+                            ruleId: 'FLOW-045',
+                            severity: 'warn',
+                            message: unquoted !== value && purchaseProductKeyPattern.test(unquoted)
+                                ? `'${label}' purchase adımının ürünü tırnaklı yazılmış: ${value}. Değer metin şablonudur, tırnaklar anahtarın parçası sayılır ve cihaz 'invalid' döner — args.value: '${unquoted}' yazın.`
+                                : /[.([]/.test(value)
+                                    ? `'${label}' purchase adımının ürünü {{ }} dışında ifade: '${value}'. args.value METİN ŞABLONUDUR — ifade harfi harfine anahtar sayılır, cihaz 'invalid' döner. Sarın: '{{ ${value} }}'.`
+                                    : `'${label}' purchase adımının ürünü bir ürün anahtarı değil: '${value}' (${purchaseProductKeyPattern.source}). Katalogdaki hiçbir anahtar bu biçimde olamaz: gateway katalog denetimi yazımı durdurur, cihaz 'invalid' döner. Anahtarlar: mobile_product_list.`,
+                            guide: 'ngapps://guides/mobile-steps'
+                        });
+                    }
+                    if (stray.length > 0) {
+                        findings.push({
+                            ruleId: 'FLOW-045',
+                            severity: value ? 'warn' : 'block',
+                            message: `'${label}' purchase adımında args.${stray.join('/args.')} alanı var: bu anahtar StepManagementArgument sözleşmesinde YOK, platform onu 200 ile sessizce düşürür. Ürünün anahtarı args.value'ya yazılır — ör. args: { value: 'premium_yillik' }.`,
+                            guide: 'ngapps://guides/mobile-steps'
+                        });
+                    }
+                }
+                const errorBranch = flowBranches(step).some(branch => branch.name === 'error' && Boolean(branch.nextStepId));
+                const insideErrorFlow = errorSteps.includes(step);
+                if (!errorBranch && (insideErrorFlow || !errorFlow)) {
+                    findings.push({
+                        ruleId: 'FLOW-045',
+                        severity: 'warn',
+                        message: `'${label}' ${String(step.type)} adımının error dalı da akışın hata adımları da bağlı değil: kullanıcı vazgeçince, ödeme onay beklerken ya da mağaza yokken akış BU ADIMDA BİTER, always'e bağlı adım koşmaz (kapı). Kullanıcıya söylenecek olanı error dalına bağlayın${insideErrorFlow ? ' (adım hata akışının içinde: hata akışının kendi hata akışı yoktur)' : ''} — Steps.${resultName}.error.status: ${statuses}; vazgeçmeye (cancelled) genellikle bir şey gösterilmez, pending 'onay bekleniyor' der.`,
+                        guide: 'ngapps://guides/mobile-steps'
+                    });
+                }
+                return findings;
+            });
+        }
+    },
+    {
+        id: 'FLOW-046',
+        module: 'flow',
+        appliesTo: ['create', 'update'],
+        sourceRef: "Harca adımı (kök docs/adr/0027-uygulama-ici-satin-alma.md bakiye bölümü, plans/mobil-uygulama-ici-satin-alma b-09/g-02): balance-spend.value bakiyenin adı, balance-spend.title MİKTARDIR (adım başına ikisi de METİN ŞABLONU — @ng-apps/flow resolveStepText; {{ }} dışındaki ifade harfi harfine değer sayılır). Backend FlowDtoValidator HasBalanceSpendArguments value ya da title boşsa 422 FlowStepBalanceSpendArgumentMissing döner; ad ^[a-z][a-z0-9_]{1,63}$ (MobileStoreProductConstants.IdentifierPattern), miktar 1 ve üstü tam sayı — aksi cihazda 'invalid'. Bakiye yetmezse adım error dalına 'insufficient' ile düşer (sunucu 409); çevrimdışıyken 'unavailable' (K12: para değeri taşır, çevrimdışı kuyruğa girmez); web'de 'unsupported'. Katalog ayağı araç katmanındadır ve REDDEDER: {{ }} şablonu olmayan, uygulamanın tüketilen ürünlerinde olmayan bakiye adı block (tools/flows.ts purchaseChecks → knowledge/mobileStore.ts balanceCatalogFindings; katalog okunamazsa susar). Workflow yüzeyindeki balance adımı aynı katalog denetimini workflowStepFindings'te alır. balance/amount/name gibi anahtarlar StepManagementArgument sözleşmesinde YOK, 200 ile sessizce düşer. error dalı bağlı değilse akış adımda BİTER (kapı)",
+        check: definition => {
+            const errorSteps = flowStepList(definition.errorSteps);
+            const errorFlow = errorSteps.some(step => step.type !== 'start');
+            const statuses = [...balanceSpendErrorStatuses].join(', ');
+            return flowAllSteps(definition)
+                .filter(step => step.type === 'balance-spend')
+                .flatMap((step) => {
+                const label = flowStepLabel(step);
+                const resultName = step.name || label;
+                const args = (step.args ?? {});
+                const value = typeof args.value === 'string' ? args.value.trim() : '';
+                const title = typeof args.title === 'string' ? args.title.trim() : '';
+                const stray = ['balance', 'amount', 'name', 'key', 'idempotencyKey'].filter(key => args[key] !== undefined && args[key] !== null && args[key] !== '');
+                const unquoted = value.replace(/^['"`](.*)['"`]$/, '$1');
+                const findings = [];
+                if (!value) {
+                    findings.push({
+                        ruleId: 'FLOW-046',
+                        severity: 'block',
+                        message: `'${label}' balance-spend adımının bakiye adı yok: args.value bakiyenin adını ister (platform 422 FlowStepBalanceSpendArgumentMissing döner) — düz ad ('kredi') ya da şablon ('{{ Components.secim.value }}'). Adlar: mobile_product_list (consumable ürünün balance alanı).`,
+                        guide: 'ngapps://guides/mobile-steps'
+                    });
+                }
+                else if (!value.includes('{{') && !purchaseProductKeyPattern.test(value)) {
+                    findings.push({
+                        ruleId: 'FLOW-046',
+                        severity: 'warn',
+                        message: unquoted !== value && purchaseProductKeyPattern.test(unquoted)
+                            ? `'${label}' balance-spend adımının bakiye adı tırnaklı yazılmış: ${value}. Değer metin şablonudur, tırnaklar adın parçası sayılır ve cihaz 'invalid' döner — args.value: '${unquoted}' yazın.`
+                            : /[.([]/.test(value)
+                                ? `'${label}' balance-spend adımının bakiye adı {{ }} dışında ifade: '${value}'. args.value METİN ŞABLONUDUR — ifade harfi harfine ad sayılır, cihaz 'invalid' döner. Sarın: '{{ ${value} }}'.`
+                                : `'${label}' balance-spend adımının bakiye adı geçerli bir ad değil: '${value}' (${purchaseProductKeyPattern.source}). Katalogdaki hiçbir bakiye bu biçimde olamaz: cihaz 'invalid' döner. Adlar: mobile_product_list.`,
+                        guide: 'ngapps://guides/mobile-steps'
+                    });
+                }
+                if (!title) {
+                    findings.push({
+                        ruleId: 'FLOW-046',
+                        severity: 'block',
+                        message: `'${label}' balance-spend adımının miktarı yok: args.title düşülecek miktarı ister (platform 422 FlowStepBalanceSpendArgumentMissing döner) — düz tam sayı ('10') ya da şablon ('{{ Components.adet.value }}'). Miktar args.amount DEĞİL args.title'dır.`,
+                        guide: 'ngapps://guides/mobile-steps'
+                    });
+                }
+                else if (!title.includes('{{') && !/^[1-9][0-9]*$/.test(title)) {
+                    findings.push({
+                        ruleId: 'FLOW-046',
+                        severity: 'warn',
+                        message: /[.([]/.test(title)
+                            ? `'${label}' balance-spend adımının miktarı {{ }} dışında ifade: '${title}'. args.title METİN ŞABLONUDUR — ifade harfi harfine metin sayılır ve miktar geçersiz olur ('invalid'). Sarın: '{{ ${title} }}'.`
+                            : `'${label}' balance-spend adımının miktarı 1 ve üstü bir tam sayı değil: '${title}'. Cihaz 'invalid' döner; sıfır ve eksi miktar harcama değildir.`,
+                        guide: 'ngapps://guides/mobile-steps'
+                    });
+                }
+                if (stray.length > 0) {
+                    findings.push({
+                        ruleId: 'FLOW-046',
+                        severity: value && title ? 'warn' : 'block',
+                        message: `'${label}' balance-spend adımında args.${stray.join('/args.')} alanı var: bu anahtar StepManagementArgument sözleşmesinde YOK, platform onu 200 ile sessizce düşürür. Bakiye adı args.value'ya, miktar args.title'a yazılır — ör. args: { value: 'kredi', title: '10' }. Tekrar güvenliği (idempotencyKey) bu adımda yoktur: sunucu her tıklamada ayrı anahtar üretir.`,
+                        guide: 'ngapps://guides/mobile-steps'
+                    });
+                }
+                const errorBranch = flowBranches(step).some(branch => branch.name === 'error' && Boolean(branch.nextStepId));
+                const insideErrorFlow = errorSteps.includes(step);
+                if (!errorBranch && (insideErrorFlow || !errorFlow)) {
+                    findings.push({
+                        ruleId: 'FLOW-046',
+                        severity: 'warn',
+                        message: `'${label}' balance-spend adımının error dalı da akışın hata adımları da bağlı değil: bakiye yetmediğinde (insufficient), çevrimdışıyken (unavailable) ya da kabuk satın almayı taşımıyorken akış BU ADIMDA BİTER, always'e bağlı adım koşmaz (kapı). Kullanıcıya söylenecek olanı error dalına bağlayın${insideErrorFlow ? ' (adım hata akışının içinde: hata akışının kendi hata akışı yoktur)' : ''} — Steps.${resultName}.error.status: ${statuses}; insufficient genellikle "Kredin yetmiyor" ile satın alma ekranına yönlendirir.`,
+                        guide: 'ngapps://guides/mobile-steps'
+                    });
+                }
+                return findings;
+            });
+        }
+    },
     {
         id: 'FLOW-041',
         module: 'flow',
@@ -3939,6 +4102,35 @@ export async function microfunctionArchiveEntrypointFindings(platform, project,
 }
 /** `MicrofunctionLanguageProfile.ModuleExtension` — dil adı bilgi katmanında taşınır. */
 const microfunctionModuleExtensions = { node: '.js', python: '.py' };
+/**
+ * `balance` adımının (StepType.Balance, kök ADR 0027 bakiye bölümü) FLOW-046 denetimi: statik bakiye/hak adı uygulamanın ürün
+ * kataloğunda olmalı (`knowledge/mobileStore.ts` `workflowBalanceFindings`). Katalog uygulamanın mobil mağaza kaydındadır; adım
+ * `applicationId` ifadesi verirse o uygulama, vermezse akışın uygulaması okunur. Katalog okunamazsa (mobil olmayan uygulama
+ * 404, ağ) ya da uygulama bir ifadeyle/slug'la anılıyorsa yalnız idempotencyKey uyarısı kalır — bilmediğimizi ret diye söylemeyiz.
+ */
+async function workflowBalanceStepFindings(platform, application, sites) {
+    if (sites.length === 0)
+        return [];
+    const targets = new Map();
+    for (const site of sites) {
+        const expression = typeof site.rule.expression === 'string' ? site.rule.expression : '';
+        const named = /(?:^|[{,\s])applicationId\s*:\s*(['"`])([^'"`]*)\1/.exec(expression)?.[2];
+        const target = named === undefined ? application : isGuid(named) ? named : undefined;
+        if (target !== undefined)
+            targets.set(target, [...(targets.get(target) ?? []), site]);
+    }
+    const found = [];
+    for (const [target, group] of targets) {
+        const products = await platform.org('GET', `/mobile-store/${target}/products`)
+            .then(payload => {
+            const data = payload && typeof payload === 'object' && 'data' in payload ? payload.data : payload;
+            return Array.isArray(data) ? data.filter((entry) => Boolean(entry) && typeof entry === 'object') : undefined;
+        }, () => undefined);
+        const all = workflowBalanceFindings(group.map(({ label, rule }) => ({ label, rule })), products ?? []);
+        found.push(...(products ? all : all.filter(finding => finding.severity !== 'block')));
+    }
+    return found;
+}
 /**
  * WF-032'nin ikinci yarısı. `rule.expression`'ın işe yarayıp yaramayacağı gövdeden görülemez:
  * `WorkflowStep` ifadeyi YALNIZ çağrılan akışın parametre DTO'su varken değerlendirir
@@ -3958,13 +4150,14 @@ export async function workflowStepFindings(platform, project, environment, appli
         : hasText(definition.applicationId) ? String(definition.applicationId) : undefined;
     if (application === undefined)
         return [];
+    const balanceFindings = await workflowBalanceStepFindings(platform, application, stepCallSites(workflowBody(definition, kind), 'balance'));
     const sites = stepCallSites(workflowBody(definition, kind), 'workflow')
         .filter(site => GUID_PATTERN.test(String(site.rule.workflowId ?? '')));
     if (sites.length === 0)
-        return [];
+        return applyPolicyMode(platform.config, balanceFindings, policyOverride);
     const guide = 'ngapps://guides/workflow';
     const records = new Map();
-    const findings = [];
+    const findings = [...balanceFindings];
     for (const { label, rule } of sites) {
         const workflowId = String(rule.workflowId);
         if (!records.has(workflowId)) {

package/dist/knowledge/storeImport.js

@@ -0,0 +1,69 @@
+/**
+ * Mağazadan taşımanın (kök ADR 0028, `plans/mobil-magazadan-tasima` g-01) saf yanıt özetleri. Backend kayıtları büyük:
+ * içe aktarma raporu her dil ve görsel için satır, fark her alan için satır taşır; ajan yalnız karar vereceği satırı görür
+ * (`docs/41-arac-tasarim-standardi.md` §5 yanıt bütçesi).
+ */
+/** Backend `MobileStoreImportConstants.Section*` — rapor bölümleri */
+export const STORE_IMPORT_SECTIONS = ['identity', 'texts', 'urls', 'appInfo', 'assets', 'declarations'];
+/** Backend `MobileStoreDiffConstants.Choice*` */
+export const STORE_DIFF_CHOICES = ['zeyrek', 'store'];
+/** Backend `PurchaseOptions.ImportMaxBytes` */
+export const PURCHASE_IMPORT_MAX_BYTES = 5_242_880;
+/** Fark satırının seçim isteyen durumları (`MobileStoreDiffConstants.ConflictStates`) */
+export const STORE_DIFF_CONFLICT_STATES = ['store_changed', 'both_changed'];
+const isObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const items = (value) => (Array.isArray(value) ? value : []).filter(isObject);
+/** Rapor: varsayılan özet + sorunlu satırlar + ürün önerileri; `section` verilirse o bölümün bütün satırları. */
+export function importReportOutline(record, section) {
+    const report = isObject(record.report) ? record.report : {};
+    const sections = items(report.sections);
+    const issues = sections.flatMap(entry => items(entry.rows)
+        .filter(row => Array.isArray(row.issues) && row.issues.length > 0)
+        .map(row => ({ section: entry.key, field: row.field, store: row.store, issues: row.issues, value: row.value, alternative: row.alternative })));
+    const violations = items(record.violations);
+    return {
+        id: record.id,
+        state: record.state,
+        connection: record.connection,
+        progress: record.progress,
+        summary: report.summary,
+        issues,
+        products: items(report.products).map((product, index) => ({ index, kind: product.kind, bucket: product.bucket, suggestedKey: product.suggestedKey, suggestedEntitlement: product.suggestedEntitlement, apple: product.apple, play: product.play, storeManaged: product.storeManaged, issues: product.issues })),
+        mapping: record.mapping,
+        ...(violations.length > 0 ? { violations, next: `Taslak kaydedildi ama ${violations.length} kural ihlali var; mobile_store_import_apply bunlar düzelmeden 422 döner. Satırı düzeltip mobile_store_import_mapping'i yeniden çağırın.` } : {}),
+        ...(section ? { rows: items(sections.find(entry => entry.key === section)?.rows) } : {}),
+        error: record.error,
+        appliedAt: record.appliedAt
+    };
+}
+/** Fark: değişmeyen satırlar sayılır, gösterilmez; çakışmalar ve gönderilecek alanlar ayrı listelenir. */
+export function diffOutline(diff) {
+    const rows = items(diff.rows);
+    const changed = rows.filter(row => row.state !== 'unchanged');
+    const unresolved = Array.isArray(diff.unresolved) ? diff.unresolved : [];
+    const unreadPlatforms = Array.isArray(diff.unreadPlatforms) ? diff.unreadPlatforms : [];
+    return {
+        id: diff.id,
+        readAt: diff.readAt,
+        fresh: diff.fresh,
+        unchanged: rows.length - changed.length,
+        changed: changed.map(row => ({ key: row.key, state: row.state, base: row.base, zeyrek: row.zeyrek, store: row.store, choice: isObject(diff.choices) ? diff.choices[String(row.key)] : undefined })),
+        unresolved,
+        send: diff.send,
+        storeSendFields: diff.storeSendFields,
+        ...(unreadPlatforms.length > 0 ? { unreadPlatforms, note: `${unreadPlatforms.join(', ')} mağazası okunamadı (429/5xx/ağ): son bilinen hâli esas alındı, yalnız Zeyrek'te değişen alanlar gönderilir ve yayın durmaz. Konsoldaki elle değişiklik bu okumada görünmez; mümkünse mobile_store_diff { action: 'read' } ile yeniden okuyun (MOB-041).` } : {}),
+        ...(unresolved.length > 0 ? { next: `Yayın bu ${unresolved.length} çakışma seçilmeden başlamaz: mobile_store_diff { action: 'choose', diffId: '${String(diff.id)}', choices: { '<key>': 'zeyrek' | 'store' } } — 'store' mağazadaki değeri Zeyrek'e yazar (MOB-041).` } : {})
+    };
+}
+/** Abone listesi işi: ilerleme + sonuç sayfası; e-posta backend'de maskelidir. */
+export function purchaseImportOutline(response) {
+    const progress = isObject(response.progress) ? response.progress : response;
+    return {
+        progress,
+        results: items(response.results),
+        page: response.page,
+        hasMore: response.hasMore,
+        ...(progress.state === 'queued' || progress.state === 'running' ? { next: `İş sürüyor: mobile_purchase_import_status { importId: '${String(progress.id)}' } ile yeniden okuyun.` } : {}),
+        ...(progress.error === 'iap_key_missing' ? { fix: 'Apple satırları için satın alma anahtarı (.p8, App Store Server API) Studio › Yayınla › Gizli bilgiler’de yüklenmeli — MCP’den yazılmaz.' } : {})
+    };
+}

package/dist/resources/examples/flow-credit-spend.json

@@ -0,0 +1,233 @@
+{
+  "_meta": {
+    "synthetic": true,
+    "note": "Mobil kredi harcama ekranı (kök docs/adr/0027-uygulama-ici-satin-alma.md bakiye bölümü, plans/mobil-uygulama-ici-satin-alma g-02): bakiye Balances.kredi'den okunur, düğme balance-spend ile 10 kredi düşer; bakiye yetmezse (insufficient) kullanıcıya söylenir. Akış FLOW-046'dan temiz geçer (test/coverage.test.ts). Kredi satın almak ayrı bir teklif ekranıdır: consumable ürün (kredi_100) purchase adımıyla alınır (flow-purchase-paywall).",
+    "pairsWith": "flow-purchase-paywall (kredi satışı); önce mobile_product_upsert { key: 'kredi_100', kind: 'consumable', balance: 'kredi', grantsAmount: 100, priceTry, texts }",
+    "sourceRef": "platform_guide('mobile-steps') §Kredi harcama tarifi; platform_guide('mobile-publish') §Satın almalar (tüketilen ürün); backend 04-bakiye-defteri.md §Harcama (409 insufficient, çevrimdışı unavailable)"
+  },
+  "_rules": {
+    "order": "Sıra: (1) mobile_product_upsert ile consumable ürün (balance: 'kredi'); (2) page_create + schemaPatchOps (kök önce safe-area); (3) flowCreateArgs; (4) bindOps ile akış kimliğini düğmeye bağla. Bakiye adı katalogdaki consumable ürünün balance alanıdır: katalogda olmayan statik ad FLOW-046 ile yazımda durur.",
+    "args": "balance-spend.value bakiye adı, balance-spend.title MİKTARDIR (args.amount/args.balance sessizce düşer). İkisi de metin şablonudur: düz '10' ya da seçimden '{{ adet.value }}'; {{ }} dışındaki ifade harfi harfine metin sayılır.",
+    "branches": "Adım KAPIDIR: error dalı → hata akışı → ikisi de yoksa akış adımda biter. Steps.<ad>.error.status: insufficient (bakiye yetmiyor, sunucu 409) · unavailable (çevrimdışı ya da sunucuya ulaşılamadı — çevrimdışı kuyruğa girmez) · unsupported (web uygulaması, production /view, eski kabuk) · invalid (ad ya da miktar geçersiz) · failed.",
+    "balance": "Harcamadan sonra Balances kendiliğinden güncellenir; sonucu ayrıca okumayın. Bakiye yalnız sunucudan gelir, istemcide hesaplanmaz.",
+    "signIn": "Girişsiz uygulamada bakiye kuruluma yazılır ve tüketilen ürün mağazada geri yüklenemez: telefon değişince bakiye gider (MOB-036). Girişli uygulamada hesaba taşınır."
+  },
+  "pageCreateArgs": {
+    "name": "Kredi",
+    "slug": "kredi"
+  },
+  "schemaPatchOps": [
+    {
+      "op": "add_component",
+      "parent": "page_container",
+      "component": {
+        "elementId": "guvenli_alan",
+        "name": "guvenli_alan",
+        "type": "safe-area",
+        "kind": "component",
+        "props": {},
+        "appearance": {
+          "marginType": "none",
+          "widthType": "fill"
+        },
+        "blocks": [],
+        "events": [],
+        "validations": [],
+        "stateBindings": [],
+        "children": [
+          {
+            "elementId": "kredi_ekrani",
+            "name": "kredi_ekrani",
+            "type": "container",
+            "kind": "component",
+            "props": {
+              "direction": {
+                "type": "static",
+                "ref": null,
+                "data": "column"
+              },
+              "gap": {
+                "type": "static",
+                "ref": null,
+                "data": "medium"
+              },
+              "horizontalAlign": {
+                "type": "static",
+                "ref": null,
+                "data": "stretch"
+              }
+            },
+            "appearance": {
+              "marginType": "none",
+              "widthType": "fill"
+            },
+            "blocks": [],
+            "events": [],
+            "validations": [],
+            "stateBindings": [],
+            "children": [
+              {
+                "elementId": "txt_kredi_baslik",
+                "name": "txt_kredi_baslik",
+                "type": "text",
+                "kind": "component",
+                "props": {
+                  "content": {
+                    "type": "static",
+                    "ref": null,
+                    "data": "Rapor üret"
+                  },
+                  "type": {
+                    "type": "static",
+                    "ref": null,
+                    "data": "h2"
+                  }
+                },
+                "appearance": {
+                  "marginType": "none",
+                  "widthType": "fill"
+                },
+                "blocks": [],
+                "events": [],
+                "validations": [],
+                "stateBindings": [],
+                "children": []
+              },
+              {
+                "elementId": "txt_bakiye",
+                "name": "txt_bakiye",
+                "type": "text",
+                "kind": "component",
+                "props": {
+                  "content": {
+                    "type": "code",
+                    "ref": "{{ 'Kredin: ' + (Balances.kredi ?? 0) }}",
+                    "data": null
+                  }
+                },
+                "appearance": {
+                  "marginType": "none",
+                  "widthType": "fill"
+                },
+                "blocks": [],
+                "events": [],
+                "validations": [],
+                "stateBindings": [],
+                "children": []
+              },
+              {
+                "elementId": "btn_uret",
+                "name": "btn_uret",
+                "type": "button",
+                "kind": "component",
+                "props": {
+                  "text": {
+                    "type": "static",
+                    "ref": null,
+                    "data": "Rapor üret (10 kredi)"
+                  },
+                  "kind": {
+                    "type": "static",
+                    "ref": null,
+                    "data": "primary"
+                  }
+                },
+                "appearance": {
+                  "marginType": "none",
+                  "widthType": "fill"
+                },
+                "blocks": [],
+                "events": [],
+                "validations": [],
+                "stateBindings": [],
+                "children": []
+              }
+            ]
+          }
+        ]
+      }
+    }
+  ],
+  "flowCreateArgs": {
+    "host": "page",
+    "hostId": "<kredi sayfasının id'si>",
+    "name": "rapor-uret",
+    "slug": "rapor-uret",
+    "steps": [
+      {
+        "stepId": "start",
+        "name": "start",
+        "type": "start",
+        "kind": "normal",
+        "args": {},
+        "branches": [
+          {
+            "name": "always",
+            "nextStepId": "harca"
+          }
+        ]
+      },
+      {
+        "stepId": "harca",
+        "name": "harca",
+        "type": "balance-spend",
+        "kind": "normal",
+        "args": {
+          "value": "kredi",
+          "title": "10"
+        },
+        "branches": [
+          {
+            "name": "always",
+            "nextStepId": "hazir"
+          },
+          {
+            "name": "error",
+            "nextStepId": "olmadi"
+          }
+        ]
+      },
+      {
+        "stepId": "hazir",
+        "name": "hazir",
+        "type": "alert",
+        "kind": "normal",
+        "args": {
+          "message": "Raporun hazır. {{ Balances.kredi }} kredin kaldı.",
+          "alertType": "success"
+        },
+        "branches": [
+          {
+            "name": "always",
+            "nextStepId": null
+          }
+        ]
+      },
+      {
+        "stepId": "olmadi",
+        "name": "olmadi",
+        "type": "alert",
+        "kind": "normal",
+        "args": {
+          "message": "{{ Steps.harca.error.status === 'insufficient' ? 'Krediniz yetmiyor: önce kredi satın alın.' : 'Harcama yapılamadı: ' + Steps.harca.error.message }}",
+          "alertType": "error"
+        },
+        "branches": [
+          {
+            "name": "always",
+            "nextStepId": null
+          }
+        ]
+      }
+    ],
+    "errorSteps": []
+  },
+  "bindOps": [
+    {
+      "op": "set_event",
+      "target": "btn_uret",
+      "event": "click",
+      "eventValue": "<rapor-uret akış id>"
+    }
+  ]
+}