@appaflytech/zeyrek-ai-mcp 0.0.43 → 0.0.45

package/dist/tools/mobileStore.js

@@ -7,19 +7,30 @@ 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, adsStoreWarnings, trackingDeclarationWarnings, assetSlotProblem, changedStoreFields, mergeStoreSettings, permissionLaunchShellWarnings, permissionStoreBuildWarnings } from '../knowledge/mobileStore.js';
+import { APPLE_RELEASE_TYPES, ASSET_KINDS, BUILD_ASSET_KINDS, DECLARATION_KEYS, DEVICE_CLASSES, MAX_ASSET_BYTES, ORIENTATIONS, PLAY_TRACKS, RELEASE_STATUSES, SCREENSHOT_CAPTURE_DEVICES, SPLASH_RESIZE_MODES, USER_INTERFACE_STYLES, adsStoreWarnings, trackingDeclarationWarnings, assetSlotProblem, changedStoreFields, mergeStoreSettings, permissionLaunchShellWarnings, permissionLockShellWarnings, 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.
+ * 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");
 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");
+/**
+ * Mağaza yayın hedefleri (b-24): önceki hedefin derlemesini incelemeye/mağazaya/kanala taşır. Geri dönüşsüz ya da
+ * insan onaylıdır; MCP yalnız ön kontrolünü okur (`docs/adr/0002-mobil-yayin-gorsel-ve-beyan.md` §Ek 2026-10-10).
+ */
+const RELEASE_TARGETS = ['app-store-review', 'app-store-release', 'play-promote'];
+/**
+ * Ön kontrolün kapsamı (backend ADR 0032): `store` mağazaya giden işin bütün kuralları, `test` yalnız TestFlight / Play iç
+ * test yüklemesinin istedikleri. Ortam yalnız `test` ile seçilir; yükseltme hedefi kaynağı production işinden taşır.
+ */
+const PREFLIGHT_SCOPES = ['store', 'test'];
+const PLATFORM_TARGETS = { ios: ['build', 'testflight', 'app-store-review', 'app-store-release'], android: ['build', 'internal', 'play-promote'] };
+const buildTarget = z.enum(['build', 'testflight', 'internal', ...RELEASE_TARGETS])
+    .describe("build: yalnız derler (mağazaya gitmez) · testflight: iOS'ta TestFlight'a yükler · internal: Android'de Play iç test kanalına yükler · app-store-review (iOS, son TestFlight derlemesini incelemeye gönderir) · app-store-release (iOS, onaylanan sürümü yayınlar) · play-promote (Android, iç test derlemesini releaseTrack kanalına taşır) — bu üçü YALNIZ dryRun ile: gerçek gönderim Studio › Yayınla'da insan onayıyla. Varsayılan build");
 const listingSchema = z.object({
     title: z.string().optional().describe('≤ 30'),
     subtitle: z.string().optional().describe('≤ 30 (iOS)'),
@@ -46,6 +57,8 @@ const settingsPatch = z.object({
     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'] }"),
+    notificationReminder: z.enum(['off', 'daily']).optional().describe("Mağaza kabuğunda bildirim izni hatırlatması (kök K11): off (varsayılan) ya da daily — izin verilmemiş kullanıcıya uygulama öne gelince günde EN ÇOK BİR kez ince bir şerit çıkar. Manifest alanı yalnız daily için yazılır ve BİR SONRAKİ MAĞAZA SÜRÜMÜYLE etkili olur; push kapalıysa şerit hiç çıkmaz"),
+    releaseTargets: z.object({ ios: z.boolean(), android: z.boolean() }).strict().optional().describe("Bu sürümün gittiği mağazalar (kök K15). İKİSİ DE false kaydedilemez (422 releaseTargets). Kapalı platformun ön kontrolü tek satır 'skipped' döner (P-00 platform_disabled) ve o platformda iş başlatmak 422 verir: önce mağazayı açın"),
     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(),
@@ -57,12 +70,21 @@ const settingsPatch = 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')
+        copyright: z.string().optional().describe('≤ 200; TestFlight yüklemesinde zorunlu'),
+        releaseType: z.enum(APPLE_RELEASE_TYPES).optional().describe("Onaylanan sürüm ne zaman yayına çıkar: manual (varsayılan; Studio'da 'Mağazada yayınla' ile) · automatic (onay anında, geri dönüşsüz) · scheduled (scheduledAt'te)"),
+        scheduledAt: z.string().nullable().optional().describe("releaseType 'scheduled' için ileri tarih (ISO 8601, UTC)"),
+        phasedRelease: z.boolean().optional().describe('true: otomatik güncellemeler 7 güne yayılır (kademeli yayın)'),
+        pricing: z.string().nullable().optional().describe("'free' ya da Apple fiyat basamağı tier-1…tier-87"),
+        territories: z.array(z.string()).nullable().optional().describe("Satış ülkeleri: tek başına ['all'] ya da ISO 3166 alfa-3 kodları (['TUR', 'DEU']); liste bütün olarak yazılır. Gönderim ülkeleri yalnız EKLER — satıştan kaldırma App Store Connect'te")
     }).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')
+        releaseStatus: z.enum(RELEASE_STATUSES).optional().describe('Play uygulaması taslakken yalnız draft kabul edilir'),
+        contactPhone: z.string().nullable().optional().describe('Mağaza iletişim telefonu, E.164 (+905551112233)'),
+        contactWebsite: z.string().nullable().optional().describe('Mağaza iletişim sitesi, mutlak https://'),
+        promoVideoUrl: z.string().nullable().optional().describe('Tanıtım videosu: https:// YouTube adresi'),
+        rolloutPercent: z.number().int().min(1).max(100).nullable().optional().describe('Üretim kanalına kademeli yayın yüzdesi (1–100; boş = 100, hepsine)')
     }).strict().optional(),
     review: z.object({
         firstName: z.string().optional(),
@@ -84,14 +106,18 @@ const settingsPatch = z.object({
             ios: z.string().nullable().optional().describe('iOS reklam birimi: ca-app-pub-<16 hane>/<10 hane>'),
             android: z.string().nullable().optional().describe('Android reklam birimi: ca-app-pub-<16 hane>/<10 hane>')
         }).strict()).optional().describe('Adlı reklam yerleşimleri (≤ 40); liste bütün olarak yazılır')
-    }).strict().optional().describe('Reklamlar (kök ADR 0012): açıkken izleme izni (tracking) derlemeye girer; manifest kabuk 0.4.0 ister')
+    }).strict().optional().describe('Reklamlar (kök ADR 0012): açıkken izleme izni (tracking) derlemeye girer; manifest kabuk 0.4.0 ister'),
+    appLock: z.object({
+        enabled: z.boolean().optional(),
+        timeoutSeconds: z.number().int().optional().describe('Arka plandan dönünce ne kadar sonra kilitlensin: 0 (hemen) · 60 · 300 · 900 saniye; kapalı küme, dışı 422')
+    }).strict().optional().describe('Uygulama kilidi (kök ADR 0021): açıkken mağaza sürümü soğuk açılışta ve arka planda timeoutSeconds süresinden uzun kalıp dönünce (0: her dönüşte) Face ID / parola ister ve biometric izni derlemeye girer. permissionModes.biometric off iken açılamaz (422). Manifest kabuk 0.6.0 ister; oynatıcıda kilit yoktur')
 }).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'];
