@appaflytech/zeyrek-ai-mcp 0.0.35 → 0.0.37

package/dist/tools/mobileStore.js

@@ -0,0 +1,556 @@
+import { readFile } from 'node:fs/promises';
+import { basename, resolve } from 'node:path';
+import { z } from 'zod';
+import { destructive, environmentParam, guid, projectParam, readOnly, updates, writes } from './common.js';
+import { unwrap } from './screens.js';
+import { PlatformApiError } from '../platform/errors.js';
+import { handle } from '../platform/responses.js';
+import { attachFindings, enforcePolicy, evaluatePolicy } from '../knowledge/policy.js';
+import { policyRules } from '../knowledge/rules.js';
+import { ASSET_KINDS, BUILD_ASSET_KINDS, DECLARATION_KEYS, DEVICE_CLASSES, MAX_ASSET_BYTES, ORIENTATIONS, RELEASE_STATUSES, SCREENSHOT_CAPTURE_DEVICES, SPLASH_RESIZE_MODES, USER_INTERFACE_STYLES, assetSlotProblem, changedStoreFields, mergeStoreSettings, permissionLaunchShellWarnings, permissionStoreBuildWarnings } from '../knowledge/mobileStore.js';
+/**
+ * Mobil mağaza yayınının ajan yolu (`plans/mobil-magaza-yayini` g-11, `plans/mobil-yayin-mcp` g-01):
+ * gizli olmayan mağaza ayarı, mağaza görselleri, beyanlar ve derleme işi. Gizli bilgi (Apple/Google
+ * hesabı, sertifika, keystore, profil, demo parolası) ve runner kaydı bilinçli olarak YOK — Studio ›
+ * Yayın'dan insan yapar (`docs/adr/0002-mobil-yayin-gorsel-ve-beyan.md`). Uçlar Core DB'dedir (ortam
+ * kavramı yok); derlenen uygulama her zaman production ortamını okur.
+ */
+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']);
+const buildTarget = z.enum(['build', 'testflight', 'internal'])
+    .describe("build: yalnız derler (imzasız/imzalı çıktı, mağazaya gitmez) · testflight: iOS'ta TestFlight'a yükler · internal: Android'de Play iç test kanalına yükler. Varsayılan build");
+const listingSchema = z.object({
+    title: z.string().optional().describe('≤ 30'),
+    subtitle: z.string().optional().describe('≤ 30 (iOS)'),
+    shortDescription: z.string().optional().describe('≤ 80 (Play)'),
+    description: z.string().optional().describe('≤ 4000'),
+    keywords: z.array(z.string()).optional().describe('virgülle birleşik ≤ 100 (iOS)'),
+    promoText: z.string().optional().describe('≤ 170 (iOS)'),
+    releaseNotes: z.string().optional().describe('≤ 4000')
+}).strict();
+const settingsPatch = z.object({
+    displayName: z.string().optional().describe('Cihazda görünen ad, ≤ 30'),
+    bundleIdentifier: z.string().optional().describe('iOS kimliği (com.firma.uygulama); ilk derlemeden sonra KİLİTLİ'),
+    androidPackage: z.string().optional().describe('Android paket adı; segment Java anahtar sözcüğü olamaz; ilk derlemeden sonra KİLİTLİ'),
+    scheme: z.string().optional().describe("Derin bağlantı şeması, ^[a-z][a-z0-9+.-]{2,}$, 'zeyrek' yasak; ilk derlemeden sonra KİLİTLİ"),
+    version: z.string().optional().describe('MAJOR.MINOR.PATCH (öndeki sıfır yok)'),
+    iosBuildNumber: z.number().int().nullable().optional().describe('SON ayrılan iOS derleme numarası (sıradaki +1). Yalnız mevcut mağaza uygulaması taşınırken ve ilk derlemeden ÖNCE yazılır; null = değiştirme'),
+    androidVersionCode: z.number().int().nullable().optional().describe('SON ayrılan Android versionCode; iosBuildNumber ile aynı kural'),
+    orientation: z.enum(ORIENTATIONS).optional(),
+    supportsTablet: z.boolean().optional(),
+    userInterfaceStyle: z.enum(USER_INTERFACE_STYLES).optional(),
+    adaptiveIconBackground: z.string().optional().describe('#RRGGBB'),
+    splashBackgroundColor: z.string().optional().describe('#RRGGBB'),
+    splashResizeMode: z.enum(SPLASH_RESIZE_MODES).optional(),
+    permissions: z.record(z.string().nullable()).optional().describe('Modül → izin açıklaması (1–500); anahtar ^[a-z][A-Za-z0-9]*$ (ör. camera)'),
+    permissionModes: z.record(z.string()).optional().describe("İzin anahtarı → mağaza derlemesindeki kip: auto (uygulama kullanıyorsa dahil; varsayılan) | on (her zaman dahil) | off (dahil etme — o izni kullanan ekran 'unavailable' alır, production kullanıyorsa ön kontrol P-12 derlemeyi durdurur). Yalnız çıkarılabilir izinler yazılır (backend 422); anahtarlar ve bugünkü durum: mobile_store_get { detail: ['permissions'] }. Yama kayıttaki kiplerin üstüne birleşir"),
+    launchPermissions: z.array(z.string()).optional().describe("Uygulama açılınca bir kez sorulacak izinlerin anahtarları (mağaza sürümünde; yalnız hiç sorulmamışsa sorulur; soruş sırası dizinin değil kataloğun sırasıdır). Liste BÜTÜN olarak yazılır: verilen dizi kayıttakinin yerine geçer, [] hepsini kaldırır. Açılışta sormak bir kullanımdır: izin derlemeye girer ve bir sonraki mağaza derlemesiyle etkili olur. Kipi off olan izin listeye yazılamaz (derlemenin taşımadığı izin sorulamaz): önce permissionModes.<key> auto ya da on yapılır. Anahtarlar: mobile_store_get { detail: ['permissions'] }"),
+    listing: z.record(listingSchema).optional().describe("Dil kodu ('tr', 'en-US') → mağaza metni; verilen dil alan alan birleşir. Dil SİLİNMEZ (alanları '' yapılır; dili kaldırmak Studio › Yayın)"),
+    urls: z.object({
+        support: z.string().optional(),
+        marketing: z.string().optional(),
+        privacyPolicy: z.string().optional().describe('Yüklemede zorunlu'),
+        privacyChoices: z.string().optional()
+    }).strict().optional().describe('Boş ya da mutlak https:// adres'),
+    apple: z.object({
+        ascAppId: z.string().optional(),
+        categories: z.object({ primary: z.string().optional(), secondary: z.string().optional() }).strict().optional(),
+        advisory: z.record(z.string()).optional(),
+        copyright: z.string().optional().describe('≤ 200; TestFlight yüklemesinde zorunlu')
+    }).strict().optional(),
+    play: z.object({
+        developerId: z.string().optional(),
+        contactEmail: z.string().optional().describe('Play yüklemesinde zorunlu'),
+        releaseStatus: z.enum(RELEASE_STATUSES).optional().describe('Play uygulaması taslakken yalnız draft kabul edilir')
+    }).strict().optional(),
+    review: z.object({
+        firstName: z.string().optional(),
+        lastName: z.string().optional(),
+        phone: z.string().optional(),
+        email: z.string().optional(),
+        notes: z.string().optional()
+    }).strict().optional().describe('App Review iletişim bilgisi. Demo hesabı parolası burada YOK — gizli bilgidir, Studio › Yayın › Hesaplar')
+}).strict();
+/** Backend bir çağrıda en çok bu kadar satır döner (`MobileBuildService.LogPageLimit`); dolu sayfa = devamı var */
+const LOG_PAGE_LIMIT = 2000;
+const isObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+// Bölüm ve alan adları `secretKeyPattern`'e (credential|secret|token…) takılmamalı: takılan anahtarın
+// değeri yanıtta `***` olur (GW-001). Bu yüzden kimlik bilgisi bölümü `signing`, olay türü `subject`.
+const DETAIL_SECTIONS = ['assets', 'signing', 'runners', 'audit', 'permissions'];
+/** Son kaç denetim kaydı döner; Studio aynı listeyi sayfalamadan gösterir, ajanın son olaylar yeter */
+const AUDIT_LIMIT = 20;
+/** İzin başına dönen kullanım yeri; toplam `usageCount`'tadır (bir izni 200 sayfa kullanabilir) */
+const PERMISSION_USAGE_LIMIT = 20;
+const slotOf = (asset) => [asset.kind, asset.locale, asset.deviceClass].filter(Boolean).join('/');
+const assetSummary = (asset) => ({
+    id: asset.id,
+    slot: slotOf(asset),
+    sortOrder: asset.sortOrder,
+    contentType: asset.contentType,
+    width: asset.width,
+    height: asset.height,
+    size: asset.size,
+    createdAt: asset.createdAt
+});
+/**
+ * Görsel listesi varsayılan olarak yuva başına sayıya indirgenir; `assets` ayrıntısı istenirse id'li
+ * liste döner (sıralama ve silme id ister). İçerik (bayt, url) hiç dönmez.
+ */
+function storeSummary(store, detailAssets = false) {
+    const assets = Array.isArray(store.assets) ? store.assets.filter(isObject) : [];
+    const slots = new Map();
+    for (const asset of assets)
+        slots.set(slotOf(asset), (slots.get(slotOf(asset)) ?? 0) + 1);
+    const declarations = isObject(store.declarations) ? store.declarations : {};
+    return {
+        applicationId: store.applicationId,
+        persisted: store.persisted,
+        settings: store.settings,
+        lockedFields: store.lockedFields,
+        updatedAt: store.updatedAt,
+        updatedBy: store.updatedBy,
+        assets: detailAssets ? assets.map(assetSummary) : Object.fromEntries(slots),
+        declarations: Object.fromEntries(Object.entries(declarations).map(([key, value]) => [key, isObject(value) && value.checked === true]))
+    };
+}
+const list = (payload) => {
+    const data = isObject(payload) && 'data' in payload ? payload.data : payload;
+    return Array.isArray(data) ? data.filter(isObject) : [];
+};
+const secretSummary = (secret) => ({ id: secret.id, kind: secret.kind, maskedId: secret.maskedId, meta: secret.meta, createdAt: secret.createdAt });
+/**
+ * Yayın hazırlığının salt okunur bölümleri. Gizli değer bu uçların hiçbirinde yoktur (backend yalnız
+ * maskeli id + meta döner, `MobileStoreSecretDtos.cs`); her bölüm ayrı okunur ve düşen bölüm çağrıyı
+ * düşürmez (uç hatası, 404/5xx). Bölümler taban okumayla aynı `mobile.store.read` iznini ister; izni olmayan
+ * kullanıcı zaten taban GET'te düşer.
+ */
+async function readDetail(platform, appId, section, scope) {
+    try {
+        if (section === 'permissions') {
+            const environment = platform.resolveEnvironment(scope.environment);
+            const view = unwrap(await platform.org('GET', `/mobile-store/${appId}/permissions`, { query: { environment } }));
+            // Cihaz sayıları tenant'tadır ve yoklukları görünümü düşürmez (push kapalı, proje çözülemedi).
+            const devices = await platform.tenant('GET', scope.project, `/push/devices/${appId}/permission-stats`, { environment })
+                .then(unwrap, (error) => {
+                if (!(error instanceof PlatformApiError))
+                    throw error;
+                return error;
+            });
+            const counts = !(devices instanceof PlatformApiError) && isObject(devices.byPermission) ? devices.byPermission : {};
+            const entries = Array.isArray(view.permissions) ? view.permissions.filter(isObject) : [];
+            const warnings = [...permissionStoreBuildWarnings(entries, String(view.environment)), ...permissionLaunchShellWarnings(entries, view.shell)];
+            return {
+                permissions: {
+                    catalogVersion: view.catalogVersion,
+                    environment: view.environment,
+                    usageReadable: view.usageReadable,
+                    shell: view.shell,
+                    ...(devices instanceof PlatformApiError ? {} : { devicesTotal: devices.total }),
+                    permissions: entries.map((entry) => {
+                        const usage = Array.isArray(entry.usage) ? entry.usage : [];
+                        const key = String(entry.key);
+                        return { ...entry, usageCount: usage.length, usage: usage.slice(0, PERMISSION_USAGE_LIMIT), ...(isObject(counts[key]) ? { devices: counts[key] } : {}) };
+                    })
+                },
+                ...(warnings.length > 0 ? { permissionWarnings: warnings } : {}),
+                ...(devices instanceof PlatformApiError ? { permissionDevicesError: devices.message } : {})
+            };
+        }
+        if (section === 'signing') {
+            const [credentials, accounts] = await Promise.all([
+                platform.org('GET', `/mobile-store/${appId}/credentials`),
+                platform.org('GET', '/mobile-store/accounts')
+            ]);
+            return {
+                signing: {
+                    app: list(credentials).map(credential => ({ ...secretSummary(credential), exportable: credential.exportable })),
+                    accounts: list(accounts).map(account => ({
+                        ...secretSummary(account),
+                        label: account.label,
+                        lastUsedAt: account.lastUsedAt,
+                        certificates: Array.isArray(account.certificates) ? account.certificates.filter(isObject).map(secretSummary) : []
+                    }))
+                }
+            };
+        }
+        if (section === 'runners') {
+            const runners = unwrap(await platform.org('GET', '/mobile-runners'));
+            return {
+                runners: {
+                    sharedOnline: runners.sharedOnline,
+                    dedicated: (Array.isArray(runners.runners) ? runners.runners.filter(isObject) : []).map(runner => ({
+                        id: runner.id, name: runner.name, shared: runner.shared, platforms: runner.platforms, online: runner.online, registered: runner.registered, lastSeenAt: runner.lastSeenAt
+                    }))
+                }
+            };
+        }
+        const audits = list(await platform.org('GET', '/mobile-store/secret-audits', { query: { applicationId: appId } }));
+        return { audit: audits.slice(0, AUDIT_LIMIT).map(entry => ({ kind: entry.kind, subject: entry.secretKind, maskedId: entry.maskedId, jobId: entry.jobId, actor: entry.actor, occurredAt: entry.occurredAt })) };
+    }
+    catch (error) {
+        if (!(error instanceof PlatformApiError))
+            throw error;
+        return { [`${section}Error`]: error.message };
+    }
+}
+/**
+ * Ön kontrol P-09 dedicated YA DA shared çevrimiçiyse geçer (`MobileStorePreflightService.cs` P-09) ve
+ * istenen kapsama bakmaz; kapsam verilip o kapsamda runner yoksa iş kuyrukta `runner_lost` ile düşer.
+ */
+async function runnerScopeProblem(platform, mobile, scope) {
+    const runners = unwrap(await platform.org('GET', '/mobile-runners'));
+    const shared = isObject(runners.sharedOnline) && runners.sharedOnline[mobile] === true;
+    const dedicated = (Array.isArray(runners.runners) ? runners.runners.filter(isObject) : [])
+        .some(runner => runner.shared !== true && runner.online === true && Array.isArray(runner.platforms) && runner.platforms.includes(mobile));
+    const online = scope === 'shared' ? shared : dedicated;
+    if (online)
+        return undefined;
+    const other = scope === 'shared' ? dedicated : shared;
+    return `runnerScope '${scope}' için çevrimiçi ${mobile} runner'ı yok — iş hiç alınmaz ve derleme numarası yanardı. ${other ? `'${scope === 'shared' ? 'dedicated' : 'shared'}' kapsamında çevrimiçi runner var: o kapsamı verin ya da runnerScope'u bırakın (backend seçer).` : 'Hiçbir kapsamda çevrimiçi runner yok: runner Mac\'te zeyrek-mobile-runner run.'}`;
+}
+const PNG_SIGNATURE = [0x89, 0x50, 0x4e, 0x47];
+const JPEG_SIGNATURE = [0xff, 0xd8, 0xff];
+const startsWith = (bytes, signature) => signature.every((byte, index) => bytes[index] === byte);
+/**
+ * Görsel baytını `path` ya da base64 `content`'ten okur ve biçimi imzadan çıkarır. Backend yalnız PNG/JPEG
+ * kabul eder, derleme görseli yalnız PNG (`MobileStoreAssetValidator`); ölçü ve alfa denetimi backend'de.
+ */
+async function readAsset(kind, path, content, filename) {
+    if ((path === undefined) === (content === undefined)) {
+        throw new PlatformApiError("mobile_asset_create: `path` ya da `content`'ten TAM OLARAK biri verilir — `path` gateway'in okuyabildiği yerel dosya (page_screenshot outPath'i), `content` base64 içerik (filename ile).", 400);
+    }
+    let bytes;
+    if (path !== undefined) {
+        try {
+            bytes = await readFile(resolve(path));
+        }
+        catch (error) {
+            throw new PlatformApiError(`mobile_asset_create: dosya okunamadı — ${resolve(path)} (${error instanceof Error ? error.message : String(error)}). Yol gateway sürecinin çalıştığı makineye göre çözülür.`, 400);
+        }
+    }
+    else {
+        bytes = Buffer.from(content, 'base64');
+    }
+    if (bytes.byteLength === 0 || bytes.byteLength > MAX_ASSET_BYTES) {
+        throw new PlatformApiError(`mobile_asset_create: görsel ${bytes.byteLength} B — 1 B ile ${MAX_ASSET_BYTES} B (10 MB) arasında olmalı. Hiçbir şey yüklenmedi.`, 400);
+    }
+    const png = startsWith(bytes, PNG_SIGNATURE);
+    const jpeg = startsWith(bytes, JPEG_SIGNATURE);
+    const buildKind = BUILD_ASSET_KINDS.includes(kind);
+    if (!png && !(jpeg && !buildKind)) {
+        throw new PlatformApiError(`mobile_asset_create: '${kind}' ${buildKind ? 'yalnız PNG' : 'PNG ya da JPEG'} kabul eder, dosya ${jpeg ? 'JPEG' : 'ikisi de değil'}. Hiçbir şey yüklenmedi.`, 400);
+    }
+    const extension = png ? 'png' : 'jpg';
+    return { bytes, name: filename ?? (path !== undefined ? basename(path) : `${kind}.${extension}`), contentType: png ? 'image/png' : 'image/jpeg' };
+}
+const captureTable = DEVICE_CLASSES.map(deviceClass => {
+    const device = SCREENSHOT_CAPTURE_DEVICES[deviceClass];
+    return `${deviceClass} → device { width: ${device.width}, height: ${device.height}, scale: ${device.scale} } (${device.width * device.scale}×${device.height * device.scale})`;
+}).join(' · ');
+/**
+ * Ayar yaması: kaydı okur, yamayı birleştirir, MOB-022'yi uygular, tam gövdeyi yazar (g-11). Değişiklik
+ * yoksa yazmaz. `declarations` / `registerAppleBundleId` ile aynı çağrıda ilk adımdır — bundle ID kaydı
+ * yeni yazılan `bundleIdentifier`'ı kullanır.
+ */
+async function writeSettings(platform, config, appId, requested, policyOverride) {
+    const settings = Object.fromEntries(Object.entries(requested).filter(([, value]) => value !== null));
+    const current = unwrap(await platform.org('GET', `/mobile-store/${appId}`));
+    const before = isObject(current.settings) ? current.settings : {};
+    const changed = changedStoreFields(before, settings);
+    if (changed.length === 0)
+        return { ...storeSummary(current), changed, note: 'Yama kayıttaki değerlerle aynı — hiçbir ayar yazılmadı.' };
+    const locked = changed.filter(field => Array.isArray(current.lockedFields) && current.lockedFields.includes(field));
+    if (locked.length > 0) {
+        throw new PlatformApiError(`mobile_store_update: ${locked.join(', ')} ilk derlemeden sonra KİLİTLİ — mağaza bu kimliği/numarayı uygulamanın kendisi sayar, değişen kimlik yeni bir mağaza uygulaması demektir. Hiçbir alan yazılmadı. Kilitli alanı yamadan çıkarın; farklı kimlik gerçekten gerekiyorsa yeni bir mobil uygulama açın (mobile_app_create).`, 422, 'MobileStoreFieldLockedException');
+    }
+    const body = mergeStoreSettings(before, settings);
+    const findings = enforcePolicy(evaluatePolicy(config, policyRules, 'mobileStore', body, { operation: 'update' }, policyOverride));
+    const saved = unwrap(await platform.org('PUT', `/mobile-store/${appId}`, { body: { ...body, expectedUpdatedAt: current.updatedAt ?? null } }));
+    return attachFindings({ ...storeSummary(saved), changed }, findings);
+}
+const seconds = (from, to) => {
+    const start = typeof from === 'string' ? Date.parse(from) : NaN;
+    const end = typeof to === 'string' ? Date.parse(to) : NaN;
+    return Number.isFinite(start) && Number.isFinite(end) ? Math.max(0, Math.round((end - start) / 1000)) : undefined;
+};
+/** Aşama süresi: bir aşama bir sonrakinin başladığı anda, sonuncusu iş bittiğinde (sürüyorsa şimdi) biter. */
+function buildSummary(job, now) {
+    const stages = Array.isArray(job.stages) ? job.stages.filter(isObject) : [];
+    const active = job.status === 'queued' || job.status === 'running';
+    const end = typeof job.finishedAt === 'string' ? job.finishedAt : now;
+    return {
+        id: job.id,
+        applicationId: job.applicationId,
+        platform: job.platform,
+        target: job.target,
+        status: job.status,
+        stage: job.stage,
+        stages: stages.map((entry, index) => ({
+            stage: entry.stage,
+            startedAt: entry.startedAt,
+            seconds: seconds(entry.startedAt, stages[index + 1]?.startedAt ?? end)
+        })),
+        elapsedSeconds: seconds(job.startedAt ?? job.createdAt, end),
+        version: job.version,
+        buildNumber: job.buildNumber,
+        runnerScope: job.runnerScope,
+        cancelRequested: job.cancelRequested,
+        awaitingStore: job.status === 'running' && job.stage === 'store_processing',
+        error: job.error,
+        storeResult: job.storeResult,
+        hasArtifact: job.hasArtifact,
+        createdAt: job.createdAt,
+        finishedAt: job.finishedAt,
+        ...(active ? { next: 'İş sürüyor: mobile_build_status ile yeniden okuyun (aşamalar dakikalar sürer), günlük için mobile_build_log { after }' } : {}),
+        ...(isObject(job.error) ? { next: `Hata kodu → öneri: platform_guide('mobile-publish', 'hata-kodlari'); ayrıntı mobile_build_log` } : {})
+    };
+}
+export function registerMobileStoreTools(server, platform) {
+    const config = platform.config;
+    server.registerTool('mobile_store_get', {
+        title: 'Mobil mağaza ayarını oku',
+        description: "Mobil uygulamanın gizli olmayan mağaza ayarını döner (GET mobile-store/{appId}): kimlik (bundleIdentifier, androidPackage, scheme), sürüm ve sayaçlar, görünüm, izin metinleri, kipleri ve açılışta sorulanlar (permissions, permissionModes, launchPermissions), listing (dil başına mağaza metni), urls, apple, play, review; lockedFields (ilk derlemeden sonra değişmeyen alanlar), görsel yuvası başına sayı (assets: 'screenshot/tr/iphone69': 3) ve beyanlar (declarations: anahtar → işaretli mi). Kayıt hiç yazılmamışsa persisted:false ve VARSAYILANLAR döner (kaydedilmez). manifest:true derlemeye gidecek manifesti de ekler (manifest-preview; sayaçlar SIRADAKİ numara); üretilemiyorsa manifestError alan adıyla döner. detail ayrıntı bölümleri ekler: 'assets' görselleri id'li liste olarak döner (mobile_asset_update / mobile_asset_delete id ister), 'signing' uygulamanın kimlik bilgilerini (signing.app: iOS profili, Android keystore, harita anahtarı, demo hesabı) ve organizasyonun Apple/Google hesaplarını + sertifikalarını (signing.accounts), 'runners' çevrimiçi runner'ları, 'audit' son 20 gizli bilgi olayını (subject: hangi tür, kim, ne zaman, hangi iş), 'permissions' izin görünümünü (permissions.permissions[]: uygulamanın isteyebileceği her izin için mode, text/defaultText, usage — izni kullanan sayfa·bileşen ya da akış adımı (setter ile yazılan tetikleyici prop dahil), ilk 20 yer + usageCount, çağrının environment'ından; usageReadable false ise o ortam okunamamıştır ve boş usage 'kullanılmıyor' demek değildir —, build — mağaza derlemesi taşıyor mu ve neden; HER ZAMAN production'dan: build.usageCount production'daki kullanım, build.staticUsageCount onun yazılı (ifadesiz) kısmı —, devices — aktif cihazların izin durumu sayıları; missingFromStoreBuilds — o izni taşımayan son mağaza derlemeleri; shell.carriesPermissions false ise kipler ve kabuğun henüz taşımadığı izinler bir sonraki kabuk sürümüyle etkili olur; shell.carriesLaunchPermissions false ise açılışta sorulan izinler (askOnLaunch) o kabukta sorulmaz — permissionWarnings söyler). Gizli DEĞER hiçbir bölümde yoktur — yalnız tür, maskeli id ve meta (ekip, son kullanma); bir bölüm okunamazsa (uç hatası) <bölüm>Error döner, çağrı düşmez. Gizli bilgiyi EKLEMEK/DEĞİŞTİRMEK MCP'den yapılmaz — Studio › Yayın › Hesaplar.",
+        inputSchema: {
+            applicationId,
+            manifest: z.boolean().optional().describe('true: derleme manifestinin önizlemesini de ekler'),
+            detail: z.array(z.enum(DETAIL_SECTIONS)).optional().describe("Ayrıntı bölümleri: 'assets' (id'li görsel listesi), 'signing' (kimlik bilgisi ve hesap durumu, değersiz), 'runners', 'audit', 'permissions' (izin görünümü; kullanılan bir izin mağazadaki son derlemede yoksa ya da açılışta sorulan izin varken yayındaki kabuk açılışta sormuyorsa permissionWarnings)"),
+            project: projectParam.describe("Yalnız detail: ['permissions'] için: cihaz sayılarının okunacağı proje; boşsa DEFAULT_PROJECT"),
+            environment: environmentParam.describe("Yalnız detail: ['permissions'] için: KULLANIMIN okunacağı ortam (boşsa DEFAULT_ENVIRONMENT). build her zaman production'dan hesaplanır; yalnız okumadır")
+        },
+        annotations: readOnly
+    }, handle(config, async ({ applicationId: appId, manifest, detail, project, environment }) => {
+        const sections = new Set(detail ?? []);
+        const store = storeSummary(unwrap(await platform.org('GET', `/mobile-store/${appId}`)), sections.has('assets'));
+        const details = await Promise.all(DETAIL_SECTIONS.filter(section => section !== 'assets' && sections.has(section)).map(section => readDetail(platform, appId, section, { ...(project ? { project } : {}), ...(environment ? { environment } : {}) })));
+        const result = Object.assign(store, ...details);
+        if (!manifest)
+            return result;
+        try {
+            return { ...result, manifest: unwrap(await platform.org('GET', `/mobile-store/${appId}/manifest-preview`)) };
+        }
+        catch (error) {
+            if (!(error instanceof PlatformApiError))
+                throw error;
+            return { ...result, manifestError: error.message };
+        }
+    }));
+    server.registerTool('mobile_store_update', {
+        title: 'Mobil mağaza ayarını güncelle',
+        description: "Mobil uygulamanın mağaza kaydını yazar; üç parçadan en az biri verilir ve sırayla uygulanır: settings → declarations → registerAppleBundleId. (1) settings gizli olmayan ayarın YAMASIDIR (PUT mobile-store/{appId}): gateway kaydı okur, verilen alanları üstüne birleştirir (iç nesneler alan alan, listing dil dil; dizi ve skaler yerine geçer) ve tam gövdeyi yazar — backend PUT tam satırı yazdığı için yamasız gönderilen gövde öteki alanları varsayılana döndürürdü. Sayaçlar (iosBuildNumber, androidVersionCode) yalnız yamada varsa gider. Yazmadan önce MOB-022: biçimsiz alan (paket adı, şema, semver, renk, listing sınırları, https adres, e-posta) backend'in 422'siyle aynı gerekçeyle isteği DURDURUR (policyOverride:true ile gönderilir, backend yine reddeder); mağazaya yükleme için boş kalan alanlar uyarıdır, kayıt taslak olarak yazılır. Tuzak: bundleIdentifier, androidPackage, scheme ve sayaçlar İLK DERLEMEDEN SONRA KİLİTLİDİR (lockedFields) — değişimi 422 MobileStoreFieldLockedException. Eşzamanlılık: PUT okunan kaydın updatedAt değerini expectedUpdatedAt olarak taşır; arada Studio'dan ya da başka bir çağrıdan yazılmışsa 409 MobileStoreSettingsStaleException döner ve hiçbir alan yazılmaz — aynı yamayla aracı yeniden çağırın. (2) declarations mağaza beyanlarını işaretler (PUT mobile-store/{appId}/declarations): appPrivacy (iOS App Privacy), dataSafety, contentRating, targetAudience, appAccess (Play Console). BEYAN KULLANICININDIR: true, kullanıcının o formu App Store Connect / Play Console'da doldurduğunu onayladığı anlamına gelir ve ön kontrol (P-10) bunu doğru kabul eder — kullanıcı açıkça onaylamadan true YAZMAYIN; false işareti kaldırır. Verilmeyen anahtar değişmez. (3) registerAppleBundleId:true kayıttaki bundleIdentifier'ı App Store Connect'e kaydeder (POST mobile-store/{appId}/ios/bundle-id; ön kontrol P-04 asc_bundle_id_missing'in düzeltmesi). Organizasyonda Apple hesabı ve mobile.secrets.write izni ister; kayıtlıysa yeniden oluşturmaz (bundleId.created:false). Kayıt hiç yazılmamışsa (persisted:false) REDDEDİLİR — kimlik otomatik varsayılandır ve Apple'daki kayıt silinemez; aynı çağrıda settings.bundleIdentifier verin. İşlem yoktur: sonraki adım düşerse önceki adımlar yazılmış kalır ve yanıt <adım>Error + note taşır. YAPMAZ: görsel yüklemez (mobile_asset_create), gizli bilgi (Apple/Google hesabı, sertifika, keystore, demo parolası) yazmaz — Studio › Yayın › Hesaplar. Yanıt: güncel kayıt + changed (değişen ayar yolları) + declared (gönderilen beyanlar) + bundleId.",
+        inputSchema: {
+            applicationId,
+            settings: settingsPatch.optional().describe("Değişecek alanlar; ör. { bundleIdentifier: 'com.firma.app', listing: { tr: { title: 'Uygulama' } } }"),
+            declarations: z.object(Object.fromEntries(DECLARATION_KEYS.map(key => [key, z.boolean().optional()]))).strict().optional()
+                .describe('Beyan anahtarı → işaretli mi. YALNIZ kullanıcının onayıyla true; ör. { appPrivacy: true }'),
+            registerAppleBundleId: z.literal(true).optional().describe("true: bundleIdentifier'ı App Store Connect'e kaydeder (P-04)"),
+            policyOverride: z.boolean().optional().describe('MOB-022 block bulgusunu uyarıya indirir; backend kuralı yine uygular')
+        },
+        annotations: updates
+    }, handle(config, async ({ applicationId: appId, settings: requested, declarations, registerAppleBundleId, policyOverride }) => {
+        const declared = Object.fromEntries(Object.entries(declarations ?? {}).filter(([, value]) => typeof value === 'boolean'));
+        if (requested === undefined && Object.keys(declared).length === 0 && !registerAppleBundleId) {
+            throw new PlatformApiError('mobile_store_update: settings, declarations ya da registerAppleBundleId\'den en az biri verilir — hiçbir şey yazılmadı. Ayar için settings yaması, beyan için declarations ({ appPrivacy: true }), Apple kaydı için registerAppleBundleId: true.', 400);
+        }
+        // Kayıt hiç yazılmamışsa backend varsayılan kimliği (`MobileStoreSettings.CreateDefault`) Apple'a
+        // kaydeder (`MobileStoreSecretService.RegisterBundleIdAsync`) — API'den silinemeyen dış kayıt.
+        if (registerAppleBundleId && requested?.bundleIdentifier === undefined) {
+            const before = unwrap(await platform.org('GET', `/mobile-store/${appId}`));
+            if (before.persisted !== true) {
+                throw new PlatformApiError(`mobile_store_update: registerAppleBundleId reddedildi — mağaza kaydı hiç yazılmamış, kayıttaki bundleIdentifier ('${String(isObject(before.settings) ? before.settings.bundleIdentifier : '')}') otomatik VARSAYILANDIR ve Apple'daki kayıt API'den silinemez. Kimliği önce onaylayın: aynı çağrıya settings: { bundleIdentifier } ekleyin ya da önce settings yazın. Hiçbir şey yazılmadı.`, 400);
+            }
+        }
+        // Adımlar ayrı uçlardır, işlem yok: sonraki adım düşerse yazılmış olanlar yanıtta kalır, hata
+        // `<adım>Error` ile döner (41 §9 — "hiçbir şey yazılmadı" sanılmasın).
+        const written = [];
+        let result = requested === undefined ? {} : await writeSettings(platform, config, appId, requested, policyOverride);
+        if (requested !== undefined)
+            written.push('settings');
+        const steps = [
+            ...(Object.keys(declared).length > 0
+                ? [['declarations', async () => ({ ...storeSummary(unwrap(await platform.org('PUT', `/mobile-store/${appId}/declarations`, { body: { declarations: declared } }))), declared })]]
+                : []),
+            ...(registerAppleBundleId
+                ? [['bundleId', async () => ({ bundleId: unwrap(await platform.org('POST', `/mobile-store/${appId}/ios/bundle-id`)) })]]
+                : [])
+        ];
+        for (const [step, run] of steps) {
+            try {
+                result = { ...result, ...await run() };
+                written.push(step);
+            }
+            catch (error) {
+                if (written.length === 0 || !(error instanceof PlatformApiError))
+                    throw error;
+                return { ...result, [`${step}Error`]: error.message, note: `${written.join(' + ')} YAZILDI; ${step} yazılamadı (ayrıntı ${step}Error) ve sonraki adımlar denenmedi. Yalnız kalan parçayla yeniden çağırın.` };
+            }
+        }
+        return result;
+    }));
+    server.registerTool('mobile_build_start', {
+        title: 'Mobil derleme başlat',
+        description: "Mobil uygulama için derleme işi açar (POST mobile-builds { platform, target }). Önce ön kontrolü okur (GET mobile-store/{appId}/preflight — Studio'nun Yayımla düğmesiyle aynı liste: ayar, görsel, gizli bilgi, App Store Connect / Play erişimi, production sayfası, etkin iş, çevrimiçi runner, beyanlar); bir satır bile 'fail' ise iş BAŞLATILMAZ ve fail satırları kod + öneriyle hata olarak döner. dryRun:true yalnız ön kontrolü döner, iş açmaz — yayından önce bununla bakın. Hedef–platform: build her ikisinde, testflight yalnız ios, internal yalnız android. Tuzak: her başlatma derleme numarasını AYIRIR ve ilk başlatma kimlik alanlarını kilitler; iptal ya da hata numarayı geri vermez. Aynı platformda etkin iş varsa 409. İş asenkrondur: mobile_build_status ile izleyin. Derlenen uygulama production ortamını okur — yükleme hedeflerinde açılış sayfası production'a dağıtılmış olmalı (P-06 fail); yalın build'de P-06 yalnız uyarıdır.",
+        inputSchema: {
+            applicationId,
+            platform: mobilePlatform,
+            target: buildTarget.optional(),
+            runnerScope: z.enum(['dedicated', 'shared']).optional()
+                .describe("dedicated: organizasyonun kendi runner'ı · shared: platformun ortak runner'ı. Verilmezse backend seçer (çevrimiçi dedicated varsa o, yoksa shared). Ön kontrol P-09 kapsamdan bağımsızdır; verilen kapsamda çevrimiçi runner yoksa iş hiç alınmaz ve numara yanardı — gateway bunu POST'tan önce durdurur. Durum: mobile_store_get { detail: ['runners'] }"),
+            dryRun: z.boolean().optional().describe('true: yalnız ön kontrol; iş açılmaz, numara ayrılmaz')
+        },
+        annotations: writes
+    }, handle(config, async ({ applicationId: appId, platform: mobile, target, runnerScope, dryRun }) => {
+        const resolvedTarget = target ?? 'build';
+        const allowed = { ios: ['build', 'testflight'], android: ['build', 'internal'] }[mobile];
+        if (!allowed.includes(resolvedTarget)) {
+            throw new PlatformApiError(`mobile_build_start: '${resolvedTarget}' hedefi ${mobile} için yok — ${mobile} yalnız ${allowed.join(' | ')} alır (testflight iOS'un, internal Android'in yükleme hedefidir). Hiçbir iş açılmadı.`, 400);
+        }
+        const preflight = unwrap(await platform.org('GET', `/mobile-store/${appId}/preflight`, { query: { platform: mobile, target: resolvedTarget } }));
+        const checks = Array.isArray(preflight.checks) ? preflight.checks.filter(isObject) : [];
+        const open = checks.filter(check => check.status !== 'ok');
+        const scopeProblem = runnerScope ? await runnerScopeProblem(platform, mobile, runnerScope) : undefined;
+        if (dryRun) {
+            return { dryRun: true, platform: mobile, target: resolvedTarget, ready: preflight.ready, blocked: preflight.blocked, checks: open, okCount: checks.length - open.length, ...(scopeProblem ? { runnerScopeProblem: scopeProblem } : {}) };
+        }
+        if (scopeProblem)
+            throw new PlatformApiError(`mobile_build_start: ${scopeProblem} İş BAŞLATILMADI, derleme numarası ayrılmadı.`, 422, 'runner_scope_offline');
+        const failed = checks.filter(check => check.status === 'fail');
+        if (failed.length > 0) {
+            throw new PlatformApiError([
+                `mobile_build_start: ön kontrol ${failed.length} satırda 'fail' — iş BAŞLATILMADI, derleme numarası ayrılmadı (Studio'nun Yayımla düğmesiyle aynı kapı):`,
+                ...failed.map(check => `- ${String(check.id)} ${String(check.code)}: ${String(check.message ?? '')}${check.fixHint ? ` → ${String(check.fixHint)}` : ''}`),
+                "Ayar satırları ve beyanlar mobile_store_update ile, görseller mobile_asset_create ile, Apple bundle ID'si (P-04) mobile_store_update { registerAppleBundleId: true } ile; gizli bilgi satırları Studio › Yayın › Hesaplar'da düzeltilir. Tam liste: mobile_build_start { dryRun: true }."
+            ].join('\n'), 422, 'preflight_failed');
+        }
+        const job = unwrap(await platform.org('POST', '/mobile-builds', { body: { applicationId: appId, platform: mobile, target: resolvedTarget, ...(runnerScope ? { runnerScope } : {}) } }));
+        const warnings = checks.filter(check => check.status === 'warn' || check.status === 'manual');
+        return {
+            ...buildSummary(job, new Date().toISOString()),
+            ...(warnings.length > 0 ? { preflightWarnings: warnings.map(check => `${String(check.id)} ${String(check.code)}: ${String(check.message ?? '')}`) } : {})
+        };
+    }));
+    server.registerTool('mobile_build_status', {
+        title: 'Mobil derleme durumu',
+        description: "buildId verilirse o işin durumunu döner (GET mobile-builds/{id}): status (queued | running | completed | failed | cancelled), stage (claimed → preparing → building → signing → uploading → store_processing), aşama başına süre (seconds), toplam süre, version + buildNumber, error { code, message, hint }, storeResult (testflight: testflightBuildId, processingState, listingError + listingMessage — derleme TestFlight'ta ama mağaza metni/görselleri reddedildi, iş yine tamamlanır; internal: versionCode, releaseStatus) ve awaitingStore (TestFlight işleme yoklaması — runner işten çıkmıştır, iş Apple VALID deyince completed olur, en çok 60 dk). Yalnız applicationId verilirse uygulamanın son işlerini özetle listeler (en yeni önce, ≤ 50). Hata kodunun önerisi platform_guide('mobile-publish', 'hata-kodlari') bölümündedir.",
+        inputSchema: {
+            buildId: buildId.optional(),
+            applicationId: applicationId.optional()
+        },
+        annotations: readOnly
+    }, handle(config, async ({ buildId: id, applicationId: appId }) => {
+        if ((id === undefined) === (appId === undefined)) {
+            throw new PlatformApiError("mobile_build_status: buildId ya da applicationId'den TAM OLARAK biri verilir — buildId tek işin ayrıntısını, applicationId son işlerin listesini döner.", 400);
+        }
+        const now = new Date().toISOString();
+        if (id)
+            return buildSummary(unwrap(await platform.org('GET', `/mobile-builds/${id}`)), now);
+        const payload = await platform.org('GET', '/mobile-builds', { query: { applicationId: appId } });
+        const jobs = Array.isArray(payload?.data) ? payload.data.filter(isObject) : [];
+        return {
+            applicationId: appId,
+            count: jobs.length,
+            builds: jobs.map(job => ({ id: job.id, platform: job.platform, target: job.target, status: job.status, stage: job.stage, buildNumber: job.buildNumber, version: job.version, errorCode: isObject(job.error) ? job.error.code : undefined, createdAt: job.createdAt, finishedAt: job.finishedAt })),
+            ...(jobs.length === 0 ? { note: 'Bu uygulamada hiç derleme işi yok — çağrı BAŞARILI, sonuç boş. Başlatmak için mobile_build_start.' } : {})
+        };
+    }));
+    server.registerTool('mobile_build_log', {
+        title: 'Mobil derleme günlüğü',
+        description: "Derleme işinin günlüğünü artımlı okur (GET mobile-builds/{id}/log?after=). after verilen sıra numarasından SONRAKİ satırlar gelir (ilk çağrıda 0); yanıttaki nextAfter bir sonraki çağrının after'ıdır, more:true ise okunmamış satır vardır. Satır biçimi '<seq> [<aşama>] <metin>'. Gizli değerler runner'da maskelenmiştir. Hata ayıklarken önce mobile_build_status'un error alanı okunur; günlük ilk hata satırını bulmak içindir.",
+        inputSchema: {
+            buildId,
+            after: z.number().int().min(0).optional().describe('Bu sıra numarasından sonraki satırlar; varsayılan 0 (baştan)'),
+            limit: z.number().int().min(1).max(2000).optional().describe('En çok kaç satır; varsayılan 200')
+        },
+        annotations: readOnly
+    }, handle(config, async ({ buildId: id, after, limit }) => {
+        const from = after ?? 0;
+        const max = limit ?? 200;
+        const log = unwrap(await platform.org('GET', `/mobile-builds/${id}/log`, { query: { after: from } }));
+        const lines = Array.isArray(log.lines) ? log.lines.filter(isObject) : [];
+        const shown = lines.slice(0, max);
+        const last = shown.at(-1);
+        return {
+            buildId: id,
+            lines: shown.map(line => `${String(line.seq)} [${String(line.stage ?? '-')}] ${String(line.line ?? '')}`),
+            nextAfter: last ? Number(last.seq) : from,
+            more: lines.length > shown.length || lines.length >= LOG_PAGE_LIMIT
+        };
+    }));
+    server.registerTool('mobile_build_cancel', {
+        title: 'Mobil derlemeyi iptal et',
+        description: "Derleme işini iptal eder (POST mobile-builds/{id}/cancel). queued iş hemen cancelled olur; running işte cancelRequested işaretlenir ve runner bir sonraki kalp atışında (≤ 30 sn) durur — sonucu mobile_build_status ile okuyun. Geri alınamaz: ayrılan derleme numarası yanar (mağaza aynı numarayı ikinci kez kabul etmez). TestFlight işleme yoklamasındaki (awaitingStore) ya da bitmiş iş iptal edilemez: 409.",
+        inputSchema: { buildId },
+        annotations: destructive
+    }, handle(config, async ({ buildId: id }) => buildSummary(unwrap(await platform.org('POST', `/mobile-builds/${id}/cancel`)), new Date().toISOString())));
+    server.registerTool('mobile_asset_create', {
+        title: 'Mağaza görseli yükle',
+        description: `Mağaza görselini yükler (POST mobile-store/{appId}/assets, multipart). Kaynak path (gateway'in okuyabildiği yerel dosya) ya da base64 content'tir — dosya ajanın bağlamına girmez. Yuvalar: derleme görselleri icon (1024×1024 PNG, alfasız), adaptiveForeground / adaptiveBackground / adaptiveMonochrome (1024×1024 PNG), splash (≥ 1242×2436 PNG) — dilsizdir, locale verilmez; mağaza görselleri featureGraphic (1024×500, alfasız), promo, screenshot (deviceClass zorunlu, locale önerilir: 'screenshot/tr/iphone69'). Tuzak: screenshot ve promo dışındaki türler TEKLİDİR — yükleme yuvadaki önceki görselin YERİNE geçer ve eskisi silinir. Yuva başına en çok 10 ekran görüntüsü, dosya ≤ 10 MB, PNG ya da JPEG (derleme görseli yalnız PNG). Ölçü, biçim ve alfa backend'de denetlenir; 422 hangi ölçünün beklendiğini söyler. EKRAN GÖRÜNTÜSÜ uygulamanın kendi sayfasından üretilir: önce page_screenshot { environment: 'production', applicationSlug, pageSlug, device, format: 'jpeg', quality: 92, language, colorScheme: 'light', outPath }, sonra bu araç { path: <outPath>, kind: 'screenshot', deviceClass, locale }. Cihaz sınıfı → device: ${captureTable}. JPEG şarttır: iPhone ve iPad ekran görüntüsünde alfa kanalı reddedilir. Giriş/splash ekranını çekmeyin (App Review 2.3.3: uygulama kullanımda gösterilir). Sıra: mobile_asset_update; silme: mobile_asset_delete; liste: mobile_store_get { detail: ['assets'] }.`,
+        inputSchema: {
+            applicationId,
+            path: z.string().min(1).optional().describe("Gateway sürecinin okuyabildiği yerel PNG/JPEG yolu (page_screenshot outPath'i); content ile birlikte verilmez"),
+            content: z.string().min(1).optional().describe('Base64 görsel içeriği; path ile birlikte verilmez'),
+            filename: z.string().min(1).optional().describe("Dosya adı; verilmezse path'in adı ya da '<kind>.png|jpg'"),
+            kind: z.enum(ASSET_KINDS),
+            locale: z.string().optional().describe("Mağaza görselinin dili ('tr', 'en-US'); derleme görselinde verilmez"),
+            deviceClass: z.enum(DEVICE_CLASSES).optional().describe("Yalnız screenshot: iphone69 (iPhone 6.9\"), ipad13 (iPad 13\"), phone, tablet7, tablet10 (Play)")
+        },
+        // Tekli yuvada önceki görsel ve dosyası silinir (`MobileStoreService.UploadAssetAsync`): geri alınamaz.
+        // Ekran görüntüsü eklendiği için idempotent değildir.
+        annotations: { ...writes, destructiveHint: true }
+    }, handle(config, async ({ applicationId: appId, path, content, filename, kind, locale, deviceClass }) => {
+        // Backend boş dili null sayar (`MobileStoreService.UploadAssetAsync`); data URL öneki base64 değildir.
+        const slotLocale = locale?.trim() ? locale.trim() : undefined;
+        const problem = assetSlotProblem(kind, slotLocale, deviceClass);
+        if (problem)
+            throw new PlatformApiError(`mobile_asset_create: ${problem}. Hiçbir şey yüklenmedi.`, 400);
+        const file = await readAsset(kind, path, content?.replace(/^data:[^,]*;base64,/, ''), filename);
+        const asset = unwrap(await platform.org('POST', `/mobile-store/${appId}/assets`, {
+            multipart: [
+                { name: 'file', filename: file.name, contentType: file.contentType, content: file.bytes },
+                { name: 'kind', value: kind },
+                ...(slotLocale === undefined ? [] : [{ name: 'locale', value: slotLocale }]),
+                ...(deviceClass === undefined ? [] : [{ name: 'deviceClass', value: deviceClass }])
+            ]
+        }));
+        return { ...assetSummary(asset), ...(kind === 'screenshot' || kind === 'promo' ? {} : { note: `'${kind}' tekli yuvadır: varsa önceki görsel silindi.` }) };
+    }));
+    server.registerTool('mobile_asset_update', {
+        title: 'Mağaza görsellerini sırala',
+        description: "Bir yuvadaki görsellerin sırasını yazar (PUT mobile-store/{appId}/assets/order): dizideki sıra mağazadaki gösterim sırası olur (ilk ekran görüntüsü mağazada önce görünür). assetIds TEK yuvanın (ör. 'screenshot/tr/iphone69') BÜTÜN görsellerini içerir — backend her id'ye dizideki indeksini yazar ve yuvayı denetlemez; eksik liste ya da iki yuvanın karışımı sessizce çakışan sıra üretirdi, bu yüzden gateway istek gitmeden kaydı okur ve bunları durdurur. Id'ler: mobile_store_get { detail: ['assets'] }.",
+        inputSchema: {
+            applicationId,
+            assetIds: z.array(guid).min(1).describe('Yuvanın bütün görsel id\'leri, istenen sırada')
+        },
+        annotations: updates
+    }, handle(config, async ({ applicationId: appId, assetIds }) => {
+        const current = unwrap(await platform.org('GET', `/mobile-store/${appId}`));
+        const assets = Array.isArray(current.assets) ? current.assets.filter(isObject) : [];
+        const unknown = assetIds.filter(id => !assets.some(asset => asset.id === id));
+        const slots = [...new Set(assets.filter(asset => assetIds.includes(String(asset.id))).map(slotOf))];
+        const missing = slots.length === 1 ? assets.filter(asset => slotOf(asset) === slots[0] && !assetIds.includes(String(asset.id))).map(asset => asset.id) : [];
+        if (unknown.length > 0 || slots.length !== 1 || missing.length > 0 || new Set(assetIds).size !== assetIds.length) {
+            throw new PlatformApiError([
+                'mobile_asset_update: sıra yazılmadı —',
+                unknown.length > 0 ? `uygulamada olmayan id: ${unknown.join(', ')};` : '',
+                slots.length > 1 ? `id'ler ${slots.length} yuvaya dağılıyor (${slots.join(', ')}) — tek yuva verin;` : '',
+                missing.length > 0 ? `'${slots[0]}' yuvasının şu görselleri eksik: ${missing.join(', ')} — yuvanın tamamı verilir;` : '',
+                new Set(assetIds).size !== assetIds.length ? 'aynı id iki kez verilmiş;' : '',
+                "güncel liste: mobile_store_get { detail: ['assets'] }."
+            ].filter(Boolean).join(' '), 400);
+        }
+        const ordered = list(await platform.org('PUT', `/mobile-store/${appId}/assets/order`, { body: { assetIds } }));
+        return { applicationId: appId, slot: slots[0], assets: ordered.filter(asset => slotOf(asset) === slots[0]).map(assetSummary) };
+    }));
+    server.registerTool('mobile_asset_delete', {
+        title: 'Mağaza görselini sil',
+        description: "Mağaza görselini siler (DELETE mobile-store/{appId}/assets/{assetId}); dosya depodan da silinir, geri alınamaz. Derleme görseli (icon, splash, adaptive*) silinirse ön kontrol ilgili satırı fail'e çevirir. Tekli yuvadaki görseli değiştirmek için silmek gerekmez — mobile_asset_create yerine geçer. Id: mobile_store_get { detail: ['assets'] }.",
+        inputSchema: {
+            applicationId,
+            assetId: guid.describe("Görselin id'si (mobile_store_get { detail: ['assets'] })")
+        },
+        annotations: destructive
+    }, handle(config, async ({ applicationId: appId, assetId }) => {
+        await platform.org('DELETE', `/mobile-store/${appId}/assets/${assetId}`);
+        return { applicationId: appId, deleted: assetId };
+    }));
+}

