@appaflytech/zeyrek-ai-mcp 0.0.50 → 0.0.52

package/dist/tools/mobilePurchases.js

@@ -0,0 +1,236 @@
+import { z } from 'zod';
+import { destructive, environmentParam, guid, projectParam, readOnly, updates, writes } from './common.js';
+import { applicationId } from './mobileStore.js';
+import { unwrap } from './screens.js';
+import { PlatformApiError } from '../platform/errors.js';
+import { handle } from '../platform/responses.js';
+import { GRANTS_AMOUNT_MAX, PRODUCT_KINDS, PRODUCT_PERIODS, PRODUCT_TRIALS, PURCHASE_READINESS_HINTS, PURCHASES_SHELL_VERSION, changedProductFields, mergeProduct, productFormatErrors, productLockedChanges } from '../knowledge/mobileStore.js';
+/**
+ * Uygulama içi satın almanın ajan yolu (kök `docs/adr/0027-uygulama-ici-satin-alma.md`, `plans/mobil-uygulama-ici-satin-alma`
+ * g-01): ürün kataloğu (Core `mobile-store/{appId}/products`, ortam yok), iki mağazaya gönderim işi, mağaza hazırlığı ve
+ * Studio'nun satış listesi (Tenant `{project}/{appId}/purchases`, ortamlı, salt okunur). Gizli bilgi (Apple satın alma
+ * anahtarı `.p8`) ve cihazın anonim uçları (verify / entitlements / restore / bildirimler) bilinçli olarak araç DEĞİLDİR —
+ * ilki Studio'da insanın, ikincisi kabuğun işidir (`platform_guide('mobile-publish')` §Satın almalar).
+ */
+/** Backend'in yalnız gönderimden sonra doğrulayabildiği hazırlık satırı (Android'de ilk ürün mağazada açılınca `ready`) */
+const AFTER_FIRST_SEND_ROW = 'billingBuild';
+const productKey = z.string().min(1).describe("Ürünün Zeyrek anahtarı ^[a-z][a-z0-9_]{1,63}$ ('premium_yillik'); purchase adımı ürünü bu anahtarla anar");
+const sendId = guid.describe("Gönderim işinin id'si (mobile_product_send ya da mobile_product_send_status { applicationId } çıktısı)");
+const productText = z.object({
+    name: z.string().optional().describe('Mağazadaki ad, 1–30'),
+    description: z.string().optional().describe('Mağazadaki açıklama, 1–45')
+}).strict();
+const isObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const list = (payload) => {
+    const data = isObject(payload) && 'data' in payload ? payload.data : payload;
+    return Array.isArray(data) ? data.filter(isObject) : [];
+};
+const storeState = (store) => isObject(store)
+    ? { state: store.state, storeId: store.storeId, ...(Array.isArray(store.pendingChanges) && store.pendingChanges.length > 0 ? { pendingChanges: store.pendingChanges } : {}), error: store.error, storePrice: store.storePrice, sentPriceTry: store.sentPriceTry, lastNotificationAt: store.lastNotificationAt }
+    : undefined;
+const productSummary = (product) => ({
+    id: product.id,
+    key: product.key,
+    kind: product.kind,
+    entitlement: product.entitlement,
+    balance: product.balance,
+    grantsAmount: product.grantsAmount,
+    priceTry: product.priceTry,
+    period: product.period,
+    trial: product.trial,
+    texts: product.texts,
+    reviewAssetId: product.reviewAssetId,
+    ios: storeState(product.ios),
+    android: storeState(product.android),
+    updatedAt: product.updatedAt ?? product.createdAt
+});
+const steps = (value) => (Array.isArray(value) ? value : []).filter(isObject);
+/**
+ * Düşen gönderim adımı → mağaza, adım türü, ürün, kod ve nereye bakılacağı (hata kodları b-03 `MobileStoreProductConstants.Error*`).
+ * Adımın `key`'i `<tür>:<ürün ya da hak>` birleşimidir (`MobileStoreProductSend.Step`); tür `kind`'dadır.
+ */
+const failedSteps = (send) => ['ios', 'android'].flatMap(platform => steps(send[platform])
+    .filter(step => step.state === 'failed')
+    .map(step => `${platform} ${String(step.kind ?? step.key)} ${String(step.productKey ?? step.entitlement ?? '')}: ${String(step.error ?? 'store_error')}${step.detail ? ` (${String(step.detail)})` : ''} → mobile_purchase_readiness`));
+function sendSummary(send, appId) {
+    const failed = failedSteps(send);
+    const active = send.state === 'queued' || send.state === 'running';
+    return {
+        id: send.id,
+        state: send.state,
+        applyToExisting: send.applyToExisting,
+        ios: steps(send.ios),
+        android: steps(send.android),
+        createdAt: send.createdAt,
+        finishedAt: send.finishedAt,
+        ...(failed.length > 0 ? { failedSteps: failed } : {}),
+        ...(active ? { next: `Gönderim sürüyor: mobile_product_send_status { applicationId: '${appId}', sendId: '${String(send.id)}' } ile yeniden okuyun (mağaza çağrıları saniyeler–dakikalar sürer).` } : {}),
+        ...(!active && failed.length > 0 ? { next: `Düşen adımın nedeni giderilince mobile_product_send { applicationId: '${appId}', retrySendId: '${String(send.id)}' } — yalnız bitmemiş adımlar yeniden koşar. Kodlar: paid_agreement (Apple sözleşmesi), play_permission (Play izni), play_billing_build (BILLING'li derleme yok), apple_connection / app_missing (hesap ya da mağaza uygulaması), store_error (ayrıntı detail).` } : {})
+    };
+}
+export function registerMobilePurchaseTools(server, platform) {
+    const config = platform.config;
+    server.registerTool('mobile_product_list', {
+        title: 'Satın alma ürünlerini listele',
+        description: `Mobil uygulamanın uygulama içi satın alma ürünlerini döner (GET mobile-store/{appId}/products; kök ADR 0027). Her ürün: key (Zeyrek anahtarı — purchase adımının args.value'su), kind (subscription | non_consumable | consumable), entitlement (abonelik ve tek seferlikte verdiği hak — ekranlar Entitlements.<hak> okur), balance + grantsAmount (yalnız consumable: bakiyenin adı — ekranlar Balances.<ad> okur, balance-spend adımı bu adla harcar — ve her satın almada eklenen miktar), priceTry, period, trial, texts (dil → { name, description }) ve mağaza başına durum: ios / android { state (draft · sending · ready · in_review · approved · active · failed), storeId (mağazaya gittiyse), pendingChanges (mağazaya gitmemiş değişiklik: name, description, price, period, trial), error (son gönderimin kodu), storePrice }. storeId'si olan ürünün anahtarı, türü, hakkı ve bakiye adı KİLİTLİDİR (miktar değişebilir). Katalog Core'dadır, ortam yoktur. Satın alma kabuk ${PURCHASES_SHELL_VERSION}+ ister.`,
+        inputSchema: { applicationId },
+        annotations: readOnly
+    }, handle(config, async ({ applicationId: appId }) => {
+        const products = list(await platform.org('GET', `/mobile-store/${appId}/products`));
+        return {
+            applicationId: appId,
+            count: products.length,
+            products: products.map(productSummary),
+            ...(products.length === 0 ? { note: 'Bu uygulamada satın alma ürünü yok — çağrı BAŞARILI, sonuç boş. Eklemek için mobile_product_upsert.' } : {})
+        };
+    }));
+    server.registerTool('mobile_product_upsert', {
+        title: 'Satın alma ürünü yaz',
+        description: `Ürünü anahtarıyla yazar (kök ADR 0027): katalogda yoksa açar (POST mobile-store/{appId}/products), varsa okunan ürünün üstüne birleştirip yazar (PUT …/products/{id} tam modeli yazdığı için verilmeyen alan korunur; texts dil dil ve alan alan birleşir, dil: null o dili kaldırır). Yeni üründe kind, priceTry, texts zorunlu; abonelik ve tek seferlikte entitlement, abonelikte period, tüketilende (consumable — kredi, jeton) balance ve grantsAmount da. Değişiklik yoksa yazmaz (outcome 'unchanged'). Gateway backend MobileStoreProductValidator'ın 422 kurallarını istek gitmeden uygular: anahtar ve hak ^[a-z][a-z0-9_]{1,63}$, anahtar uygulamada tekil, bir hak tek türden ürünle verilir (abonelik grubu = hak; aylık + yıllık aynı hakkı paylaşır), fiyat > 0 en çok iki ondalık TRY, abonelikte period ${PRODUCT_PERIODS.join(' | ')} ve trial ${PRODUCT_TRIALS.join(' | ')} ya da boş, tek seferlikte (non_consumable) ve tüketilende ikisi de boş, tüketilende entitlement boş, balance ^[a-z][a-z0-9_]{1,63}$ ve grantsAmount 1–${GRANTS_AMOUNT_MAX} tam sayı (öbür türlerde ikisi de boş), texts en az bir dil, ad 1–30, açıklama 1–45. Tüketilen ürün mağazada \"kredi paketi\"dir: aynı balance'ı birden çok ürün paylaşabilir (kredi_100, kredi_500 → Balances.kredi); satın alma bakiyeyi grantsAmount kadar artırır, harcama balance-spend adımıyla olur (platform_guide('mobile-steps') §Kredi harcama) ve iade o satırın miktarını geri alır; bakiye negatife düşebilir. K9: tüketilen ürün mağazada Geri yükle ile geri gelmez — kullanıcı girişi olmayan uygulamada telefon değişince bakiye gider (MOB-036, flow yazımında uyarır). Tuzak: mağazaya gitmiş ürünün (ios/android storeId) key, kind, entitlement ve balance'ı KİLİTLİDİR (backend 422 MobileStoreProductLockedException) — gateway durdurur; farklı kimlik gerekiyorsa yeni anahtarla yeni ürün açın. Yazmak mağazaya göndermez: gönderilmiş üründeki ad/fiyat/süre değişikliği pendingChanges'e düşer ve mobile_product_send ile gider. Fiyat mağazada TRY basamağına yuvarlanır (storePrice). Ürün katalogda olunca purchase adımının statik anahtarı FLOW-045'ten, balance-spend adımının statik bakiye adı FLOW-046'dan geçer.`,
+        inputSchema: {
+            applicationId,
+            key: productKey,
+            kind: z.enum(PRODUCT_KINDS).optional().describe('subscription (yenilenen abonelik) | non_consumable (tek seferlik, kalıcı hak) | consumable (tüketilen: kredi, jeton — hak değil bakiye verir; balance + grantsAmount zorunlu)'),
+            entitlement: z.string().min(1).optional().describe("Ürünün açtığı hak ('premium'); ekranlar Entitlements.premium okur. Aynı hakkı veren abonelikler mağazada bir grup olur. consumable'da verilmez"),
+            balance: z.string().min(1).optional().describe("Yalnız consumable: bakiyenin adı ^[a-z][a-z0-9_]{1,63}$ ('kredi'); ekranlar Balances.kredi okur, balance-spend adımı args.value'da bu adı kullanır. Aynı adı birden çok ürün paylaşabilir. Mağazaya gidince kilitlenir"),
+            grantsAmount: z.number().optional().describe(`Yalnız consumable: her satın almada bakiyeye eklenen miktar, 1–${GRANTS_AMOUNT_MAX} tam sayı (100). Gönderildikten sonra da değişebilir; eski satışlar eski miktarla kalır`),
+            priceTry: z.number().optional().describe('Tek TRY fiyatı (949.99); öteki ülkeler mağazanın eşlemesiyle'),
+            period: z.enum(PRODUCT_PERIODS).nullable().optional().describe('Yalnız abonelikte, zorunlu'),
+            trial: z.enum(PRODUCT_TRIALS).nullable().optional().describe('Yalnız abonelikte: ücretsiz deneme süresi; boş ya da none = deneme yok'),
+            texts: z.record(productText.nullable()).optional().describe("Dil kodu → { name, description } (ar, en, ru, tr mağazanın diline eşlenir); null o dili kaldırır. Ör. { tr: { name: 'Premium yıllık', description: 'Bütün özellikler' } }"),
+            reviewAssetId: guid.nullable().optional().describe("App Review ekran görüntüsü (mobile_asset_create kind 'reviewAttachment' id'si); Apple'a gönderimde yüklenmez, insan App Store Connect'te ekler")
+        },
+        // Anahtarla idempotent: aynı çağrının ikincisi 'unchanged' döner (organization_component_upsert emsali, 41 §6).
+        annotations: updates
+    }, handle(config, async ({ applicationId: appId, ...patch }) => {
+        const products = list(await platform.org('GET', `/mobile-store/${appId}/products`));
+        const current = products.find(product => product.key === patch.key);
+        const body = mergeProduct(current, patch);
+        const errors = productFormatErrors(body, products.filter(product => product !== current));
+        const locked = current ? productLockedChanges(current, body) : [];
+        if (locked.length > 0) {
+            throw new PlatformApiError(`mobile_product_upsert: '${String(patch.key)}' mağazaya gitmiş (storeId var) — ${locked.join(', ')} KİLİTLİ: mağaza ürünü ve abonelik grubunu bu kimlikle tanır. Hiçbir şey yazılmadı. Alanı yamadan çıkarın; farklı tür ya da hak gerekiyorsa yeni anahtarla yeni ürün açın.`, 422, 'MobileStoreProductLockedException');
+        }
+        if (errors.length > 0) {
+            throw new PlatformApiError(`mobile_product_upsert: ürün biçimsiz — backend 422 ile reddederdi, hiçbir şey yazılmadı: ${errors.map(error => `${error.field}: ${error.message}`).join(' · ')}. Var olan ürünler: mobile_product_list.`, 400, 'product_invalid');
+        }
+        const changed = current ? changedProductFields(current, body) : [];
+        if (current && changed.length === 0)
+            return { outcome: 'unchanged', product: productSummary(current), note: 'Yama kayıttaki değerlerle aynı — hiçbir şey yazılmadı.' };
+        const saved = unwrap(current
+            ? await platform.org('PUT', `/mobile-store/${appId}/products/${String(current.id)}`, { body })
+            : await platform.org('POST', `/mobile-store/${appId}/products`, { body }));
+        const summary = productSummary(saved);
+        const pending = ['ios', 'android'].filter(store => isObject(summary[store]) && Array.isArray(summary[store].pendingChanges));
+        return {
+            outcome: current ? 'updated' : 'created',
+            product: summary,
+            ...(current ? { changed } : {}),
+            note: pending.length > 0
+                ? `Değişiklik ${pending.join(' ve ')} mağazasına gitmedi (pendingChanges) — mobile_product_send ile gönderin; fiyat değişiminde mevcut aboneler varsayılan olarak eski fiyatta kalır (applyToExisting).`
+                : 'Ürün katalogda; mağazalarda açılması için mobile_purchase_readiness ile hazırlığa bakıp mobile_product_send ile gönderin.'
+        };
+    }));
+    server.registerTool('mobile_product_delete', {
+        title: 'Satın alma ürününü sil',
+        description: "Ürünü anahtarıyla siler (DELETE mobile-store/{appId}/products/{id}; gateway anahtarı id'ye çözer). Yalnız mağazaya hiç gitmemiş ürün silinir: storeId'si olan ürün 409 MobileStoreProductSentException — mağazadaki ürün API'den silinemez (Apple ürün kimliğini bir daha kullandırmaz); satıştan kaldırmak App Store Connect / Play Console'da insanın işidir. Silinen ürünü anan purchase adımı cihazda 'invalid' döner: o akış bir sonraki yazımda FLOW-045 ile durur (tüketilen ürünün bakiyesini anan balance-spend adımı FLOW-046 ile), mağaza ön kontrolü P-23 (purchases_unknown_product) uyarır.",
+        inputSchema: { applicationId, key: productKey },
+        annotations: destructive
+    }, handle(config, async ({ applicationId: appId, key }) => {
+        const products = list(await platform.org('GET', `/mobile-store/${appId}/products`));
+        const product = products.find(entry => entry.key === key);
+        if (!product) {
+            throw new PlatformApiError(`mobile_product_delete: '${key}' anahtarlı ürün bu uygulamada yok — hiçbir şey silinmedi. Ürünler: ${products.map(entry => String(entry.key)).join(', ') || '(hiç ürün yok)'}.`, 404);
+        }
+        await platform.org('DELETE', `/mobile-store/${appId}/products/${String(product.id)}`);
+        return { applicationId: appId, deleted: key, productId: product.id };
+    }));
+    server.registerTool('mobile_product_send', {
+        title: 'Ürünleri mağazalara gönder',
+        description: `Katalogdaki ürünleri App Store ve Google Play'e gönderen işi başlatır (POST mobile-store/{appId}/products/send → 202; kök ADR 0027): mağazada hiç olmayan ürünü açar (Apple: abonelik grubu = hak, abonelik ya da tek seferlik ürün, metin, TUR fiyat basamağı, deneme; Google: abonelik = hak, temel plan = ürün anahtarı '_'→'-', deneme teklifi, tek seferlik ürün), pendingChanges taşıyan ürünü günceller, son gönderimde düşmüş ürünü yeniden dener. Hesabı bağlı olmayan mağaza atlanır. İş asenkrondur: mobile_product_send_status ile izleyin. applyToExisting: fiyat değişiminde mevcut abonelere de uygula (varsayılan false — mevcut aboneler eski fiyatta kalır, K3). retrySendId yarıda kalan ya da düşen gönderimi yeniden dener (POST …/sends/{id}/retry; yalnız bitmemiş adımlar koşar, ilk gönderimin applyToExisting seçimiyle); applyToExisting: true ile birlikte verilmez. Hatalar: 409 MobileStoreProductSendRunningException (etkin gönderim var — 15 dakikadan eski asılı iş yeniden denenebilir), 422 MobileStoreProductNothingToSendException (gönderilecek ürün yok). GERİ ALINAMAZ: mağazada açılan ürün API'den silinemez ve Apple ürün kimliğini yeniden kullandırmaz — göndermeden önce anahtarları ve fiyatları kullanıcıya onaylatın; önce mobile_purchase_readiness. Apple ilk satın alma ürününü uygulamanın yeni sürümüyle inceler (durum ready → in_review); Google ürün açmayı faturalandırma izinli derleme yüklenmeden reddeder (play_billing_build). Cihazda satın alma kabuk ${PURCHASES_SHELL_VERSION}+ ile mağaza derlemesi ister.`,
+        inputSchema: {
+            applicationId,
+            applyToExisting: z.boolean().optional().describe('true: fiyat değişimi mevcut abonelere de uygulanır (mağaza kullanıcıyı bilgilendirir). Varsayılan false'),
+            retrySendId: sendId.optional().describe('Bu gönderimi yeniden dener; verilince yeni gönderim açılmaz (applyToExisting: true ile birlikte verilmez)')
+        },
+        annotations: { ...writes, destructiveHint: true }
+    }, handle(config, async ({ applicationId: appId, applyToExisting, retrySendId }) => {
+        if (retrySendId !== undefined && applyToExisting === true) {
+            throw new PlatformApiError("mobile_product_send: retrySendId ile applyToExisting birlikte verilmez — yeniden deneme gönderimin ilk seçimini kullanır. Birini bırakın; hiçbir şey gönderilmedi.", 400);
+        }
+        const send = unwrap(retrySendId
+            ? await platform.org('POST', `/mobile-store/${appId}/products/sends/${retrySendId}/retry`)
+            : await platform.org('POST', `/mobile-store/${appId}/products/send`, { body: { applyToExisting: applyToExisting ?? false } }));
+        return { ...sendSummary(send, appId), next: `Gönderim kuyrukta: mobile_product_send_status { applicationId: '${appId}', sendId: '${String(send.id)}' } ile izleyin.` };
+    }));
+    server.registerTool('mobile_product_send_status', {
+        title: 'Ürün gönderiminin durumu',
+        description: "sendId verilirse o gönderimin durumunu döner (GET mobile-store/{appId}/products/sends/{id}): state (queued | running | completed | failed), applyToExisting, mağaza başına adımlar ios[] / android[] { key ('<kind>:<ürün ya da hak>'), kind (notification_url · group · product · texts · price · trial · base_plan · activate), productKey, entitlement, state (pending | done | failed | skipped), storeRef, error, detail }; düşen adımlar failedSteps'te kod ve öneriyle ('android product premium_yillik: play_permission (403) → mobile_purchase_readiness'), next sıradaki çağrıyı söyler. sendId verilmezse son 5 gönderimin özetini döner (GET …/sends). Ürünün kendi mağaza durumu: mobile_product_list.",
+        inputSchema: { applicationId, sendId: sendId.optional() },
+        annotations: readOnly
+    }, handle(config, async ({ applicationId: appId, sendId: id }) => {
+        if (id)
+            return sendSummary(unwrap(await platform.org('GET', `/mobile-store/${appId}/products/sends/${id}`)), appId);
+        const sends = list(await platform.org('GET', `/mobile-store/${appId}/products/sends`));
+        return {
+            applicationId: appId,
+            count: sends.length,
+            sends: sends.map(send => ({ id: send.id, state: send.state, applyToExisting: send.applyToExisting, failedSteps: failedSteps(send).length, createdAt: send.createdAt, finishedAt: send.finishedAt })),
+            ...(sends.length === 0 ? { note: 'Bu uygulamada hiç ürün gönderimi yok — mobile_product_send.' } : {})
+        };
+    }));
+    server.registerTool('mobile_purchase_readiness', {
+        title: 'Satın alma mağaza hazırlığı',
+        description: `İki mağazanın satın almaya hazırlığını satır satır döner (GET mobile-store/{appId}/purchases/readiness; Studio › Satın almalar › Mağaza hazırlığı ile aynı liste). ios: connection (Apple hesabı) · paidAgreement (ücretli uygulama sözleşmesi, elle) · iapKey (App Store Server API anahtarı .p8) · notificationUrl (App Store Server Notifications V2 adresi, copyValue); android: connection (Play hizmet hesabı) · merchant (ödeme profili, elle) · billingBuild (BILLING izinli derleme yüklendi mi) · permissions (hizmet hesabının ürün izni) · rtdnTopic (gerçek zamanlı bildirim Pub/Sub, copyValue). state: ready · missing · fix · manual (konsolda insanın yaptığı, otomatik doğrulanamaz). Hazır olmayan her satırda hint ne yapılacağını ve kimin yaptığını söyler. ready mağaza başınadır ({ ios, android } — hesabı bağlı olmayan mağaza gönderimde atlanır, öbürünü bekletmez); attention eksik/düzeltilecek satırları sayar. android.billingBuild ilk Android ürünü mağazada açılınca ready olur — ondan önce afterFirstSend'de durur, gönderimi engellemez. Gizli bilgi (hesaplar, .p8) MCP'den YAZILMAZ — Studio'da insan yükler. Mağaza dışı ön koşul: kabuk ${PURCHASES_SHELL_VERSION}+ (ön kontrol P-23).`,
+        inputSchema: { applicationId },
+        annotations: readOnly
+    }, handle(config, async ({ applicationId: appId }) => {
+        const readiness = unwrap(await platform.org('GET', `/mobile-store/${appId}/purchases/readiness`));
+        // Öneri yalnız hazır olmayan satıra eklenir: hazır satırda "bağlı değil" metni yanlış okunur (lokal ölçüm 2026-10-23).
+        const rows = (store) => steps(readiness[store]).map(row => row.state === 'ready' ? row : { ...row, hint: PURCHASE_READINESS_HINTS[`${store}.${String(row.key)}`] });
+        // Backend `billingBuild`'i ancak bir Android ürünü mağazada açılınca `ready` yapar (`MobileStorePurchaseReadinessService`):
+        // ilk gönderimden önce kapı sayılırsa ajan "önce hazırlık" ile gönderim arasında döner. Ayrı listelenir, kapıya girmez.
+        const pending = (store, row) => store === 'android' && row.key === AFTER_FIRST_SEND_ROW && row.state === 'missing';
+        const open = (store) => rows(store).filter(row => (row.state === 'missing' || row.state === 'fix') && !pending(store, row));
+        const attention = ['ios', 'android'].flatMap(store => open(store).map(row => `${store}.${String(row.key)} ${String(row.state)}`));
+        const afterFirstSend = rows('android').filter(row => pending('android', row)).map(row => `android.${String(row.key)}`);
+        return {
+            applicationId: appId,
+            ready: { ios: open('ios').length === 0, android: open('android').length === 0 },
+            attention,
+            ...(afterFirstSend.length > 0 ? { afterFirstSend, afterFirstSendNote: "Bu satır ilk Android ürünü mağazada açılınca ready olur; gönderimi engellemez. Google ürün açmayı BILLING izinli derleme yüklenmeden reddeder (play_billing_build): derleme yüklendiyse gönderin, düşerse derleme yükleyip retrySendId." } : {}),
+            ios: rows('ios'),
+            android: rows('android')
+        };
+    }));
+    server.registerTool('mobile_purchase_list', {
+        title: 'Satışları listele',
+        description: "Uygulamanın satın almalarını ve sayaçları döner (Studio › Satın almalar › Satışlar; Tenant GET {project}/{appId}/purchases + /purchases/summary, salt okunur). Kayıt ortamın şemasındadır: mağaza uygulaması production'a yazar (gerçek satışlar environment: 'production'); development'ta yalnız deneme/yerel doğrulama satırları vardır. items[] { id, userEmail (oturumlu satın almada), installation (kurulum kimliğinin ilk 8 karakteri), entitlement, productKey, productName, productKind, store (ios | android), state (active · trial · grace · cancelled_active · owned açık; expired · refunded kapalı), environment (real | test — TestFlight / Play iç test), nextKind (renews · trial_ends · ends · grace_until · closed_at) + nextAt, purchasedAt }; sayfa 50, nextCursor bir sonraki sayfanın cursor'ı (null = son). summary { activeSubscriptions, inTrial, oneTimeThisMonth (ay sınırı UTC), ownerless (açık sahipsiz satın alma — mağazadan taşınan eski abone) }; satır owner (ownerless · installation · account). Test satın almaları includeTest: true olmadan görünmez. Apple yenileme zinciri tek satırdır. Hak elle verilmez, iade başlatılmaz.",
+        inputSchema: {
+            applicationId,
+            project: projectParam,
+            environment: environmentParam.describe("Satışların okunacağı ortam; gerçek mağaza satışları 'production'. Boşsa DEFAULT_ENVIRONMENT"),
+            type: z.enum(['all', ...PRODUCT_KINDS]).optional().describe('Süzgeç; varsayılan all'),
+            owner: z.enum(['all', 'ownerless', 'installation', 'account']).optional().describe('Sahiplik süzgeci: ownerless (mağazadan taşınan eski abone, cihaz geri yükleyene kadar kimse görmez) · installation · account; varsayılan all'),
+            includeTest: z.boolean().optional().describe('true: TestFlight / Play iç test satın almaları da gelir'),
+            cursor: z.string().min(1).optional().describe('Önceki yanıtın nextCursor değeri')
+        },
+        annotations: readOnly
+    }, handle(config, async ({ applicationId: appId, project, environment, type, owner, includeTest, cursor }) => {
+        const [page, summary] = await Promise.all([
+            platform.tenant('GET', project, `/${appId}/purchases`, { environment, query: { ...(type ? { type } : {}), ...(owner ? { owner } : {}), ...(includeTest !== undefined ? { includeTest } : {}), ...(cursor ? { cursor } : {}) } }),
+            platform.tenant('GET', project, `/${appId}/purchases/summary`, { environment, query: { ...(includeTest !== undefined ? { includeTest } : {}) } })
+        ]);
+        const data = unwrap(page);
+        const items = steps(data.items);
+        return {
+            applicationId: appId,
+            environment: platform.resolveEnvironment(environment),
+            summary: unwrap(summary),
+            count: items.length,
+            items,
+            nextCursor: data.nextCursor ?? null,
+            ...(items.length === 0 ? { note: "Bu ortamda (süzgeçle) satış yok — çağrı BAŞARILI. Gerçek satışlar production'dadır; test satın almaları includeTest: true ister." } : {})
+        };
+    }));
+}