+const DETAIL_SECTIONS = ['assets', 'signing', 'runners', 'audit', 'permissions', 'status', 'changes'];
 /** 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) */
@@ -155,7 +181,7 @@ async function readDetail(platform, appId, section, scope) {
             });
             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), ...trackingDeclarationWarnings(entries)];
+            const warnings = [...permissionStoreBuildWarnings(entries, String(view.environment)), ...permissionLaunchShellWarnings(entries, view.shell), ...permissionLockShellWarnings(entries, view.shell), ...trackingDeclarationWarnings(entries)];
             return {
                 permissions: {
                     catalogVersion: view.catalogVersion,
@@ -173,6 +199,10 @@ async function readDetail(platform, appId, section, scope) {
                 ...(devices instanceof PlatformApiError ? { permissionDevicesError: devices.message } : {})
             };
         }
+        if (section === 'status')
+            return { status: unwrap(await platform.org('GET', `/mobile-store/${appId}/store-status`)) };
+        if (section === 'changes')
+            return { changes: unwrap(await platform.org('GET', `/mobile-store/${appId}/changes-since-production`)) };
         if (section === 'signing') {
             const [credentials, accounts] = await Promise.all([
                 platform.org('GET', `/mobile-store/${appId}/credentials`),
@@ -310,7 +340,11 @@ function buildSummary(job, now) {
         elapsedSeconds: seconds(job.startedAt ?? job.createdAt, end),
         version: job.version,
         buildNumber: job.buildNumber,
+        environment: job.environment,
         runnerScope: job.runnerScope,
+        runnerKind: job.runnerKind,
+        packageType: job.packageType,
+        releaseTrack: job.releaseTrack,
         cancelRequested: job.cancelRequested,
         awaitingStore: job.status === 'running' && job.stage === 'store_processing',
         error: job.error,
@@ -326,11 +360,11 @@ 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); settings.ads reklam ayarıdır (kök ADR 0012: enabled, App ID'ler, testMode, consentForm, appOpenUnit, units[] = adBanner.unit ve ad-show.value'nun andığı yerleşimler) ve reklam açıkken adsWarnings döner (MOB-026: test kipi, platformda birimsiz yerleşim, konsol beyanları). 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.",
+        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); settings.ads reklam ayarıdır (kök ADR 0012: enabled, App ID'ler, testMode, consentForm, appOpenUnit, units[] = adBanner.unit ve ad-show.value'nun andığı yerleşimler) ve reklam açıkken adsWarnings döner (MOB-026: test kipi, platformda birimsiz yerleşim, konsol beyanları); settings.appLock uygulama kilididir (kök ADR 0021: enabled, timeoutSeconds 0·60·300·900). 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, shell.carriesAppLock false ise açık uygulama kilidi o kabukta yoktur — permissionWarnings söyler), 'status' mağaza durumunu (GET store-status: apple { state, appStoreState, versionString, releaseType, phased* }, play.tracks[] { track, status, versionCodes, rolloutPercent }, actions[] { platform, target, track, irreversible, consequence } — Studio › Yayınla'daki yayın düğmeleri; irreversible:true geri alınamaz, eylemi MCP başlatmaz, kullanıcıya consequence'ı söyleyip Studio'ya yönlendirin), 'changes' son production dağıtımından beri değişenleri iki kovada (GET changes-since-production: live — dağıtımla telefonlara gider, mağaza gerekmez; store — izin/kimlik/görsel gibi yeni mağaza sürümü isteyenler). 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)"),
+            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), 'status' (mağaza durumu + yayın eylemleri), 'changes' (canlıya al kovaları: live | store)"),
             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")
         },
@@ -405,28 +439,56 @@ export function registerMobileStoreTools(server, platform) {
     }));
     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.",
