@appaflytech/zeyrek-ai-mcp 0.0.53 → 0.0.54

package/dist/resources/guides/merge.md

@@ -70,6 +70,11 @@ Studio'nun runtime rotasının üç şeridi vardır ve **ortamı URL belirler**:
 Sayfanın **bütün** istekleri o dala gider: sayfa şeması da, akışların uç çağrıları da. Yani kare
 "yarı doğru" değildir — gördüğünüz ekran dalın gerçek ekranıdır.
 
+`{app}` **o ortamın** uygulama slug'ıdır: dal uygulama kaydını açıldığı andaki hâliyle tutar, production
+dağıtıma kadar eskisini; `application_list` ise development slug'ını verir. Uygulama sonradan yeniden
+adlandıysa Core slug'ı dalda/production'da 404 verir — `applicationSlug`'a uygulama **id**'sini verin,
+gateway ortamın slug'ını okur; dal açıldıktan sonra kurulan uygulama dalda yoktur (APP-002).
+
 Reddedilen tek şey **dal adı olamayacak bir ad**: harfle başlamayan, küçük harf/rakam/alt çizgi/tire
 ve `/` ile ayrılmış parçalar dışında karakter taşıyan, 3-31 aralığının dışına çıkan ya da rezerve bir
 ad (`public`, `api`, `pg_*` …). Projedeki dalları ve slug'larını `environment_list` verir; tenant

package/dist/resources/guides/mobile-publish.md

@@ -96,8 +96,9 @@ bağlantısı) Studio › Yayınla'dan davet edilir — kişisel e-posta taşıd
 gönderim** (adım 8: `app-store-review`, `app-store-release`, `play-promote`) geri dönüşsüz ya da insan onaylıdır;
 ajan yalnız `dryRun` ile ön kontrolünü okur ve kullanıcıyı Studio'ya yönlendirir.
 
-**Ekran görüntüsü:** `page_screenshot { environment: 'production', device, format: 'jpeg', quality: 92,
-language, colorScheme: 'light', outPath }` → `mobile_asset_create { path, kind: 'screenshot', deviceClass, locale }`.
+**Ekran görüntüsü:** `page_screenshot { environment: 'production', applicationSlug: <uygulama id'si>, device, format: 'jpeg', quality: 92,
+language, colorScheme: 'light', outPath }` — id verilince gateway production'ın kendi slug'ını okur (yeniden adlanan
+uygulama dağıtıma kadar eski slug'la açılır, APP-002) → `mobile_asset_create { path, kind: 'screenshot', deviceClass, locale }`.
 `device`: iphone69 `{440,956,3}` · ipad13 `{1032,1376,2}` · phone `{360,720,3}` · tablet7 `{600,960,2}` ·
 tablet10 `{800,1280,2}`. JPEG şart (iOS alfa kabul etmez); giriş/splash sayfası çekilmez (App Review 2.3.3).
 ikon/splash/öne çıkan görsel tekli yuvadır: yeni yükleme eskisinin yerine geçer.

package/dist/resources/guides/mobile.md

@@ -596,7 +596,8 @@ yaptıkları. Derlenen uygulama
   (MOB-033), `Steps.<ad>.cache.at`, `error.network` — `platform_guide('page')` §Kural 1g-4. Önizleme önbellek kullanmaz.
   Yalnız GET okuma saklanır (POST okuma ağsız açılmaz → GET + query-string, FLOW-044); kuyruk değişimi sayfanın
   `offlineQueueChange` olayıdır, yoklama gerekmez (§Kural 1g-4).
-  Ayar (`properties`, ana sayfa, bulunamadı sayfası) `application_update` ile yalnız **development**'a yazılır; production'da
-  `deployment_start`'tan sonra geçerli olur (APP-001) — önce development'ta deneyin.
+  Uygulama kaydı (ad, slug, `properties`, ana sayfa, bulunamadı sayfası) `application_update` ile yalnız
+  **development**'a yazılır; production'da `deployment_start`'tan sonra geçerli olur (APP-001) — önce development'ta
+  deneyin. Slug değişirse production derlemesi dağıtıma kadar eski slug'ı taşır.
   "Uygulama ağsızken de çalışsın" isteğinin tarifi (okuma GET, yazma kuyruğu, liste birleştirme, düğme kilidi, korumasız
   açılış, bant kapalı): §Kural 1g-4 "Ağsızken fark göstermeyen uygulama", örnek `ngapps://examples/mobile-offline-seamless`.

package/dist/resources/prompts/mobile-publish-prepare.md

@@ -54,8 +54,9 @@ başlamadan önce §Yolculuk, §Test derlemesi, §Akış, §Yaş derecelendirmes
    `adaptiveMonochrome`, `splash`) eksikse kullanıcıdan dosya iste ya da var olan dosyanın yolunu sor.
    Ekran görüntüsü: her mağaza dili ve açık platformun cihaz sınıfı için 3–5 gerçek ekran —
    `page_screenshot { applicationSlug, pageSlug, environment: 'production', device, format: 'jpeg', quality: 92, language, colorScheme: 'light', outPath }`
