@appaflytech/zeyrek-ai-mcp 0.0.57 → 0.0.58

package/dist/knowledge/storeImport.js

@@ -5,6 +5,8 @@
  */
 /** Backend `MobileStoreImportConstants.Section*` — rapor bölümleri */
 export const STORE_IMPORT_SECTIONS = ['identity', 'texts', 'urls', 'appInfo', 'assets', 'declarations'];
+/** Backend `MobileStoreImportConstants.IssueLockedKept` — ilk derlemenin kilitlediği, Uygula'nın yazmadığı satır */
+export const LOCKED_KEPT_ISSUE = 'locked_kept';
 /** Backend `MobileStoreDiffConstants.Choice*` */
 export const STORE_DIFF_CHOICES = ['zeyrek', 'store'];
 /** Backend `PurchaseOptions.ImportMaxBytes` */
@@ -17,8 +19,10 @@ const items = (value) => (Array.isArray(value) ? value : []).filter(isObject);
 export function importReportOutline(record, section) {
     const report = isObject(record.report) ? record.report : {};
     const sections = items(report.sections);
+    const rowsOf = sections.flatMap(entry => items(entry.rows).map(row => ({ section: entry.key, row })));
+    const lockedKept = rowsOf.filter(({ row }) => Array.isArray(row.issues) && row.issues.includes(LOCKED_KEPT_ISSUE)).map(({ row }) => row.field);
     const issues = sections.flatMap(entry => items(entry.rows)
-        .filter(row => Array.isArray(row.issues) && row.issues.length > 0)
+        .filter(row => Array.isArray(row.issues) && row.issues.some(issue => issue !== LOCKED_KEPT_ISSUE))
         .map(row => ({ section: entry.key, field: row.field, store: row.store, issues: row.issues, value: row.value, alternative: row.alternative })));
     const violations = items(record.violations);
     return {
@@ -28,7 +32,8 @@ export function importReportOutline(record, section) {
         progress: record.progress,
         summary: report.summary,
         issues,
-        products: items(report.products).map((product, index) => ({ index, kind: product.kind, bucket: product.bucket, suggestedKey: product.suggestedKey, suggestedEntitlement: product.suggestedEntitlement, apple: product.apple, play: product.play, storeManaged: product.storeManaged, issues: product.issues })),
+        ...(lockedKept.length > 0 ? { lockedKept: { fields: lockedKept, note: "İlk derleme bu alanları kilitledi: Uygula yazmaz, Zeyrek'teki korunur (MOB-037). Karar gerektirmez." } } : {}),
+        products: items(report.products).map((product, index) => ({ index, kind: product.kind, bucket: product.bucket, suggestedKey: product.suggestedKey, suggestedEntitlement: product.suggestedEntitlement, existingKey: product.existingKey, apple: product.apple, play: product.play, storeManaged: product.storeManaged, issues: product.issues })),
         mapping: record.mapping,
         ...(violations.length > 0 ? { violations, next: `Taslak kaydedildi ama ${violations.length} kural ihlali var; mobile_store_import_apply bunlar düzelmeden 422 döner. Satırı düzeltip mobile_store_import_mapping'i yeniden çağırın.` } : {}),
         ...(section ? { rows: items(sections.find(entry => entry.key === section)?.rows) } : {}),

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

@@ -329,13 +329,17 @@ ve Play iç test satın almaları `environment: test` etiketiyle, `includeTest:
 ## Mağazadan taşıma
 
 Yayındaki bir uygulama (App Store / Google Play) Zeyrek'e **bir kez okunur, bir kez onaylanır**; sonra tek kaynak Zeyrek'tir
-(kök ADR 0028). Yalnız ilk derlemeden önce (MOB-037).
+(kök ADR 0028). İlk derlemeden sonra da yeniden okunabilir ve uygulanabilir (MOB-037); ilk derlemenin kilitlediği alanlar
+(Bundle ID, paket adı, URL şeması, iOS build numarası, Android version code) ve sürüm Zeyrek'teki değerde kalır, farklı
+Bundle ID / paket adı 409 verir. Aynı Bundle ID / paket adıyla **yeniden eşlenebilir**: yeni okuma açılır, `replace.<satır>` (tek görsellik yuva) ve `replace.asset.screenshot.<dil>.<cihaz>` (ekran görüntüsü seti)
+dolu yuvaları mağazadakiyle değiştirir, raporda `existingKey` dolu ürün yeni ürün açmadan güncellenir.
 
 1. `mobile_store_import_start { applicationId, bundleId, packageName }` → bağlantı satırı ve okuma işi.
 2. `mobile_store_import_report` → `state: ready` olunca kovalar: **auto** (Zeyrek'e gelir) · **upload** (siz yüklersiniz:
    ikon, 6.5" ekran görüntüsü) · **kept** (mağazada kalır: beyan içerikleri, ülke fiyatı, promosyon, tüketilen ürün).
 3. `mobile_store_import_mapping` → `scheme` (eski uygulamanın URL şeması, zorunlu), iki mağaza farkı
-   (`choice.<satır>`), ürün anahtarı/hak (`product.<i>.key|entitlement`), beyan onayı. Mağaza kimliği seçilmez (MOB-038).
+   (`choice.<satır>`), ürün anahtarı/hak (`product.<i>.key|entitlement`; `existingKey` dolu üründe yok sayılır), beyan onayı.
+   Mağaza kimliği seçilmez (MOB-038).
 4. `mobile_store_import_apply` → tek işlem; mağazaya hiçbir şey gitmez. Örnek: `store-import-mapping`.
 
 **Aboneler — üç kaynak:** eski liste (`mobile_purchase_import`, önce `dryRun` — MOB-039) · mağaza bildirimi (katalogdaki

package/dist/resources/schema-fingerprint.json

@@ -1,6 +1,6 @@
 {
-  "hash": "0598b6dcd46ea1951cf067de1e0f3f38b12eaaddc2669205451097bb2a089f90",
-  "generatedAt": "2026-11-02T13:49:36.654Z",
+  "hash": "34361b013283a252757338ed07d8cdcd70294df1c334d35723a9b194c62d1c4b",
+  "generatedAt": "2026-11-03T11:41:34.837Z",
   "types": 377,
   "files": 196,
   "note": "Şemaları üreten backend kaynaklarının parmak izi. Elle düzenlemeyin: 'npm run generate-schemas' yazar, 'npm run schema:check' denetler.",
@@ -9,4 +9,4 @@
     "System.Text.Json.Nodes.JsonNode",
     "System.Text.Json.Nodes.JsonNodeOptions"
   ]
-}
+}

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: <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'] }.`,
+        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 (kare, ≥ 512×512 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/mobileStoreImport.js

@@ -18,7 +18,7 @@ export function registerMobileStoreImportTools(server, platform) {
     const config = platform.config;
     server.registerTool('mobile_store_import_start', {
         title: 'Mağazadan içe aktarmayı başlat',
-        description: "Yayındaki uygulamanın App Store ve Google Play kaydını OKUMAYA başlar (POST mobile-store/{appId}/imports; ADR 0028). Önce bağlantı eşzamanlı doğrulanır (connection { ios: found | not_found | no_access, android: … }, upload anahtarı uyarısı), sonra arka plan işi iki mağazayı okur ve üç kovalı rapor yazar (Gelir · Sen yüklersin · Mağazada kalır). Okuma mağazaya HİÇBİR ŞEY yazmaz, Zeyrek'te de hiçbir şey değişmez — değişiklik yalnız mobile_store_import_apply ile olur. Yalnız ilk derlemeden ÖNCE çalışır: ilk derleme kimliği ve sayaçları kilitler (409 MobileStoreImportLockedException → MOB-037: alanları elle doldurun). Yeni okuma açık eski kaydı vazgeçilmiş sayar. Sonra mobile_store_import_report ile durumu okuyun (state queued → reading → ready).",
+        description: "Yayındaki uygulamanın App Store ve Google Play kaydını OKUMAYA başlar (POST mobile-store/{appId}/imports; ADR 0028). Önce bağlantı eşzamanlı doğrulanır (connection { ios: found | not_found | no_access, android: … }, upload anahtarı uyarısı), sonra arka plan işi iki mağazayı okur ve üç kovalı rapor yazar (Gelir · Sen yüklersin · Mağazada kalır). Okuma mağazaya HİÇBİR ŞEY yazmaz, Zeyrek'te de hiçbir şey değişmez — değişiklik yalnız mobile_store_import_apply ile olur. İlk derlemeden sonra da çalışır: yeniden okuma (yeniden eşleme) ve Uygula her zaman açıktır; ilk derlemenin kilitlediği alanlar (Bundle ID, paket adı, URL şeması, iOS build numarası, Android version code) ve sürüm Zeyrek'teki değerde kalır. Kilitli kimlikten farklı bundleId / packageName verilirse 409 MobileStoreImportLockedException (MOB-037). Yeni okuma açık eski kaydı vazgeçilmiş sayar. Sonra mobile_store_import_report ile durumu okuyun (state queued → reading → ready).",
         inputSchema: {
             applicationId,
             bundleId: z.string().min(1).optional().describe("App Store'daki Bundle ID ('com.anatoli.app'); yalnız Android ise verilmez"),
@@ -34,7 +34,7 @@ export function registerMobileStoreImportTools(server, platform) {
         }
         catch (error) {
             if (error instanceof PlatformApiError && error.status === 409) {
-                throw new PlatformApiError(`${error.message} — MOB-037: ilk derleme Bundle ID / paket adı ve sayaçları kilitledi; içe aktarma artık yapılamaz. Mağaza bilgilerini mobile_store_update ile elle doldurun.`, 409, error.code);
+                throw new PlatformApiError(`${error.message} — MOB-037: verilen Bundle ID / paket adı uygulamanın kilitlediğinden farklı; yeniden eşleme için kilitli Bundle ID / paket adını verin (mobile_store_get ile okunur).`, 409, error.code);
             }
             throw error;
         }
@@ -54,7 +54,7 @@ export function registerMobileStoreImportTools(server, platform) {
     }));
     server.registerTool('mobile_store_import_mapping', {
         title: 'İçe aktarma seçimlerini kaydet',
-        description: "Raporun Zeyrek'e nasıl yazılacağını kaydeder (PUT mobile-store/{appId}/imports/{importId}/mapping; seçimler birleşmez, verilen sözlük kaydı değiştirir — önce mobile_store_import_report ile okuyun). Anahtarlar: scheme (ZORUNLU — URL şeması mağazadan okunamaz, eski uygulamanınki girilir; MOB-041/P-31) · choice.<satır> = apple | play | custom ve custom.<satır> (iki mağazada farklı metin, K6) · skip.<satır> / skip.language.<dil> = true · replace.<satır> = true (ikon, adaptive ön plan ya da öne çıkan görsel yuvası doluysa üzerine yazar; verilmezse mevcut görsel korunur) · target.language.<mağaza>.<dil> = <Zeyrek dili> (eşlenemeyen dilin metnini o dile yazar; eşlenmiş satırı ezmez) · product.<i>.{key, entitlement, period, trial, price, skip} (i = rapordaki ürün sırası; anahtar ve hak ^[a-z][a-z0-9_]{1,63}$) · declaration.<anahtar> = true. Taslak kural ihlaliyle de saklanır: ihlaller yanıtın violations listesinde [{ row, field, code }] döner (choice_required, period_required, price_required, key_taken…) ve mobile_store_import_apply onlar düzelmeden 422 verir. İçe aktarılan ürünün MAĞAZA KİMLİĞİ seçilmez — mağazadan gelir ve kilitlidir (MOB-038).",
+        description: "Raporun Zeyrek'e nasıl yazılacağını kaydeder (PUT mobile-store/{appId}/imports/{importId}/mapping; seçimler birleşmez, verilen sözlük kaydı değiştirir — önce mobile_store_import_report ile okuyun). Anahtarlar: scheme (ZORUNLU — URL şeması mağazadan okunamaz, eski uygulamanınki girilir; MOB-041/P-31) · choice.<satır> = apple | play | custom ve custom.<satır> (iki mağazada farklı metin, K6) · skip.<satır> / skip.language.<dil> = true · replace.<satır> = true (ikon, adaptive ön plan ya da öne çıkan görsel yuvası doluysa üzerine yazar; verilmezse mevcut görsel korunur) · replace.asset.screenshot.<dil>.<cihaz> = true (o yuvadaki ekran görüntüsü setini siler, mağazadakileri yazar; verilmezse mevcutlar korunur ve yuva başına 10 sınırı mevcutları da sayar — taşan satır asset_invalid) · target.language.<mağaza>.<dil> = <Zeyrek dili> (eşlenemeyen dilin metnini o dile yazar; eşlenmiş satırı ezmez) · product.<i>.{key, entitlement, period, trial, price, skip} (i = rapordaki ürün sırası; anahtar ve hak ^[a-z][a-z0-9_]{1,63}$) · declaration.<anahtar> = true. Taslak kural ihlaliyle de saklanır: ihlaller yanıtın violations listesinde [{ row, field, code }] döner (choice_required, period_required, price_required, key_taken…) ve mobile_store_import_apply onlar düzelmeden 422 verir. İçe aktarılan ürünün MAĞAZA KİMLİĞİ seçilmez — mağazadan gelir ve kilitlidir (MOB-038). Raporda existingKey dolu ürün Zeyrek'te aynı mağaza kimliğiyle duran üründür: Uygula yeni ürün açmaz, onu günceller (fiyat, süre, deneme, metin, mağaza modeli); anahtar ve hak Zeyrek'tekidir, product.<i>.key / entitlement yok sayılır; tür farklıysa kind ihlali.",
         inputSchema: {
             applicationId,
             importId,
@@ -69,7 +69,7 @@ export function registerMobileStoreImportTools(server, platform) {
     }));
     server.registerTool('mobile_store_import_apply', {
         title: 'İçe aktarmayı uygula',
-        description: "Onaylanan raporu TEK İŞLEMDE Zeyrek'e yazar (POST mobile-store/{appId}/imports/{importId}/apply): mağaza ayarı, beyanlar (kaynak import), görseller, ürün kataloğu (saklanan mağaza kimlikleriyle, değişiklik beklemez) ve kimlik kilidi; mağaza tabanı farka kaydedilir. Mağazaya HİÇBİR ŞEY gönderilmez. Uygulanmış kayıt yeniden uygulanmaz (409). Sonra: mobile_product_list (içe aktarılan ürünler), yayından önce mobile_store_diff ve ön kontrol P-24…P-31.",
+        description: "Onaylanan raporu TEK İŞLEMDE Zeyrek'e yazar (POST mobile-store/{appId}/imports/{importId}/apply): mağaza ayarı, beyanlar (kaynak import), görseller, ürün kataloğu (saklanan mağaza kimlikleriyle, değişiklik beklemez) ve kimlik kilidi; mağaza tabanı farka kaydedilir. Mağazaya HİÇBİR ŞEY gönderilmez. Uygulanmış kayıt yeniden uygulanmaz (409); yeniden eşleme için (ilk derlemeden sonra da) mobile_store_import_start ile yeni okuma açılır. İlk derlemenin kilitlediği alanlar ve sürüm yazılmaz, Zeyrek'teki değer kalır. Sonra: mobile_product_list (içe aktarılan ürünler), yayından önce mobile_store_diff ve ön kontrol P-24…P-31.",
         inputSchema: { applicationId, importId },
         annotations: writes
     }, handle(config, async ({ applicationId: appId, importId: id }) => importReportOutline(unwrap(await platform.org('POST', `/mobile-store/${appId}/imports/${id}/apply`)))));

package/package.json

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