+        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; iOS yükleme hedeflerinde App Review satırları P-15…P-21, yayın hedeflerinde kaynak derleme P-22); bir satır bile 'fail' ise iş BAŞLATILMAZ ve fail satırları kod + öneriyle hata olarak döner ('manual' satırlar başlatmayı engellemez, kullanıcıya söylenir). dryRun:true yalnız ön kontrolü döner, iş açmaz — yayından önce bununla bakın. Hedef–platform: build her ikisinde, testflight ve app-store-review/app-store-release yalnız ios, internal ve play-promote yalnız android. Mağaza yayın hedefleri (app-store-review, app-store-release, play-promote + releaseTrack closed|production) geri dönüşsüz ya da insan onaylıdır: YALNIZ dryRun ile kabul edilir, gerçek gönderim Studio › Yayınla'dadır; mağaza durumu ve sıradaki eylem mobile_store_get { detail: ['status'] }. packageType: aab (varsayılan) | apk — APK yalnız android build'de (mağazaya gitmez, telefona kurulur). Runner: runnerScope verilmezse backend seçer — kurumun kendi Mac'i çevrimiçiyse dedicated, değilse Zeyrek'in ortak runner'ı (shared): kurumun kendi Mac'i yoksa iş Zeyrek'in runner'ına düşer; yanıtta runnerKind own | zeyrek. runnerId işi kullanıcının o Mac'ine ayırır (runnerScope gerekmez — iş dedicated kapsamında o runner'ı bekler; kullanıcının birden çok çevrimiçi Mac'i varken işin hangisine düşeceğini sabitler): runner kurumun kendi runner'ı değilse, platformu desteklemiyorsa ya da isteyene derleyemiyorsa 404 döner, runnerScope: 'shared' ile birlikte 400 döner — ikisinde de numara ayrılmaz; çevrimdışı Mac reddedilmez, iş onu bekler. runnerId verilmezse iş eskisi gibi ayrılmaz (kapsamdaki ilk yoklayan runner alır). Bu araç Cihazda dene önizlemesini başlatmaz (önizleme görevi, kod ve davet kullanıcının Studio'daki işidir). 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. Ortam: environment (ad ya da slug; boş = production) derlemenin içeriğini o ortamdan alır — development, production ya da hazır bir dal; yalnız build | testflight | internal'da verilir, yükseltme hedefinde gateway reddeder: mağazaya yalnız production işinin derlemesi gider, development/dal test derlemesi asla yükseltilemez. Ön kontrolün kapsamı scope: 'store' (varsayılan; mağazaya giden işin bütün kuralları) | 'test' (Yayınla 3 · Test sürümü: yalnız TestFlight / Play iç testin istedikleri — kimlik, hesap ve imza, konsolda uygulama kaydı, seçilen ortamda açılış sayfası, runner; metin, görsel, beyan ve App Review satırları sorulmaz); environment verilince scope 'test' olur, 'store' ile birlikte reddedilir; scope işe yazılmaz. Derlenen uygulama işin ortamını okur — yükleme hedeflerinde açılış sayfası o ortamda olmalı (P-06 fail; production'da dağıtılmış olmalı); yalın build'de P-06 yalnız uyarıdır. Yanıt işin environment'ını taşı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'] }"),
+            runnerId: guid.optional().describe("İşi bu runner'a ayırır — kurumun kendi Mac'i (mobile_store_get { detail: ['runners'] } → runners.dedicated[].id). Verilmezse iş ayrılmaz"),
+            packageType: z.enum(['aab', 'apk']).optional().describe("Android paketi: aab (varsayılan, mağaza paketi) · apk (yalnız android build — telefona doğrudan kurulur, mağazaya gitmez; indirme bağlantısı Studio'da)"),
+            releaseTrack: z.enum(PLAY_TRACKS).optional().describe("Yalnız play-promote: closed (kapalı test) | production (herkese; play.rolloutPercent kadar). play-promote zaten yalnız dryRun ile kabul edilir"),
+            environment: z.string().trim().min(1).optional()
+                .describe("Derlemenin içeriğinin alındığı ortam (ad ya da slug: 'development', 'production', hazır dal). Boş = production. Yalnız build | testflight | internal; verilince ön kontrol scope 'test' ile o ortamda sorar. Yalnız production derlemesi sonradan mağazaya yükseltilebilir"),
+            scope: z.enum(PREFLIGHT_SCOPES).optional()
+                .describe("Ön kontrol kapsamı: store (varsayılan, mağazaya giden işin bütün kuralları) | test (yalnız TestFlight / Play iç test yüklemesinin istedikleri; yükseltme hedefinde verilmez). İşe yazılmaz"),
             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 }) => {
+    }, handle(config, async ({ applicationId: appId, platform: mobile, target, runnerScope, runnerId, packageType, releaseTrack, environment, scope, dryRun }) => {
         const resolvedTarget = target ?? 'build';
-        const allowed = { ios: ['build', 'testflight'], android: ['build', 'internal'] }[mobile];
+        const allowed = PLATFORM_TARGETS[mobile];
+        const promotion = RELEASE_TARGETS.includes(resolvedTarget);
         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);
+            throw new PlatformApiError(`mobile_build_start: '${resolvedTarget}' hedefi ${mobile} için yok — ${mobile} yalnız ${allowed.join(' | ')} alır (testflight ve app-store-* iOS'un, internal ve play-promote Android'in hedefidir). Hiçbir iş açılmadı.`, 400);
+        }
+        if (releaseTrack !== undefined && resolvedTarget !== 'play-promote') {
+            throw new PlatformApiError(`mobile_build_start: releaseTrack yalnız 'play-promote' hedefinde verilir ('${resolvedTarget}' kanal seçmez). Hiçbir iş açılmadı.`, 400);
+        }
+        if (packageType === 'apk' && !(mobile === 'android' && resolvedTarget === 'build')) {
+            throw new PlatformApiError(`mobile_build_start: packageType 'apk' yalnız android build'de — APK mağazaya gitmez (Play AAB ister, iOS paketi IPA'dır). Mağaza hedefi için packageType'ı bırakın ya da 'aab' verin. Hiçbir iş açılmadı.`, 400);
+        }
+        if (environment !== undefined && promotion) {
+            throw new PlatformApiError(`mobile_build_start: environment yalnız build | testflight | internal hedefinde verilir — '${resolvedTarget}' yeni derleme yapmaz, production işinin derlemesini mağazaya taşır; development ya da dal test derlemesi yükseltilemez. environment'ı bırakın. Hiçbir iş açılmadı.`, 400, 'environment_on_promotion');
+        }
+        if (scope === 'test' && promotion) {
+            throw new PlatformApiError(`mobile_build_start: scope 'test' yalnız build | testflight | internal hedefinde verilir — '${resolvedTarget}' mağazaya giden iştir ve bütün mağaza kurallarını (scope 'store') sorar. scope'u bırakın. Hiçbir iş açılmadı.`, 400, 'scope_on_promotion');
+        }
+        if (environment !== undefined && scope === 'store') {
+            throw new PlatformApiError(`mobile_build_start: environment yalnız scope 'test' ile verilir — 'store' ön kontrolü mağazaya giden işi production'da sorar. scope'u bırakın (environment verilince 'test' olur) ya da environment'ı kaldırın. Hiçbir iş açılmadı.`, 400, 'environment_outside_test');
+        }
+        const resolvedScope = scope ?? (environment !== undefined ? 'test' : undefined);
+        // Geri dönüşsüz ya da insan onaylı gönderim (b-24): ajan yalnız ön kontrolü okur, POST hiç gitmez.
+        if (promotion && !dryRun) {
+            throw new PlatformApiError(`mobile_build_start: '${resolvedTarget}' MCP'den başlatılmaz — mağazaya gönderim geri dönüşsüz ya da insan onaylıdır (inceleme, herkese yayın, kanala taşıma). Kullanıcı Studio › Yayınla'da sonucu görüp onaylar. Ön kontrol: aynı çağrı dryRun: true ile; mağaza durumu ve eylemin sonucu: mobile_store_get { detail: ['status'] }. Hiçbir iş açılmadı.`, 400, 'release_target_studio_only');
         }