-   → `mobile_asset_create { applicationId, kind: 'screenshot', deviceClass, locale, path }`. `applicationSlug`
-   `application_list`'ten, `pageSlug` `page_list`'ten; `device` rehberdeki cihaz tablosundan; `language` o
+   → `mobile_asset_create { applicationId, kind: 'screenshot', deviceClass, locale, path }`. `applicationSlug`'a
+   uygulamanın id'sini ver (gateway production'ın kendi slug'ını okur; `application_list` development slug'ını döner ve
+   yeniden adlanan uygulamada production'da 404 verir — APP-002), `pageSlug` `page_list`'ten; `device` rehberdeki cihaz tablosundan; `language` o
    yuvanın `locale`'idir — verilmezse kare projenin varsayılan dilinde çıkar ve başka dilin yuvasına yanlış dilde
    yüklenir. Yuva birikimlidir (en çok 10 görsel): 1. adımda okuduğun yuvada görsel varsa kullanıcıya sormadan
    ekleme yapma. Giriş ve splash sayfası çekilmez. Production'da sayfa yoksa kullanıcıya sor: ekran görüntüsü

package/dist/tools/applications.js

@@ -91,7 +91,7 @@ export function registerApplicationTools(server, platform) {
     }, handle(config, args => platform.org('GET', `/applications/${args.id}`)));
     server.registerTool('application_create', {
         title: 'Application oluştur',
-        description: `Projeye yeni application ekler. ${templateSubscriptionLock}`,
+        description: `Projeye yeni application ekler. ORTAM (b-17, APP-001): uygulama yalnız development'ta (ve Core'da) açılır; production onu ilk deployment_start ile alır, o zamana kadar production adresi yoktur. Dallar açıldıkları andaki kopyayı tutar, sonradan açılan uygulamayı görmez. ${templateSubscriptionLock}`,
         inputSchema: {
             projectId: guid,
             slug: z.string().min(1),
@@ -113,7 +113,7 @@ export function registerApplicationTools(server, platform) {
     }));
     server.registerTool('application_update', {
         title: 'Application güncelle',
-        description: `Application bilgilerini günceller; homepageId zorunludur (mevcut değeri application_get ile alın). ORTAM (K5, b-15): ayar alanları — properties (mobile.offline, sekmeler, geçiş…), homepageId, notFoundPageId — yalnız development'a yazılır; production onları deployment_start ile alır (dal ortamları açıldıkları andaki kopyayı tutar), yani ayarı önce development'ta deneyin. Kimlik alanları (name, slug, color, dns) bütün ortamlara hemen gider. Yanıttaki environmentNote bunu çağrı başına söyler. ${templateSubscriptionLock}`,
+        description: `Application bilgilerini günceller; homepageId zorunludur (mevcut değeri application_get ile alın). ORTAM (K5, b-15): bütün alanlar — name, slug, color, dns, properties (mobile.offline, sekmeler, geçiş…), homepageId, notFoundPageId — yalnız development'a (ve Core'a) yazılır; production onları deployment_start ile alır (dal ortamları açıldıkları andaki kopyayı tutar), yani önce development'ta deneyin. Slug değişirse production adresi dağıtıma kadar eski slug'la çalışır. Yanıttaki environmentNote bunu çağrı başına söyler. ${templateSubscriptionLock}`,
         inputSchema: {
             id: guid,
             slug: z.string().min(1),
@@ -136,12 +136,12 @@ export function registerApplicationTools(server, platform) {
         const missing = ['properties', 'notFoundPageId'].filter((field) => body[field] === undefined);
         return {
             ...withPlatformWarnings(response, warnings),
-            environmentNote: `properties, homepageId ve notFoundPageId verildiği gibi yalnız development'a (ve Core'a) yazıldı; production onları deployment_start ile alır, dal ortamları hiç almaz (APP-001). name/slug/color/dns bütün ortamlara gitti.${missing.length > 0 ? ` ${missing.join(' ve ')} verilmedi: uç tam kaydı yazar, development'taki değer boşaltıldı — korumak için application_get'teki mevcut değeri gönderin.` : ''}`
+            environmentNote: `name, slug, color, dns, properties, homepageId ve notFoundPageId verildiği gibi yalnız development'a (ve Core'a) yazıldı; production onları deployment_start ile alır, dal ortamları hiç almaz (APP-001).${missing.length > 0 ? ` ${missing.join(' ve ')} verilmedi: uç tam kaydı yazar, development'taki değer boşaltıldı — korumak için application_get'teki mevcut değeri gönderin.` : ''}`
         };
     }));
     server.registerTool('application_delete', {
         title: 'Application sil',
-        description: `Application'ı kalıcı olarak siler. ${templateSubscriptionLock}`,
+        description: `Application'ı kalıcı olarak siler — development'tan (ve Core'dan). ORTAM (b-17, APP-001): production'daki kopya ve kullanıcı verisi deployment_start'a kadar yerinde kalır, silme dağıtımla gider; dallar kendi kopyasını tutar. ${templateSubscriptionLock}`,
         inputSchema: { id: guid },
         annotations: destructive
     }, handle(config, async (args) => {

package/dist/tools/connectData.js

@@ -240,7 +240,8 @@ export function registerConnectDataTools(server, platform) {
             anonymous,
             mirrorAuthorizationCookie: true
         });
-        let application = await applicationSlug(platform, applicationId);
+        // Development dışında slug o ortamın kendi kaydıdır; Core'un (yeni) slug'ı orada 404 verir (g-24, APP-002).
+        let application = await applicationSlug(platform, applicationId, { project, environment });
         if (!application)
             throw new PlatformApiError(`Uygulama ${applicationId} bulunamadı; runtime yolu kurulamadı.`, 404);
         let raw;
@@ -250,7 +251,7 @@ export function registerConnectDataTools(server, platform) {
         catch (error) {
             if (!(error instanceof PlatformApiError) || error.status !== 404)
                 throw error;
-            const fresh = await applicationSlug(platform, applicationId, { fresh: true });
+            const fresh = await applicationSlug(platform, applicationId, { project, environment, fresh: true });
             if (!fresh || fresh === application)
                 throw error;
             application = fresh;
@@ -412,18 +413,26 @@ export function registerConnectDataTools(server, platform) {
             environment,
             body: { elementId: element, propPath: prop, name, slug, ...(version ? { baseVersion: version } : {}) }
         }));
-        const application = await applicationSlug(platform, applicationId);
+        // Dönüşüm yazıldıktan sonra tarif düşmez: dağıtılmamış uygulamada yer tutucu slug ve neden döner (APP-002).
+        let notDeployed;
+        const application = await applicationSlug(platform, applicationId, { project, environment }).catch((error) => {
+            if (!(error instanceof PlatformApiError) || error.status !== 404)
+                throw error;
+            notDeployed = error.message;
+            return undefined;
+        });
         // Kompleks + enforce projede kimliksiz çağrı 401 AppSessionRequired döner ve yeni uç kullanıcının hiçbir
         // politikasında yoktur (39/M-15): tarif kullanıcı gözünü ve eksik grant'i söyler.
         const access = await projectAccessContext(platform, project, environment);
         const enforced = access?.accessModel === 'complex' && access.enforcementMode === 'enforce';
-        const verifyArguments = { application: application ?? '<application slug>', microservice: result.microserviceSlug, method: 'POST', body: { op: 'list', page: { limit: 5 } }, ...(enforced ? { asUserId: "<users satır id'si>" } : {}) };
+        const verifyArguments = { ...(environment ? { environment } : {}), application: application ?? '<application slug>', microservice: result.microserviceSlug, method: 'POST', body: { op: 'list', page: { limit: 5 } }, ...(enforced ? { asUserId: "<users satır id'si>" } : {}) };
         return {
             ...result,
             reference: { version: 1, microserviceId: result.microserviceId },
             verify: {
                 tool: 'microservice_execute',
                 arguments: verifyArguments,
+                ...(notDeployed ? { notDeployed } : {}),
                 ...(enforced ? { note: `Kompleks + enforce proje: kimliksiz çağrı 401 döner, asUserId verin. Yeni uç hiçbir politikada yok — kullanıcının politikasına microservice.execute grant'i ekleyin (resourceKey 'microservice:${result.microserviceId}'), yoksa 403. Sayfanın kendi bağlantısı bu grant'i istemez; connect_data_detach sonrası grant yetim kalır.` } : {})
             }
         };

package/dist/tools/microservices.js

@@ -214,25 +214,36 @@ function executePath(prefix, application, microservice, routeParams) {
 /**
  * Slug application_update ile değişebildiği için önbellek kısa ömürlüdür (yalnız aynı turdaki tekrar okumaları ucuzlatır);
  * runtime yolu 404 dönen çağıran `fresh: true` ile önbelleği atlar. Org API'nin 404 dışı hatası (yetki, ağ) çağırana gider.
+ *
+ * Uygulama kaydı (ad, slug, ayar) ve varlığı production'a yalnız dağıtımla gider, dal açıldığı andaki kopyayı tutar
+ * (backend ADR 0073, g-24): `GET /applications/{id}` Core'dur = development. Başka ortamın slug'ı o ortamın kendi
+ * kaydından (tenant `GET /{project}/applications/{id}`, X-Environment) okunur; yoksa uygulama oraya dağıtılmamıştır (APP-002).
  */
 const APPLICATION_SLUG_TTL_MS = 60_000;
 const applicationSlugCache = new Map();
 export async function applicationSlug(platform, applicationId, options = {}) {
-    const cached = options.fresh ? undefined : applicationSlugCache.get(applicationId);
+    const environment = platform.resolveEnvironment(options.environment);
+    const core = environment === 'development';
+    const key = `${core ? '' : platform.resolveProject(options.project)}:${environment}:${applicationId}`;
+    const cached = options.fresh ? undefined : applicationSlugCache.get(key);
     if (cached && cached.expiresAt > Date.now())
         return cached.slug;
     try {
-        const payload = await platform.org('GET', `/applications/${applicationId}`);
+        const payload = (core
+            ? await platform.org('GET', `/applications/${applicationId}`)
+            : await platform.tenant('GET', options.project, `/applications/${applicationId}`, { environment }));
         const application = (payload?.data ?? payload);
         const slug = typeof application.slug === 'string' && application.slug !== '' ? application.slug : undefined;
         if (slug)
-            applicationSlugCache.set(applicationId, { slug, expiresAt: Date.now() + APPLICATION_SLUG_TTL_MS });
+            applicationSlugCache.set(key, { slug, expiresAt: Date.now() + APPLICATION_SLUG_TTL_MS });
         return slug;
     }
     catch (error) {
-        if (error instanceof PlatformApiError && error.status === 404)
+        if (!(error instanceof PlatformApiError) || error.status !== 404)
+            throw error;
+        if (core)
             return undefined;
-        throw error;
+        throw new PlatformApiError(`Uygulama ${applicationId} '${environment}' ortamında yok: uygulama kaydı (ad, slug, ayar) ve varlığı production'a yalnız dağıtımla gider, dal açıldığı andaki kopyayı tutar (APP-002). Production için deployment_start ile dağıtın; dalda yalnız dal açılmadan önce var olan uygulama bulunur — development'ta deneyin ya da dalı yeniden açın.`, 404);
     }
 }
 /**
@@ -247,7 +258,14 @@ async function resolveRuntimeUrl(platform, project, environment, applicationId,
     const method = String(definition.httpMethod ?? 'get').toUpperCase();
     const resolvedProject = platform.resolveProject(project);
     const resolvedEnvironment = platform.resolveEnvironment(environment);
-    const application = await applicationSlug(platform, applicationId);
+    // Dağıtılmamış uygulamada tanım yine döner; tarif yer tutucu slug ve nedeni taşır.
+    let notDeployed;
+    const application = await applicationSlug(platform, applicationId, { project, environment }).catch((error) => {
+        if (!(error instanceof PlatformApiError) || error.status !== 404)
+            throw error;
+        notDeployed = error.message;
+        return undefined;
+    });
     const path = `/${resolvedProject}/m/${application ?? '<application slug>'}/${slug}`;
     return {
         method,
@@ -257,7 +275,7 @@ async function resolveRuntimeUrl(platform, project, environment, applicationId,
             Host: `${platform.config.organization}.${platform.config.hostSuffix}`,
             'X-Environment': resolvedEnvironment
         },
-        note: `Yolu SLUG kurar, 'url' alanı ('${String(definition.url ?? '')}') rotaya girmez. Route parametreleri slug'ın ardına eklenir. Anonim erişim testi için microservice_execute'u anonymous: true ile çağırın; korumalı uçlarda 401, anonim uçlarda 200 beklenir.`
+        note: `Yolu SLUG kurar, 'url' alanı ('${String(definition.url ?? '')}') rotaya girmez. Route parametreleri slug'ın ardına eklenir. Anonim erişim testi için microservice_execute'u anonymous: true ile çağırın; korumalı uçlarda 401, anonim uçlarda 200 beklenir.${notDeployed ? ` ${notDeployed}` : ''}`
     };
 }
 export function registerMicroserviceTools(server, platform) {

package/dist/tools/mobileStore.js

@@ -590,7 +590,7 @@ export function registerMobileStoreTools(server, platform, storeArt = {}) {
     }, 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'); 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'] }.`,
+        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: <uygulama id'si — production'ın kendi slug'ına çözülür, APP-002>, 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

@@ -30,6 +30,8 @@ import { boxSectionNote, collectIds, ensureBoxSections, expandSectionToggles } f
 import { designSnapshotInput } from '../knowledge/designSnapshot.js';
 import { discoverPage } from '../knowledge/pageDiscover.js';
 import { applicationTypeField, resolveProfile, resolveProfileBySlug } from '../knowledge/platform/resolve.js';
+import { applicationSlug as environmentApplicationSlug } from './microservices.js';
+import { isGuid } from '../platform/refs.js';
 import { batchEnvelopeNote, batchIndexHint, openBatchEnvelopes } from '../knowledge/platform/batchOps.js';
 import { heroTags } from '../knowledge/platform/heroTag.js';
 import { profileLintReadsSavedNodes } from '../knowledge/platform/lint.js';
@@ -58,6 +60,20 @@ function runtimeFunctions(value) {
             .map(parameter => ({ name: parameter.name, required: parameter.required === true, defaultValue: parameter.defaultValue ?? null }))
     }));
 }
+/**
+ * g-24 / APP-002: uygulama kaydı production'a yalnız dağıtımla gider, dal açıldığı andaki kopyayı tutar; application_list
+ * ve application_get Core'u (development) döner. Yeniden adlanan uygulamanın production/dal adresi eski slug'la çalışır,
+ * Core slug'ı orada 404 verir — id verilirse slug'ı o ortamın kaydından gateway okur.
+ */
+const runtimeApplicationParam = z.string().min(1).describe("Uygulamanın slug'ı ya da id'si (GUID). application_list / application_get DEVELOPMENT slug'ını döner; production ve dal uygulama kaydını yalnız dağıtımla/açılışla alır, yeniden adlanan uygulama orada dağıtıma kadar eski slug'la açılır. production ya da dalda id verin: gateway o ortamın kendi slug'ını okur, uygulama o ortamda yoksa (dağıtılmamış) istek gitmeden hata döner (APP-002)");
+async function runtimeApplicationSlug(platform, project, ref, environment) {
+    if (!isGuid(ref))
+        return ref;
+    const slug = await environmentApplicationSlug(platform, ref, { project, environment });
+    if (!slug)
+        throw new PlatformApiError(`Uygulama ${ref} bulunamadı: id'yi application_list ile doğrulayın.`, 404);
+    return slug;
+}
 /**
  * G-10: `index` taşıyan add/move op'u varsa sayfa okunur ve `flexIndexOrder` flex kapta görünen
  * sırayı konumlara çevirir. Okuma başarısız olursa op'lar olduğu gibi gider — bugünkü davranış.
@@ -181,7 +197,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
         inputSchema: {
             project: projectParam,
             environment: environmentParam,
-            applicationSlug: z.string().min(1).describe("Uygulamanın slug'ı (application_list / project_overview)"),
+            applicationSlug: runtimeApplicationParam,
             pageSlug: z.string().min(1).describe("Sayfanın slug'ı (page_list)"),
             view: z.enum(['summary', 'full']).optional().describe('summary (varsayılan): şema/layout ağaçları id/name/type özetine indirgenir. full: ham gövde — büyük olabilir'),
             resolveStyles: z.boolean().optional().describe("summary görünümünde her düğüme EFEKTİF stilini ekler: tema componentStyles → preset → düğümün kendi stili kaskadı çözülür (aibox'ta tipli stil grupları da derlenir ve TABAN katman olur). styleLayers hangi katmanın konuştuğunu söyler — 'bu kutu neden böyle görünüyor' sorusunun cevabı budur."),
@@ -190,7 +206,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
             asUserId: asUserIdParam
         },
         annotations: readOnly
-    }, handle(config, async ({ project, environment, applicationSlug, pageSlug, view, resolveStyles, anonymous, asUser, asUserId }) => {
+    }, handle(config, async ({ project, environment, applicationSlug: applicationRef, pageSlug, view, resolveStyles, anonymous, asUser, asUserId }) => {
         let response;
         if (anonymous === true && asUser !== undefined) {
             throw new PlatformApiError('page_runtime_get: anonymous:true ile asUser birlikte verilemez — biri kimliksiz isteği, diğeri belirli bir üyenin kimliğiyle atılan isteği ister.');
@@ -199,6 +215,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
         // yapısal olarak geçemiyordu. Kimlik artık iki kanalda birden gider (Y-02).
         const eye = await impersonationHeaders(platform, 'page_runtime_get', project, environment, { asUserId, asUser, anonymous }, { runtime: true });
         const identity = asUser === undefined ? (eye ? { headers: eye } : {}) : { headers: { authorization: `Bearer ${await resolveIdentity(asUser, platform, project, environment)}` } };
+        const applicationSlug = await runtimeApplicationSlug(platform, project, applicationRef, environment);
         try {
             response = await platform.tenant('GET', project, `/${applicationSlug}/p/${pageSlug}`, { environment, anonymous, mirrorAuthorizationCookie: true, ...identity });
         }
@@ -210,7 +227,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
                     status: error.status,
                     message: error.message,
                     ...(decision ? { accessDecision: decision } : {}),
-                    note: "Sayfaya bağlı middleware isteği reddetti ya da kayıt bulunamadı. Korumalı sayfada kimliksiz/yetkisiz isteğin reddedilmesi BEKLENEN davranıştır. Sayfanın bağlarını page_get ile, middleware tarifini platform_guide('middleware') ile kontrol edin; slug'ları page_list/application_list doğrular."
+                    note: "Sayfaya bağlı middleware isteği reddetti ya da kayıt bulunamadı. Korumalı sayfada kimliksiz/yetkisiz isteğin reddedilmesi BEKLENEN davranıştır. Sayfanın bağlarını page_get ile, middleware tarifini platform_guide('middleware') ile kontrol edin; slug'ları page_list/application_list doğrular — application_list development slug'ını verir; production ya da dalda applicationSlug yerine uygulama id'sini verin (APP-002)."
                 };
             }
             throw error;
@@ -272,11 +289,11 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
     const maxInlinePngBytes = 5 * 1024 * 1024;
     server.registerTool('page_screenshot', {
         title: 'Sayfanın ekran görüntüsünü al',
-        description: "Telefonda (mağaza kabuğu ya da oynatıcı) düşen akış hatasını bu araç görmez — onu mobile_error_list okur. ÖNCE KARESİZ DENE: 'kart göründü mü, tablo doldu mu, hata var mı' gibi olgu sorularında image:'none' verin — kare çekilmez, yanıttaki summaryText her kök düğümün görünürlüğünü, metnini, satır sayısını, açık sekmesini ve hata mesajlarını söyler (bir tam sayfa karesinin yüzlerce katı küçük). Kareyi yalnız görsel soru (renk, hizalama, referansa sadakat) için alın ve küçültün: clip ile bölge, scale:0.5 ile yarı çözünürlük; aynı sayfayı yeniden çekerken image:'ifChanged'. Studio arayüzünün runtime render rotasını (/dev ya da /view) headless Chromium'da açar ve sayfanın PNG ekran görüntüsünü inline görüntü olarak döner — kurduğun sayfayı GÖZLE doğrulamanın yolu budur (page_runtime_get paketi verir, bu tool ekranda ne ÇİZİLDİĞİNİ gösterir). Sayfaya bağlı middleware'ler gerçekten koşar; reddedilirse yanıtta middlewareBlocked işaretlenir ve Studio'nun çizdiği hata durumu karesi döner — bu da bir doğrulamadır. YÜKLENMEMİŞ SAYFA ASLA ÇEKİLMEZ: kare, runtime çizilip mount akışları bitince alınır (yanıtta pageState + readyAfterMs); bütçe dolduğunda sayfa hâlâ iskelette ya da akış koşuyorsa çağrı ne görüldüğünü söyleyen bir hatayla döner, boş/yarım kare dönmez. Sayfa akışı bir adımda düşerse (patlayan ifade, hata dönen uç) yanıt runtimeErrors taşır ve hangi komponentin hangi prop'unun YAZILMADIĞINI söyler — kare 'çalışıyor' görünürken sessizce boş kalan komponenti ancak bu yakalar. Bir komponent prop'unun İFADESİ patlarsa (Studio'da 'Expression error' toast'ı) yanıt expressionErrors taşır: {elementId, prop, expression, message, count}, öğe başına en çok iki; aynı satırın konsol kopyası consoleErrors'a düşmez. Sayfa ya da bir bileşen ÇİZİLEMEZSE neden yanıttadır: mobilde çöken düğüm renderErrors ({elementId, message}; sayfanın geri kalanı çizilir), yakalanmamış istisna pageErrors, konsol hatası consoleErrors — kare alınamadıysa bütün nedenler hata metninde. KARE DONUKTUR: tarayıcı bağlamı 'hareketi azalt' tercihiyle açılır; mobil runtime bileşen hareketini (giriş, döngü, geçiş, iskelet parıltısı, yükleme göstergesi) durdurur ve aynı sayfanın iki karesi tekrarlanabilir. Web sayfasında yalnız CSS'i prefers-reduced-motion'a uyan animasyonlar durur. Hareketin kendisini görmek için motion:'play'. Kare DİLİ ve TEMASI seçilebilir: 'language' adrese ?lang ekler (çeviriye bağlı prop'lar da çok dilli alanların satır değerleri de o dilde çözülür), 'colorScheme' ziyaretçinin tema tercihini sayfa açılmadan eker — ikisi de sayfaya dil değiştirici ya da theme-toggle koymayı GEREKTİRMEZ, yani referansa sadık bir tasarımın ikinci dili ve koyu teması bozulmadan kanıtlanır. STUDIO_BASE_URL tanımlı olmalı; ilk kullanım için `npx playwright-core install chromium` gerekir. DAL ORTAMI DA GÖRÜNTÜLENİR (2026-09-09'dan beri): 'development' /dev, 'production' /view, dal ise /branch/{dal} şeridinden açılır ve sayfanın BÜTÜN istekleri (şema da akışlar da) o dala gider — dalda kurulan sayfa artık merge'i beklemeden gözle doğrulanır (platform_guide('merge') §Dalda görsel doğrulama).",
+        description: "Telefonda (mağaza kabuğu ya da oynatıcı) düşen akış hatasını bu araç görmez — onu mobile_error_list okur. ÖNCE KARESİZ DENE: 'kart göründü mü, tablo doldu mu, hata var mı' gibi olgu sorularında image:'none' verin — kare çekilmez, yanıttaki summaryText her kök düğümün görünürlüğünü, metnini, satır sayısını, açık sekmesini ve hata mesajlarını söyler (bir tam sayfa karesinin yüzlerce katı küçük). Kareyi yalnız görsel soru (renk, hizalama, referansa sadakat) için alın ve küçültün: clip ile bölge, scale:0.5 ile yarı çözünürlük; aynı sayfayı yeniden çekerken image:'ifChanged'. Studio arayüzünün runtime render rotasını (/dev ya da /view) headless Chromium'da açar ve sayfanın PNG ekran görüntüsünü inline görüntü olarak döner — kurduğun sayfayı GÖZLE doğrulamanın yolu budur (page_runtime_get paketi verir, bu tool ekranda ne ÇİZİLDİĞİNİ gösterir). Sayfaya bağlı middleware'ler gerçekten koşar; reddedilirse yanıtta middlewareBlocked işaretlenir ve Studio'nun çizdiği hata durumu karesi döner — bu da bir doğrulamadır. YÜKLENMEMİŞ SAYFA ASLA ÇEKİLMEZ: kare, runtime çizilip mount akışları bitince alınır (yanıtta pageState + readyAfterMs); bütçe dolduğunda sayfa hâlâ iskelette ya da akış koşuyorsa çağrı ne görüldüğünü söyleyen bir hatayla döner, boş/yarım kare dönmez. Sayfa akışı bir adımda düşerse (patlayan ifade, hata dönen uç) yanıt runtimeErrors taşır ve hangi komponentin hangi prop'unun YAZILMADIĞINI söyler — kare 'çalışıyor' görünürken sessizce boş kalan komponenti ancak bu yakalar. Bir komponent prop'unun İFADESİ patlarsa (Studio'da 'Expression error' toast'ı) yanıt expressionErrors taşır: {elementId, prop, expression, message, count}, öğe başına en çok iki; aynı satırın konsol kopyası consoleErrors'a düşmez. Sayfa ya da bir bileşen ÇİZİLEMEZSE neden yanıttadır: mobilde çöken düğüm renderErrors ({elementId, message}; sayfanın geri kalanı çizilir), yakalanmamış istisna pageErrors, konsol hatası consoleErrors — kare alınamadıysa bütün nedenler hata metninde. KARE DONUKTUR: tarayıcı bağlamı 'hareketi azalt' tercihiyle açılır; mobil runtime bileşen hareketini (giriş, döngü, geçiş, iskelet parıltısı, yükleme göstergesi) durdurur ve aynı sayfanın iki karesi tekrarlanabilir. Web sayfasında yalnız CSS'i prefers-reduced-motion'a uyan animasyonlar durur. Hareketin kendisini görmek için motion:'play'. Kare DİLİ ve TEMASI seçilebilir: 'language' adrese ?lang ekler (çeviriye bağlı prop'lar da çok dilli alanların satır değerleri de o dilde çözülür), 'colorScheme' ziyaretçinin tema tercihini sayfa açılmadan eker — ikisi de sayfaya dil değiştirici ya da theme-toggle koymayı GEREKTİRMEZ, yani referansa sadık bir tasarımın ikinci dili ve koyu teması bozulmadan kanıtlanır. STUDIO_BASE_URL tanımlı olmalı; ilk kullanım için `npx playwright-core install chromium` gerekir. DAL ORTAMI DA GÖRÜNTÜLENİR (2026-09-09'dan beri): 'development' /dev, 'production' /view, dal ise /branch/{dal} şeridinden açılır ve sayfanın BÜTÜN istekleri (şema da akışlar da) o dala gider — dalda kurulan sayfa artık merge'i beklemeden gözle doğrulanır (platform_guide('merge') §Dalda görsel doğrulama). Production ve dalda uygulamanın slug'ı o ortamın kendi kaydıdır (dağıtıma/açılışa kadar eski slug; application_list development'ı döner): applicationSlug'a uygulama id'sini verin, gateway ortamın slug'ını okur (APP-002).",
         inputSchema: {
             project: projectParam,
             environment: environmentParam,
-            applicationSlug: z.string().min(1).describe("Uygulamanın slug'ı (application_list / project_overview)"),
+            applicationSlug: runtimeApplicationParam,
             pageSlug: z.string().min(1).describe("Sayfanın slug'ı (page_list); sayfa parametresi sorguyla verilebilir: 'ilac-detay?id=7' (language '&lang=' olarak eklenir)"),
             viewport: z.object({
                 width: z.number().int().min(320).max(3840),
@@ -326,7 +343,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
             outPath: z.string().min(1).optional().describe('Verilirse PNG bu yerel yola yazılır ve inline görüntü DÖNMEZ; yalnız özet (yol, boyut) döner — büyük fullPage kareleri için')
         },
         annotations: readOnly
-    }, async ({ project, environment, applicationSlug, pageSlug, viewport, device, fullPage, delayMs, captureUnready, anonymous, asUser, asUserId, cookies, layoutReport, actions, outPath, expectFailure, language, colorScheme, motion, summary, image, format, quality, scale, clip, diff, session }) => {
+    }, async ({ project, environment, applicationSlug: applicationRef, pageSlug, viewport, device, fullPage, delayMs, captureUnready, anonymous, asUser, asUserId, cookies, layoutReport, actions, outPath, expectFailure, language, colorScheme, motion, summary, image, format, quality, scale, clip, diff, session }) => {
         try {
             if (anonymous === true && (asUser !== undefined || cookies !== undefined)) {
                 throw new PlatformApiError("page_screenshot: anonymous:true ile asUser/cookies birlikte verilemez — biri kimliksiz kareyi, diğeri belirli bir kimlikle çekilen kareyi ister. Anonim kare için yalnız anonymous:true, üye kimliğiyle kare için yalnız asUser (ve gerekiyorsa cookies) gönderin.");
@@ -398,6 +415,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
             // 37 S-17 / 38 S-13: sorgulu slug (`ilac-detay?id=7`) dizeyle birleşince dil ikinci bir '?' ile
             // ekleniyordu ve runtime `id`'yi '7?lang=tr' okudu; sayfa isteği işareti de sorguyu taşıdığı
             // için sayfanın kendi veri isteğiyle hiç eşleşmiyordu.
+            const applicationSlug = await runtimeApplicationSlug(platform, project, applicationRef, environment);
             const address = new URL(`${config.studioBaseUrl}/${lane}/${projectSlug}/${applicationSlug}/${pageSlug}`);
             if (languageChoice)
                 address.searchParams.set('lang', languageChoice.code);
@@ -405,7 +423,8 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
             const pagePath = pageSlug.split(/[?#]/, 1)[0];
             // Hedef ve cihaz uygulamanın platform profilinden (G3): mobil uygulama react-native-web
             // çizimidir, varsayılan kare telefon ön ayarıdır. Tip okunamazsa web davranışı aynen.
-            const resolved = await resolveProfileBySlug(platform, projectSlug, applicationSlug);
+            // Eski production slug'ı Core'da yoktur: id verildiyse tip id'den okunur, slug'la arama web'e düşerdi (APP-002).
+            const resolved = isGuid(applicationRef) ? await resolveProfile(platform, applicationRef) : await resolveProfileBySlug(platform, projectSlug, applicationSlug);
             const target = captureTargetFor(resolved.profile.capture.target);
             const mobile = resolved.profile.platform === 'mobile';
             if (device !== undefined && !mobile) {

package/package.json

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