package/dist/tools/modules.js

@@ -0,0 +1,48 @@
+import { guid, projectParam, environmentParam, readOnly, writes } from './common.js';
+import { PolicyBlockError } from '../knowledge/policy.js';
+import { handle } from '../platform/responses.js';
+import { z } from 'zod';
+export function registerModuleTools(server, platform) {
+    const config = platform.config;
+    server.registerTool('module_list', {
+        title: 'Sistem modüllerini listele',
+        description: "Kurulabilir sistem modülleri (catalog: slug, name, version, requires) ve bu ortamdaki kurulumlar (installations: module, version, catalogVersion, applicationId, receiveUpdates, isOutdated). Katalogda iki modül var: access (yetki modülü, kompleks proje ister) ve bpm-management (süreç yönetimi: süreç sayfaları ve iş takvimi). requires dolu bir modül, gerektirdiği modül aynı application'a kurulmadan kurulamaz.",
+        inputSchema: {
+            project: projectParam,
+            environment: environmentParam,
+            module: z.string().min(1).max(100).optional().describe('Yalnız bu modülün kurulumları')
+        },
+        annotations: readOnly
+    }, handle(config, async ({ project, environment, module }) => {
+        const [catalog, installations] = await Promise.all([
+            platform.tenant('GET', project, '/modules/catalog', { environment }),
+            platform.tenant('GET', project, '/modules', { environment, query: module ? { module } : undefined })
+        ]);
+        return {
+            catalog: catalog?.data ?? catalog,
+            installations: installations?.data ?? installations
+        };
+    }));
+    server.registerTool('module_update', {
+        title: 'Sistem modülünü kur, güncelle ya da ayır',
+        description: "operation install: modülü application'a kurar — süreç paketi tablolarını (yoksa), iş takvimlerini ve süreç tanımlarını getirir, süreçler o application'da aktif yayınlanır; gereken modül kurulu değilse 409 ModuleRequiresModule, ikinci kurulum 409 ModuleAlreadyInstalled. operation upgrade: katalog sürümü yeniyse içeriği yeniden kurar; değişen süreç yeni sürüm olarak yayınlanır ve müşterinin uyarlaması yeni sürüme taşınır (taşınamayan adım çakışma bildirimi olur). Var olan tablo ve verisine dokunulmaz — yeni paket sürümünün bir tabloya eklediği alan var olan tabloya eklenmez. operation detach: güncellemeleri keser, içerik ve çalışan örnekler yerinde kalır; ayırma geri alınmaz (ardından install 409 ModuleAlreadyInstalled, upgrade 400 döner). access modülünün kurulumu yalnız kaydı tutar, içerik getirmez (TB-92). production'a kurulum gateway'de durur (BPM-014): development'ta kurup deployment ile taşıyın.",
+        inputSchema: {
+            project: projectParam,
+            environment: environmentParam,
+            operation: z.enum(['install', 'upgrade', 'detach']),
+            module: z.string().min(1).max(100),
+            applicationId: guid
+        },
+        annotations: writes
+    }, handle(config, async ({ project, environment, operation, module, applicationId }) => {
+        if ((environment ?? config.defaultEnvironment) === 'production') {
+            throw new PolicyBlockError([{
+                    ruleId: 'BPM-014',
+                    severity: 'block',
+                    message: `module_update: modül ${operation} production'a gönderilmez. Modülü development'ta kurun; production'a taşıma insan onaylı deployment işidir (tanım ve takvim taşınır, uyarlama taşınmaz).`,
+                    guide: 'ngapps://guides/bpm'
+                }], false);
+        }
+        return platform.tenant('POST', project, `/modules/${encodeURIComponent(module)}/${operation}`, { environment, body: { applicationId } });
+    }));
+}