-        const preflight = unwrap(await platform.org('GET', `/mobile-store/${appId}/preflight`, { query: { platform: mobile, target: resolvedTarget } }));
+        const preflight = unwrap(await platform.org('GET', `/mobile-store/${appId}/preflight`, { query: { platform: mobile, target: resolvedTarget, ...(resolvedScope ? { scope: resolvedScope } : {}), ...(environment ? { environment } : {}) } }));
         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 } : {}) };
+            return { dryRun: true, platform: mobile, target: resolvedTarget, environment: environment ?? 'production', scope: resolvedScope ?? 'store', ...(releaseTrack ? { releaseTrack } : {}), 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');
@@ -438,7 +500,7 @@ export function registerMobileStoreTools(server, platform) {
                 "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 job = unwrap(await platform.org('POST', '/mobile-builds', { body: { applicationId: appId, platform: mobile, target: resolvedTarget, ...(runnerScope ? { runnerScope } : {}), ...(runnerId ? { runnerId } : {}), ...(packageType ? { packageType } : {}), ...(releaseTrack ? { releaseTrack } : {}), ...(environment ? { environment } : {}) } }));
         const warnings = checks.filter(check => check.status === 'warn' || check.status === 'manual');
         return {
             ...buildSummary(job, new Date().toISOString()),
@@ -447,7 +509,7 @@ export function registerMobileStoreTools(server, platform) {
     }));
     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.",
+        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, environment (derlemenin içeriğinin alındığı ortam; yalnız 'production' işi mağazaya yükseltilebilir), 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()
@@ -465,7 +527,7 @@ export function registerMobileStoreTools(server, platform) {
         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 })),
+            builds: jobs.map(job => ({ id: job.id, platform: job.platform, target: job.target, environment: job.environment, 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.' } : {})
         };
     }));
@@ -500,7 +562,7 @@ export function registerMobileStoreTools(server, platform) {
     }, 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'] }.`,
+        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'); reviewAttachment (dilsiz, PNG/JPEG) App Review'a ek görseldir — yalnız app-store-review gönderimine girer. 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"),

package/dist/tools/pages.js

@@ -35,6 +35,8 @@ import { heroTags } from '../knowledge/platform/heroTag.js';
 import { profileLintReadsSavedNodes } from '../knowledge/platform/lint.js';
 import { resolveThemeNative } from '../knowledge/styleResolveNative.js';
 import { boundFlowSteps, pageLayoutWarnings, screenProfileWarnings } from './profileWrite.js';
+import { enforceTextHooks, textHookOverrideParam } from './textHookGuard.js';
+import { overwrittenValues } from '../knowledge/textHooks.js';
 import { applyMobileSpacingDefaults, applyMobileSpacingToOps, emptyMobileSpacingFix, mobileSpacingNote } from '../knowledge/platform/mobileSpacing.js';
 import { shellLessPageSkeleton } from '../knowledge/platform/mobile.js';
 import { z } from 'zod';