package/dist/tools/mobileStore.js

@@ -20,7 +20,7 @@ import { APPLE_RELEASE_TYPES, ASSET_KINDS, BUILD_ASSET_KINDS, COLOR_PATTERN, DEC
  * Yayın'dan insan yapar (`docs/adr/0002-mobil-yayin-gorsel-ve-beyan.md`). Uçlar Core DB'dedir (ortam
  * kavramı yok); derlenen uygulama işin ortamını okur — boşsa production (backend ADR 0032).
  */
-const applicationId = guid.describe("Mobil uygulamanın id'si (application_list / mobile_app_create çıktısı). Slug verilirse DEFAULT_PROJECT içinde çözülür");
+export const applicationId = guid.describe("Mobil uygulamanın id'si (application_list / mobile_app_create çıktısı). Slug verilirse DEFAULT_PROJECT içinde çözülür");
 const buildId = guid.describe("Derleme işinin id'si (mobile_build_start ya da mobile_build_status { applicationId } çıktısı)");
 const mobilePlatform = z.enum(['ios', 'android']);
 /**

package/dist/tools/mobileStoreImport.js

@@ -0,0 +1,173 @@
+import { readFile, stat } from 'node:fs/promises';
+import { basename, extname, resolve } from 'node:path';
+import { z } from 'zod';
+import { destructive, environmentParam, guid, projectParam, readOnly, writes } from './common.js';
+import { applicationId } from './mobileStore.js';
+import { unwrap } from './screens.js';
+import { PlatformApiError } from '../platform/errors.js';
+import { handle } from '../platform/responses.js';
+import { PURCHASE_IMPORT_MAX_BYTES, STORE_DIFF_CHOICES, STORE_IMPORT_SECTIONS, diffOutline, importReportOutline, purchaseImportOutline } from '../knowledge/storeImport.js';
+/**
+ * Yayındaki uygulamayı mağazalardan Zeyrek'e taşımanın ajan yolu (kök `docs/adr/0028-magazadan-tasima-saklanan-magaza-kimligi.md`,
+ * `plans/mobil-magazadan-tasima` g-01): içe aktarma (Core `mobile-store/{appId}/imports`), eski abone listesinin toplu
+ * doğrulaması (Tenant `{project}/{appId}/purchases/imports`, ortamlı), Apple bildirim adresinin Zeyrek'e çevrilip eski
+ * sunucuya iletilmesi ve yayın öncesi mağaza farkı. Kurallar MOB-037…MOB-041 (`docs/08-kural-envanteri.md`).
+ */
+const importId = guid.describe("İçe aktarma kaydının id'si (mobile_store_import_start ya da mobile_store_import_report çıktısı)");
+export function registerMobileStoreImportTools(server, platform) {
+    const config = platform.config;
+    server.registerTool('mobile_store_import_start', {
+        title: 'Mağazadan içe aktarmayı başlat',
+        description: "Yayındaki uygulamanın App Store ve Google Play kaydını OKUMAYA başlar (POST mobile-store/{appId}/imports; ADR 0028). Önce bağlantı eşzamanlı doğrulanır (connection { ios: found | not_found | no_access, android: … }, upload anahtarı uyarısı), sonra arka plan işi iki mağazayı okur ve üç kovalı rapor yazar (Gelir · Sen yüklersin · Mağazada kalır). Okuma mağazaya HİÇBİR ŞEY yazmaz, Zeyrek'te de hiçbir şey değişmez — değişiklik yalnız mobile_store_import_apply ile olur. Yalnız ilk derlemeden ÖNCE çalışır: ilk derleme kimliği ve sayaçları kilitler (409 MobileStoreImportLockedException → MOB-037: alanları elle doldurun). Yeni okuma açık eski kaydı vazgeçilmiş sayar. Sonra mobile_store_import_report ile durumu okuyun (state queued → reading → ready).",
+        inputSchema: {
+            applicationId,
+            bundleId: z.string().min(1).optional().describe("App Store'daki Bundle ID ('com.anatoli.app'); yalnız Android ise verilmez"),
+            packageName: z.string().min(1).optional().describe("Google Play paket adı ('com.anatoli.app'); yalnız iOS ise verilmez")
+        },
+        annotations: writes
+    }, handle(config, async ({ applicationId: appId, bundleId, packageName }) => {
+        if (!bundleId && !packageName) {
+            throw new PlatformApiError('mobile_store_import_start: bundleId ya da packageName verin — en az bir mağaza okunur. İstek gönderilmedi.', 400, 'store_identity_required');
+        }
+        try {
+            return unwrap(await platform.org('POST', `/mobile-store/${appId}/imports`, { body: { bundleId, packageName } }));
+        }
+        catch (error) {
+            if (error instanceof PlatformApiError && error.status === 409) {
+                throw new PlatformApiError(`${error.message} — MOB-037: ilk derleme Bundle ID / paket adı ve sayaçları kilitledi; içe aktarma artık yapılamaz. Mağaza bilgilerini mobile_store_update ile elle doldurun.`, 409, error.code);
+            }
+            throw error;
+        }
+    }));
+    server.registerTool('mobile_store_import_report', {
+        title: 'İçe aktarma raporunu oku',
+        description: `İçe aktarma kaydını okur (GET mobile-store/{appId}/imports/current ya da …/{importId}). Varsayılan yanıt yalnız özettir: state, okuma ilerlemesi, kova sayaçları (auto · upload · kept · issues), sorunlu satırlar (too_long, store_conflict, locale_unmapped, size_invalid, device_class_unmapped, store_managed…) ve ürün eşleme önerileri. section verilirse o bölümün bütün satırları gelir (${STORE_IMPORT_SECTIONS.join(' · ')}). Rapor kişisel veri taşımaz. Seçimler mobile_store_import_mapping ile yazılır.`,
+        inputSchema: {
+            applicationId,
+            importId: importId.optional(),
+            section: z.enum(STORE_IMPORT_SECTIONS).optional().describe('Bütün satırları istenen bölüm; verilmezse yalnız özet')
+        },
+        annotations: readOnly
+    }, handle(config, async ({ applicationId: appId, importId: id, section }) => {
+        const record = unwrap(await platform.org('GET', id ? `/mobile-store/${appId}/imports/${id}` : `/mobile-store/${appId}/imports/current`));
+        return importReportOutline(record, section);
+    }));
+    server.registerTool('mobile_store_import_mapping', {
+        title: 'İçe aktarma seçimlerini kaydet',
+        description: "Raporun Zeyrek'e nasıl yazılacağını kaydeder (PUT mobile-store/{appId}/imports/{importId}/mapping; seçimler birleşmez, verilen sözlük kaydı değiştirir — önce mobile_store_import_report ile okuyun). Anahtarlar: scheme (ZORUNLU — URL şeması mağazadan okunamaz, eski uygulamanınki girilir; MOB-041/P-31) · choice.<satır> = apple | play | custom ve custom.<satır> (iki mağazada farklı metin, K6) · skip.<satır> / skip.language.<dil> = true · target.language.<mağaza>.<dil> = <Zeyrek dili> (eşlenemeyen dilin metnini o dile yazar; eşlenmiş satırı ezmez) · product.<i>.{key, entitlement, period, trial, price, skip} (i = rapordaki ürün sırası; anahtar ve hak ^[a-z][a-z0-9_]{1,63}$) · declaration.<anahtar> = true. Taslak kural ihlaliyle de saklanır: ihlaller yanıtın violations listesinde [{ row, field, code }] döner (choice_required, period_required, price_required, key_taken…) ve mobile_store_import_apply onlar düzelmeden 422 verir. İçe aktarılan ürünün MAĞAZA KİMLİĞİ seçilmez — mağazadan gelir ve kilitlidir (MOB-038).",
+        inputSchema: {
+            applicationId,
+            importId,
+            mapping: z.record(z.string()).describe("Seçim sözlüğü — ör. { scheme: 'anatoli', 'choice.listing.tr.title': 'apple', 'product.0.key': 'premium_yillik', 'product.0.entitlement': 'premium' }")
+        },
+        annotations: writes
+    }, handle(config, async ({ applicationId: appId, importId: id, mapping }) => {
+        if (!mapping.scheme?.trim()) {
+            throw new PlatformApiError("mobile_store_import_mapping: 'scheme' zorunlu — URL şeması mağazadan okunamaz; eski uygulamanın şemasını girin (MOB-041). İstek gönderilmedi.", 400, 'scheme_required');
+        }
+        return importReportOutline(unwrap(await platform.org('PUT', `/mobile-store/${appId}/imports/${id}/mapping`, { body: { mapping } })));
+    }));
+    server.registerTool('mobile_store_import_apply', {
+        title: 'İçe aktarmayı uygula',
+        description: "Onaylanan raporu TEK İŞLEMDE Zeyrek'e yazar (POST mobile-store/{appId}/imports/{importId}/apply): mağaza ayarı, beyanlar (kaynak import), görseller, ürün kataloğu (saklanan mağaza kimlikleriyle, değişiklik beklemez) ve kimlik kilidi; mağaza tabanı farka kaydedilir. Mağazaya HİÇBİR ŞEY gönderilmez. Uygulanmış kayıt yeniden uygulanmaz (409). Sonra: mobile_product_list (içe aktarılan ürünler), yayından önce mobile_store_diff ve ön kontrol P-24…P-31.",
+        inputSchema: { applicationId, importId },
+        annotations: writes
+    }, handle(config, async ({ applicationId: appId, importId: id }) => importReportOutline(unwrap(await platform.org('POST', `/mobile-store/${appId}/imports/${id}/apply`)))));
+    server.registerTool('mobile_purchase_import', {
+        title: 'Eski abone listesini doğrula',
+        description: `Eski sistemin abone listesini (CSV) Zeyrek'e alır (Tenant POST {project}/{appId}/purchases/imports, multipart). Sütunlar: store (ios | android), transactionId ya da purchaseToken, productId (Google'da zorunlu — mağaza ürün kimliği), isteğe bağlı legacyUserId, email. Sunucu HER satırı mağazaya sorar (Apple App Store Server API, Google Play); dosyanın söylediğine güvenmez. E-posta tek proje kullanıcısıyla eşleşirse satın alma hesaba, yoksa SAHİPSİZ yazılır (MOB-039). dryRun varsayılan TRUE: yalnız sorar, yazmaz — gerçek koşu açık dryRun: false ister. Gerçek satışlar production ortamındadır. Dosya ≤ 5 MB, ≤ 100.000 satır; iş arka planda koşar — mobile_purchase_import_status ile izleyin. Apple satırları satın alma anahtarı (.p8) ister.`,
+        inputSchema: {
+            applicationId,
+            project: projectParam,
+            environment: environmentParam.describe("Abonelerin yazılacağı ortam; gerçek aboneler 'production'"),
+            file: z.string().min(1).describe('Gateway sürecinin makinesindeki .csv dosyasının yolu'),
+            dryRun: z.boolean().optional().describe('Varsayılan true: yalnız mağazaya sorar, satır yazmaz. Gerçek koşu için açıkça false')
+        },
+        annotations: writes
+    }, handle(config, async ({ applicationId: appId, project, environment, file, dryRun }) => {
+        const absolute = resolve(file);
+        if (extname(absolute).toLowerCase() !== '.csv') {
+            throw new PlatformApiError(`mobile_purchase_import: file bir .csv dosyası olmalı (${absolute}). İstek gönderilmedi.`, 400, 'file_invalid');
+        }
+        const size = (await stat(absolute).catch(() => undefined))?.size;
+        if (size === undefined)
+            throw new PlatformApiError(`mobile_purchase_import: dosya okunamadı — ${absolute}. Yol gateway sürecinin çalıştığı makineye göre çözülür.`, 400, 'file_invalid');
+        if (size > PURCHASE_IMPORT_MAX_BYTES)
+            throw new PlatformApiError(`mobile_purchase_import: dosya ${size} B, 5 MB sınırının üstünde. Listeyi bölün. İstek gönderilmedi.`, 400, 'file_too_large');
+        const effectiveDryRun = dryRun !== false;
+        const response = unwrap(await platform.tenant('POST', project, `/${appId}/purchases/imports`, {
+            environment,
+            multipart: [
+                { name: 'File', filename: basename(absolute), contentType: 'text/csv', content: await readFile(absolute) },
+                { name: 'DryRun', value: effectiveDryRun ? 'true' : 'false' }
+            ]
+        }));
+        return {
+            ...purchaseImportOutline(response),
+            dryRun: effectiveDryRun,
+            note: effectiveDryRun
+                ? 'dryRun: hiçbir satın alma yazılmayacak. Sonuçları eski sistemle karşılaştırın; doğruysa aynı dosyayla dryRun: false (MOB-039).'
+                : 'Gerçek koşu: satın almalar yazılıyor. Aynı dosyanın ikinci koşusu already_known döner.'
+        };
+    }));
+    server.registerTool('mobile_purchase_import_status', {
+        title: 'Abone listesi işinin durumu',
+        description: "importId verilirse işin ilerlemesini ve sonuç sayfasını döner (GET {project}/{appId}/purchases/imports/{id}?page=): progress { state (queued · running · completed · failed), total, processed, outcomes (created_ownerless · created_account · already_known · expired · refunded · product_unknown · not_found · pending · invalid_signature · invalid_row), error (iap_key_missing | iap_key_invalid) } ve 100'lük results[] { line, store, id, outcome, state, productKey, owner, email (maskeli), note }. importId verilmezse son 10 iş. Yüklenen dosya iş bitince silinir.",
+        inputSchema: {
+            applicationId,
+            project: projectParam,
+            environment: environmentParam,
+            importId: guid.optional().describe('İşin id’si (mobile_purchase_import çıktısı)'),
+            page: z.number().int().min(0).optional().describe('Sonuç sayfası (100 satır), 0’dan')
+        },
+        annotations: readOnly
+    }, handle(config, async ({ applicationId: appId, project, environment, importId: id, page }) => {
+        if (!id)
+            return { imports: unwrap(await platform.tenant('GET', project, `/${appId}/purchases/imports`, { environment })) };
+        return purchaseImportOutline(unwrap(await platform.tenant('GET', project, `/${appId}/purchases/imports/${id}`, { environment, query: page ? { page } : undefined })));
+    }));
+    server.registerTool('mobile_store_notification_forwarding', {
+        title: 'Apple bildirim iletimi',
+        description: "Apple'ın sunucu bildirim adresini ve eski sunucuya iletimi yönetir (ADR 0028, K1). action: get → durum (Tenant GET {project}/{appId}/purchases/notification-forwarding: active, until, eski adreslerin ana makinesi, delivered · pending · deadLettered, lastError) · switch → Apple'ın üretim + sandbox adresini Zeyrek'e ÇEVİRİR, eski adresleri saklar, forwardDays (varsayılan 90) boyunca her bildirimi aynen eski sunucuya iletir (Core POST mobile-store/{appId}/purchases/notification-url/switch) · revert → saklanan eski adresleri Apple'a GERİ yazar · stop → iletimi durdurur (adresler geri alma için kalır). switch ve revert APPLE'A YAZAR: kullanıcının açık onayı olmadan çağrılmaz, confirm: true ister (MOB-040). Google'da iletim gerekmez: aynı Pub/Sub konusuna Zeyrek için ikinci abonelik (insan, Google Cloud).",
+        inputSchema: {
+            applicationId,
+            project: projectParam,
+            environment: environmentParam,
+            action: z.enum(['get', 'switch', 'revert', 'stop']).describe('get okur; switch / revert Apple\'a yazar; stop iletimi durdurur'),
+            forwardDays: z.number().int().min(0).max(365).optional().describe('switch: iletim süresi (gün), varsayılan 90'),
+            confirm: z.boolean().optional().describe('switch / revert / stop için true — kullanıcı onayladı')
+        },
+        annotations: destructive
+    }, handle(config, async ({ applicationId: appId, project, environment, action, forwardDays, confirm }) => {
+        if (action === 'get')
+            return unwrap(await platform.tenant('GET', project, `/${appId}/purchases/notification-forwarding`, { environment }));
+        if (confirm !== true) {
+            throw new PlatformApiError(`mobile_store_notification_forwarding: '${action}' Apple bildirim adresini ya da iletimi değiştirir — kullanıcıya eski adresin ${action === 'switch' ? `${forwardDays ?? 90} gün iletileceğini` : 'durumunu'} söyleyip onay alın, sonra confirm: true ile çağırın (MOB-040). İstek gönderilmedi.`, 400, 'confirm_required');
+        }
+        if (action === 'switch')
+            return unwrap(await platform.org('POST', `/mobile-store/${appId}/purchases/notification-url/switch`, { body: { forwardDays: forwardDays ?? 90 } }));
+        if (action === 'revert')
+            return unwrap(await platform.org('POST', `/mobile-store/${appId}/purchases/notification-url/revert`));
+        return unwrap(await platform.org('DELETE', `/mobile-store/${appId}/purchases/notification-forwarding`));
+    }));
+    server.registerTool('mobile_store_diff', {
+        title: 'Yayın öncesi mağaza farkı',
+        description: `Yayından hemen önce mağazayı yeniden okur ve üç yollu karşılaştırır: taban (Zeyrek'in mağazada son bıraktığı) · Zeyrek · mağaza (ADR 0028; Core mobile-store/{appId}/store-diff). action: read → yeniden okur (POST) · get → son farkı okur (GET …/current) · choose → çakışmaları seçer (PUT …/{diffId}/choices, choices: { '<platform>:<alan>': ${STORE_DIFF_CHOICES.join(' | ')} }). Satır durumu: unchanged · zeyrek_changed (gönderilir) · store_changed (konsolda elle değişmiş) · both_changed. store_changed / both_changed seçilmeden içe aktarılmış ya da tabanı olan uygulamada mağaza yayını BAŞLAMAZ (409 store_diff_unresolved; fark 30 dk'dan eskiyse ya da ayar değiştiyse store_diff_stale → yeniden read) — MOB-041. 'store' seçimi mağazadaki değeri ZEYREK'E yazar. Varsayılan yanıt yalnız değişen ve çakışan satırlar; send { ios, android } yayının göndereceği alan listesi.`,
+        inputSchema: {
+            applicationId,
+            action: z.enum(['read', 'get', 'choose']),
+            diffId: guid.optional().describe('choose için farkın id’si'),
+            choices: z.record(z.enum(STORE_DIFF_CHOICES)).optional().describe("choose: '<platform>:<alan>' → zeyrek | store, ör. { 'ios:listing.tr.description': 'store' }")
+        },
+        annotations: writes
+    }, handle(config, async ({ applicationId: appId, action, diffId, choices }) => {
+        if (action === 'read')
+            return diffOutline(unwrap(await platform.org('POST', `/mobile-store/${appId}/store-diff`)));
+        if (action === 'get')
+            return diffOutline(unwrap(await platform.org('GET', `/mobile-store/${appId}/store-diff/current`)));
+        if (!diffId || !choices || Object.keys(choices).length === 0) {
+            throw new PlatformApiError("mobile_store_diff: choose için diffId ve en az bir seçim verin (choices: { 'ios:listing.tr.description': 'zeyrek' | 'store' }). İstek gönderilmedi.", 400, 'choices_required');
+        }
+        return diffOutline(unwrap(await platform.org('PUT', `/mobile-store/${appId}/store-diff/${diffId}/choices`, { body: { choices } })));
+    }));
+}

package/dist/tools/platformInfo.js

@@ -60,15 +60,15 @@ export function normalizeGapReport(input) {
 const guideRouting = {
     'getting-started': "boş org'da sıfırdan kurulum sırası",
     'modify-existing': 'mevcut yapıyı bozmadan değiştirme disiplini',
-    workflow: 'DTO-önce akışı, branch bağlama, tip×step matrisi',
+    workflow: 'DTO-önce akışı, branch bağlama, tip×step matrisi, balance adımı (bakiye/hak: krediyi düş, işi yap, düşerse geri ekle; FLOW-046)',
     microservice: 'kaynak seçimi (table > query), selectFields disiplini',
     microfunction: 'kendi runtime\'ında koşan Node/Python fonksiyonu: protokol, yayın döngüsü, step kullanımı',
     entity: "alan tipleri, ilişkiler, hazır entity'ler",
     page: 'sayfa/flow işleri; prop\'u veri kaynağına bağlama (connectData, Kural 1c-3); flex düzen prop grubu ve boyut modları (Kural 1f-2)',
     layout: 'yerleşim kabuğu: tek slot, views, dar ekranda yığılma, widthType fill/fixed/auto',
     mobile: "mobil UYGULAMA (type:'mobile'): kurulum sırası (mobile_app_create), flex-only yerleşim, tipli stil, sekmeler (properties.mobile.tabs) ve çekmece, sayfa mount/focus olayları, MOB-* bulguları, page_screenshot device",
-    'mobile-steps': "mobil uygulamada cihaza dokunan akış adımları (redirect, alert, confirm, download, storage, setcookie, share, haptic, location, notification-*, permission, open-settings, back, ad-show, scan-code, biometric-auth): mobildeki davranış, args sözleşmesi, Steps.<adım> sonucu; bildirim, izin, reklam, biyometri ve konum tarifleri; FLOW-029/030, MOB-024/026/027",
-    'mobile-publish': "mobil uygulamanın mağaza yayını: altı adımlı yolculuk, mobile_store_* / mobile_build_* akışı, ön kontrol P-01…P-22 (push kimlikleri, izinler, reklam, kod tarama, App Review), yayın hedefleri (yalnız dryRun), iki tür güncelleme, derleme hata kodları, insanın Studio'da yaptıkları (test kullanıcıları dahil)",
+    'mobile-steps': "mobil uygulamada cihaza dokunan akış adımları (redirect, alert, confirm, download, storage, setcookie, share, haptic, location, notification-*, permission, open-settings, back, ad-show, scan-code, biometric-auth, purchase, restore-purchases, balance-spend): mobildeki davranış, args sözleşmesi, Steps.<adım> sonucu; bildirim, izin, reklam, biyometri, satın alma (Entitlements/Products, teklif ekranı), kredi harcama (Balances, balance-spend) ve konum tarifleri; FLOW-029/030/045/046, MOB-024/026/027/034/035/036",
+    'mobile-publish': "mobil uygulamanın mağaza yayını: altı adımlı yolculuk, mobile_store_* / mobile_build_* akışı, ön kontrol P-01…P-23 (push kimlikleri, izinler, reklam, kod tarama, App Review, satın alma kabuğu), yayın hedefleri (yalnız dryRun), uygulama içi satın alma (mobile_product_* / mobile_purchase_*: ürün — abonelik, tek seferlik, tüketilen kredi/jeton → hazırlık → faturalandırmalı derleme → gönder; elle kalanlar), iki tür güncelleme, derleme hata kodları, insanın Studio'da yaptıkları (test kullanıcıları dahil)",
     'mobile-connect-data': "mobil uygulamada veri bağlamanın telefon farkı: alt sayfa / ↗ tam ekran seçim (lookup.mobileMode, mobileRow), sonsuz kaydırma (behavior.mobile), datatable kartı (mobileCard), gruplu liste grouping, autocomplete araması, CD-004/019/020",
     'mobile-layout': 'mobil ekranın mizanpajı — tek dil: güvenli alan, tek kaydırıcı, 16 dp kenar, gap ritmi, saydam/yüzeyli grup, genişlik, yarıçap/yazı ölçeği; MOB-015…021 reçeteleri ve layoutReport hiza ölçümü',
     component: 'komponent modeli, olay sözleşmeleri, appearance boyut sözlüğü (widthString/heightString)',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appaflytech/zeyrek-ai-mcp",
-  "version": "0.0.50",
+  "version": "0.0.52",
   "type": "module",
   "description": "Zeyrek (NgApps) platform APIs as MCP tools — data, logic and Studio design surface in one gateway",
   "license": "UNLICENSED",