@@ -563,15 +565,17 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
                 ...(shot.finalUrl === undefined ? {} : { finalUrl: shot.finalUrl }),
                 ...(shot.pageState === 'ready-no-flows'
                     ? { pageStateNote: 'Runtime çizildi ama hiç mount akışı koşmadı. Sayfa akışsızsa (giriş ekranı) ya da verisi veri kaynağı bağlantısından geliyorsa (connectData prop akış koşturmadan okunur; summaryText satırları gösterir) normaldir; veri bekliyor ve göremiyorsanız page_schema_get ile mount olayına bağlı akışa, bağlı prop için connect_data_get / connect_data_execute (op list) ile bağlantıya bakın.' }
-                    : shot.pageState === 'ready-no-counter'
-                        ? { pageStateNote: 'Runtime koşan akış sayacı yayınlamıyor (eski runtime); hazırlık DOM durulmasından çıkarıldı, akışların bittiği kanıtlanamadı.' }
-                        : shot.pageState === 'error'
-                            ? { pageStateNote: 'Studio sayfa için hata/bulunamadı durumunu çizdi; kare o durumu gösterir. apiStatus ve slug\'ları doğrulayın.' }
-                            : shot.pageState === 'redirected'
-                                ? { pageStateNote: `İstenen adres runtime dışına yönlendi (finalUrl). Route guard ya da Studio giriş ekranı olabilir; kare yönlendirilen sayfayı gösterir.` }
-                                : shot.pageState === 'not-ready'
-                                    ? { pageStateNote: 'TEŞHİS KARESİ (captureUnready): bütçe dolduğunda sayfa hazır değildi; kare iskelet ya da yarım durumu gösterebilir, doğrulama için kullanmayın.' }
-                                    : {}),
+                    : shot.pageState === 'awaiting-user'
+                        ? { pageStateNote: "Bir akış kullanıcı penceresini bekliyor: önizlemenin biyometri penceresi açık (kök ADR 0021). Kare pencereyi gösterir; dalı sürmek için sonraki eylem { action: 'click', target: 'preview-biometric__verify' } (Doğrulandı say) ya da 'preview-biometric__cancel' (vazgeç). Production /view'da pencere yoktur." }
+                        : shot.pageState === 'ready-no-counter'
+                            ? { pageStateNote: 'Runtime koşan akış sayacı yayınlamıyor (eski runtime); hazırlık DOM durulmasından çıkarıldı, akışların bittiği kanıtlanamadı.' }
+                            : shot.pageState === 'error'
+                                ? { pageStateNote: 'Studio sayfa için hata/bulunamadı durumunu çizdi; kare o durumu gösterir. apiStatus ve slug\'ları doğrulayın.' }
+                                : shot.pageState === 'redirected'
+                                    ? { pageStateNote: `İstenen adres runtime dışına yönlendi (finalUrl). Route guard ya da Studio giriş ekranı olabilir; kare yönlendirilen sayfayı gösterir.` }
+                                    : shot.pageState === 'not-ready'
+                                        ? { pageStateNote: 'TEŞHİS KARESİ (captureUnready): bütçe dolduğunda sayfa hazır değildi; kare iskelet ya da yarım durumu gösterebilir, doğrulama için kullanmayın.' }
+                                        : {}),
                 ...(shot.renderWaitTimedOut && shot.pageState === 'not-ready'
                     ? { renderWaitTimedOut: true, note: "Sayfanın veri isteği gözlenmedi — STUDIO_BASE_URL ve slug'ları doğrulayın." }
                     : {}),
@@ -711,7 +715,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
      * kök eklemenin taşınmasını ve `resize_component` planını da koşmuyordu. Emsal: ARC-143, `page-meta.test.ts`
      * "validate = yazma". Regresyon: `test/page-dry-run-parity.test.ts`.
      */
-    const planPageWrite = async (tool, { project, environment, applicationId, pageId, ops, operations, expectedUpdatedAt, allowFlowDeletion }) => {
+    const planPageWrite = async (tool, { project, environment, applicationId, pageId, ops, operations, expectedUpdatedAt, allowFlowDeletion, policyOverride }) => {
         const opened = openBatchEnvelopes(tool, microOps(tool, ops, operations).map(op => op));
         const allOps = opened.ops;
         const removeEventOps = allOps.filter(entry => entry.op === 'remove_event');
@@ -798,6 +802,15 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
         }
         if (rejected.length > 0)
             throw new PlatformApiError(rejectedOpsMessage(rejected, batchIndexHint(opened)), 400);
+        // TR-005 / TR-006: yamanın yükü op'ların EZDİĞİ kayıtlı değerle karşılaştırılır — orada zaten duran kanca eskidir.
+        // Kuru koşu aynı kararı verir (PAGE-049): yazımın durduracağı yamayı o da durdurur.
+        const textFindings = await enforceTextHooks(config, {
+            platform, project, environment, applicationId,
+            after: [...opRecords, ...propTypeOps],
+            before: async () => overwrittenValues((await readPage()).schema, [...opRecords, ...propTypeOps]),
+            hostTree: async () => (await readPage()).schema,
+            where: 'sayfa yaması'
+        }, policyOverride);
         stripGatewayEventFields(opRecords);
         const wantsRootAdd = opRecords.some(entry => entry.op === 'add_component' && (entry.parent === undefined || entry.parent === null || entry.parent === 'root'));
         let retargeted = [];
@@ -923,6 +936,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
             flowWarnings,
             flowsBeforePatch,
             layoutWarnings,
+            textFindings,
             readVersion: () => (typeof cachedPage?.version === 'string' ? cachedPage.version : undefined),
             notes: [
                 ...batchEnvelopeNote(opened),
@@ -941,10 +955,10 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
     server.registerTool('page_schema_validate', {
         title: 'Sayfa şemasını doğrula (kuru çalıştırma)',
         description: "Micro-op'ları kaydetmeden şemaya uygular ve doğrulama hatalarını (suggestions ile) döndürür; page_schema_patch öncesi planı test etmek için. page_schema_patch'in PLANINI koşar (PAGE-049): aynı ön kontroller — yazımın reddedeceği yamayı aynı mesajla, istek göndermeden reddeder — aynı onarım ve platforma aynı gövde; yazımın döneceği uyarılar (layoutWarnings, formWarnings, flowWarnings) burada da görünür.",
-        inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, pageId: guid, ops: opsParam.optional(), operations: opsParam.optional().describe("'ops' ile aynı alan (eşanlamlı) — entity/microservice/workflow patch'leriyle aynı adı kullanabilmeniz için"), allowFlowDeletion: z.boolean().optional().describe('page_schema_patch\'e vereceğiniz değer: true ise akışı referanssız bırakan yama kuru koşuda da reddedilmez. Varsayılan false — yazım onu reddeder, kuru koşu da (G-21).') },
+        inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, pageId: guid, ops: opsParam.optional(), operations: opsParam.optional().describe("'ops' ile aynı alan (eşanlamlı) — entity/microservice/workflow patch'leriyle aynı adı kullanabilmeniz için"), allowFlowDeletion: z.boolean().optional().describe('page_schema_patch\'e vereceğiniz değer: true ise akışı referanssız bırakan yama kuru koşuda da reddedilmez. Varsayılan false — yazım onu reddeder, kuru koşu da (G-21).'), policyOverride: textHookOverrideParam },
         annotations: readOnly
-    }, handle(config, async ({ project, environment, applicationId, pageId, ops, operations, allowFlowDeletion }) => {
-        const plan = await planPageWrite('page_schema_validate', { project, environment, applicationId, pageId, ops, operations, allowFlowDeletion });
+    }, handle(config, async ({ project, environment, applicationId, pageId, ops, operations, allowFlowDeletion, policyOverride }) => {
+        const plan = await planPageWrite('page_schema_validate', { project, environment, applicationId, pageId, ops, operations, allowFlowDeletion, policyOverride });
         const response = ((await platform.tenant('POST', project, `/pages/${applicationId}/${pageId}/schema/validate`, {
             environment,
             body: { ops: plan.serverOps }
@@ -961,7 +975,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
         if (plan.layoutWarnings.length > 0)
             response.layoutWarnings = plan.layoutWarnings;
         Object.assign(response, applicationTypeField(plan.resolved));
-        return withNormalization(response, plan.notes);
+        return attachFindings(withNormalization(response, plan.notes), plan.textFindings);
     }));
     server.registerTool('page_schema_patch', {
         title: 'Sayfa şemasına patch uygula',
@@ -976,11 +990,12 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
             baseVersion: z.string().optional().describe("page_schema_get çıktısındaki version ya da önceki page_schema_patch yanıtındaki newVersion; sayfa o sürümden beri değiştiyse 409 döner ve hiçbir op uygulanmaz"),
             expectedUpdatedAt: z.string().optional().describe("Eski koruma: page_schema_get çıktısındaki updatedAt; eşleşmezse patch uygulanmaz. baseVersion tercih edilir"),
             allowFlowDeletion: z.boolean().optional().describe("true: bu yama bir akışı referanssız bırakacaksa yine de uygulanır. Varsayılan false — platform referanssız akışı KALICI siler ve gateway isteği önden reddeder (G-21). Silinen akışlar yanıtta deletedFlows ile listelenir."),
-            view: writeViewParam
+            view: writeViewParam,
+            policyOverride: textHookOverrideParam
         },
         annotations: updates
-    }, handle(config, async ({ project, environment, applicationId, pageId, ops, operations, baseVersion, expectedUpdatedAt, allowFlowDeletion, view }) => {
-        const plan = await planPageWrite('page_schema_patch', { project, environment, applicationId, pageId, ops, operations, expectedUpdatedAt, allowFlowDeletion });
+    }, handle(config, async ({ project, environment, applicationId, pageId, ops, operations, baseVersion, expectedUpdatedAt, allowFlowDeletion, view, policyOverride }) => {
+        const plan = await planPageWrite('page_schema_patch', { project, environment, applicationId, pageId, ops, operations, expectedUpdatedAt, allowFlowDeletion, policyOverride });
         const { opRecords, sentOps, serverOps, resolved, removedEvents, resized, propTypes, deletedFlows, formWarnings, flowWarnings, flowsBeforePatch, layoutWarnings } = plan;
         // Tek istek, tek sürüm: öykünülen op'lar 2026-09-14'e kadar ayrı GET + tam PUT çiftleriydi ve
         // yamadan ÖNCE yazılıyordu — PATCH reddedilse bile kalıcıydılar. Artık hepsi aynı atomik PATCH'te.
@@ -1058,7 +1073,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
             }
         }
         Object.assign(response, applicationTypeField(resolved));
-        return withWriteDiff(withNormalization(response, plan.notes), opDrops);
+        return attachFindings(withWriteDiff(withNormalization(response, plan.notes), opDrops), plan.textFindings);
     }));
     server.registerTool('page_discover', {
         title: 'Tasarım ekranından sayfa iskeleti öner',
@@ -1093,10 +1108,11 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
             events: eventsParam.optional(),
             schema: schemaParam.optional(),
             view: writeViewParam,
+            policyOverride: textHookOverrideParam,
             ifExists: ifExistsParam('sayfa', "mevcut sayfayı page_update gibi günceller — yalnız bu çağrıda VERİLEN alanlar yazılır, verilmeyen şema/olaylar/roller korunur (page_schema_patch ile kurulmuş şema betik tekrar koşunca silinmez); id'si ve flow'ları korunur. Şema verilirse sayfanın şeması BİLEREK tam yazılır (page_update force:true gibi — gateway sayfayı okuduğu anın sürümüyle yazar, aradaki Studio değişikliği ezilir); hedefli değişiklik için page_schema_patch")
         },
         annotations: writes
-    }, handle(config, async ({ project, environment, applicationId, name, slug, browserTitle, browserTitleKey, layoutId, roleIds, middlewareIds, isAnonymous, isLoginPage, events, schema, view, ifExists }) => {
+    }, handle(config, async ({ project, environment, applicationId, name, slug, browserTitle, browserTitleKey, layoutId, roleIds, middlewareIds, isAnonymous, isLoginPage, events, schema, view, ifExists, policyOverride }) => {
         const resolved = await resolveProfile(platform, applicationId);
         const blocksMeaningful = resolved.profile.layout.blocksMeaningful;
         const container = ensurePageContainer(schema ?? [], resolved.profile.layout.rootContainer);
@@ -1134,6 +1150,15 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
             copyCheck: "kullanılıp kullanılmadığını dependency_graph module:'page' ile kontrol edip gerekirse silin",
             updateTool: 'pageId ile page_update'
         });
+        // TR-005 / TR-006: ifExists:'update' mevcut sayfayı yeniden yazar — onda zaten duran kanca eskidir.
+        const textFindings = schema === undefined
+            ? []
+            : await enforceTextHooks(config, {
+                platform, project, environment, applicationId,
+                after: container.schema,
+                before: async () => existing === undefined ? undefined : (await fetchHost(platform, 'page', project, environment, applicationId, String(existing.id))).schema,
+                where: `sayfa '${name}'`
+            }, policyOverride);
         if (existing !== undefined) {
             const pageId = String(existing.id);
             const current = await fetchHost(platform, 'page', project, environment, applicationId, pageId);
@@ -1163,7 +1188,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
             };
             if (updateWarnings.length > 0)
                 summary.layoutWarnings = updateWarnings;
-            return withNormalization(summary, schema === undefined ? [] : [...container.fixes, ...skeletonNotes, ...componentNameNote(named), ...reset, ...componentDefaultsNote(fixed), ...catalogNotes, ...reorderNote(moved), ...mobileSpacingNote(spacing)]);
+            return attachFindings(withNormalization(summary, schema === undefined ? [] : [...container.fixes, ...skeletonNotes, ...componentNameNote(named), ...reset, ...componentDefaultsNote(fixed), ...catalogNotes, ...reorderNote(moved), ...mobileSpacingNote(spacing)]), textFindings);
         }
         // PAGE-051 yalnız gerçekten OLUŞTURAN dalda: `ifExists: 'update'` var olan sayfada page_update gibi
         // davranır ve kayıtlı emekli düğüm yazılabilir kalmalıdır.
@@ -1204,7 +1229,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
         const createWarnings = [...gaps, ...stringStyleWarning(stringStyles), ...(resolved.profile.layout.modes.has('grid') ? inertFlexPropWarning(inertFlexPropNodes(container.schema)) : []), ...flexSizeWarnings(container.schema, 'PAGE-017 (uyarı)', 'PAGE-018 (uyarı)'), ...spacingLayerWarnings(container.schema, 'PAGE-029 (uyarı)', 'PAGE-030 (uyarı)'), ...profileWarnings,
             ...await pageLayoutWarnings(platform, resolved, project, environment, applicationId, { tree: container.schema, layoutId })];
         const typeField = applicationTypeField(resolved);
-        const findings = await legacyRoleListFindings(platform, project, environment, { roleIds }, 'page');
+        const findings = [...await legacyRoleListFindings(platform, project, environment, { roleIds }, 'page'), ...textFindings];
         if (!normalized || typeof normalized !== 'object')
             return attachFindings(normalized, findings);
         if (createWarnings.length === 0)
@@ -1232,10 +1257,11 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
             schema: schemaParam.optional().describe('Nadiren gerekir; verilirse her düğümde elementId, name (= elementId), type, blocks zorunlu (PAGE-037, gateway blocks doldurmaz); verilmezse mevcut şema korunur. Tam REPLACE: kayıtlı sayfadan daha az düğüm taşıyan şema allowNodeLoss olmadan reddedilir (PAGE-043)'),
             allowNodeLoss: z.boolean().optional().describe('true: gönderilen schema kayıtlı sayfadan daha az düğüm taşısa da yazılır — eksik düğümler geri dönüşsüz silinir. Varsayılan false: PAGE-043 ile reddedilir (kırpık okumanın geri yazılması)'),
             baseVersion: z.string().optional().describe("Değişikliği planladığınız sayfa sürümü (page_get / page_schema_get yanıtındaki version). Verilmezse bu gateway'in o sayfada en son gördüğü sürüm gider; sayfa o sürümden beri değiştiyse 409 döner ve hiçbir şey yazılmaz"),
-            force: z.boolean().optional().describe("true: sürüm kontrolünü bilerek geçer — gateway sayfanın son sürümünü okuyup onun üstüne yazar, aradaki değişiklik (Studio sekmesi, başka ajan) ezilir. Yanıt forced: true taşır. Varsayılan false")
+            force: z.boolean().optional().describe("true: sürüm kontrolünü bilerek geçer — gateway sayfanın son sürümünü okuyup onun üstüne yazar, aradaki değişiklik (Studio sekmesi, başka ajan) ezilir. Yanıt forced: true taşır. Varsayılan false"),
+            policyOverride: textHookOverrideParam
         },
         annotations: updates
-    }, handle(config, async ({ project, environment, applicationId, pageId, allowNodeLoss, baseVersion, force, ...changes }) => {
+    }, handle(config, async ({ project, environment, applicationId, pageId, allowNodeLoss, baseVersion, force, policyOverride, ...changes }) => {
         const knownVersion = baseVersion ?? schemaReadMemory.lastVersion(pageKey(project, environment, pageId));
         if (knownVersion === undefined && force !== true) {
             throw new PlatformApiError("PAGE-039 — page_update hangi sürümün üstüne yazdığını bilmiyor: baseVersion verilmedi ve bu gateway sayfayı henüz okumadı. Platformun PUT'u REPLACE'tir; sürümsüz tam gövde Studio'da açık bir sekmenin ya da başka bir ajanın değişikliğini sessizce ezer (Bitki Bakım koşusu, 14:02). Önce page_get ya da page_schema_get ile okuyun — yanıttaki version gateway'de hatırlanır — ya da onu baseVersion olarak verin. Son sürümün üstüne bilerek yazmak için force:true. İstek gönderilmedi.", 400);
@@ -1260,6 +1286,15 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
                 throw new PlatformApiError(`PAGE-043 — gönderilen şema ${sent} düğüm, kayıtlı sayfa ${stored} düğüm; eksilen elementId'ler: ${listed}${more}. Platformun PUT'u REPLACE'tir: eksik düğümler geri dönüşsüz silinir — kırpık (allowTruncated) ya da yarım bir okuma geri yazılıyor olabilir, istek gönderilmedi. Şema değişikliğini page_schema_patch micro-op'larıyla yapın (silmek için remove_component); düğümleri bilerek siliyorsanız allowNodeLoss:true verin.`, 400);
             }
         }
+        // TR-005 / TR-006: tam şema yazımı kayıtlı şemayla karşılaştırılır — orada zaten duran kanca eskidir.
+        const textFindings = overrides.schema === undefined
+            ? []
+            : await enforceTextHooks(config, {
+                platform, project, environment, applicationId,
+                after: overrides.schema,
+                before: async () => current.schema,
+                where: `sayfa '${String(current.name ?? pageId)}'`
+            }, policyOverride);
         const blocksMeaningful = resolved?.profile.layout.blocksMeaningful ?? true;
         const fixed = normalizeComponentDefaults(overrides.schema);
         const reset = overrides.schema === undefined || !blocksMeaningful ? [] : resetPageContainerPosition(overrides.schema);
@@ -1296,7 +1331,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
             summary.forced = true;
         if (gaps.length > 0 || skeletonWarnings.length > 0)
             summary.layoutWarnings = [...gaps, ...skeletonWarnings];
-        const findings = await legacyRoleListFindings(platform, project, environment, overrides, 'page');
+        const findings = [...await legacyRoleListFindings(platform, project, environment, overrides, 'page'), ...textFindings];
         return attachFindings(withNormalization(summary, [...componentNameNote(named), ...reset, ...componentDefaultsNote(fixed), ...catalogNotes, ...reorderNote(moved)]), findings);
     }));
     server.registerTool('page_clone', {

package/dist/tools/platformInfo.js

@@ -67,8 +67,9 @@ const guideRouting = {
     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): mobildeki davranış, args sözleşmesi, Steps.<adım> sonucu; bildirim, izin, reklam ve konum tarifleri",
-    'mobile-publish': "mobil uygulamanın mağaza yayını: mobile_store_* / mobile_build_* akışı, ön kontrol P-01…P-14 (push kimlikleri, izinler, reklam ve kod tarama dahil), derleme hata kodları, insanın Studio'da yaptıkları",
+    '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-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)',
     html: 'hazır komponent yetmediğinde tek seferlik kaçış kapısı (Mustache, fireEvent, script kuralları)',
@@ -80,6 +81,7 @@ const guideRouting = {
     translation: 'sayfa/içerik çevirileri (çoklu dil)',
     access: 'kompleks proje yetkisi: organizasyon ağacı, izin kataloğu, kapsam, grant/atama, alan koruması (maske · şifre · türetilmiş alan)',
     merge: "dal aç, dalda çalış, development'a merge et; çakışma çözümü ve apply kapıları",
+    deployment: "development → production deploy'u neyi taşır: yalnız tanım; tablo satırları recordTransferMode ile, dosyalar yalnız id referansıyla; production'da eksik satır/dosya teşhisi",
     bpm: 'süreç motoru: tanım modeli, düğümler, atama sözlüğü, bölge olayları, kutu ve görev eylemleri, bağlayıcı/belge/imza/kanallar (süreç ≠ workflow)',
     decision: 'DMN karar tabloları: model, isabet politikaları, FEEL alt kümesi, DRD, süreçte decision düğümü, DMN XML'
 };