@appaflytech/zeyrek-ai-mcp 0.0.40 → 0.0.42

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (60) hide show
  1. package/dist/knowledge/componentCatalog.js +95 -104
  2. package/dist/knowledge/componentEvents.js +34 -18
  3. package/dist/knowledge/mobileComponentCatalog.js +119 -20
  4. package/dist/knowledge/mobileComponentEvents.js +41 -0
  5. package/dist/knowledge/motionResolve.js +252 -0
  6. package/dist/knowledge/normalize.js +117 -71
  7. package/dist/knowledge/pageDiscover.js +2 -2
  8. package/dist/knowledge/platform/batchOps.js +70 -0
  9. package/dist/knowledge/platform/heroTag.js +153 -0
  10. package/dist/knowledge/platform/lint.js +128 -6
  11. package/dist/knowledge/platform/mobile.js +1 -1
  12. package/dist/knowledge/platform/mobileLayoutLint.js +8 -1
  13. package/dist/knowledge/platform/mobileRules.js +18 -0
  14. package/dist/knowledge/platform/pageTransition.js +57 -0
  15. package/dist/knowledge/platform/web.js +1 -1
  16. package/dist/knowledge/rules.js +217 -24
  17. package/dist/knowledge/styleResolve.js +0 -1
  18. package/dist/knowledge/styleResolveNative.js +88 -4
  19. package/dist/platform/capture/actions.js +27 -1
  20. package/dist/platform/capture/capture.js +10 -13
  21. package/dist/platform/capture/persistent-browser.js +130 -0
  22. package/dist/platform/capture/summary.js +4 -1
  23. package/dist/resources/examples/flow-list-to-form.json +8 -10
  24. package/dist/resources/examples/flow-load-table.json +1 -1
  25. package/dist/resources/examples/mobile-app-shell-drawer.json +1 -0
  26. package/dist/resources/examples/mobile-list-detail-form.json +7 -3
  27. package/dist/resources/examples/mobile-scan-code.json +285 -0
  28. package/dist/resources/guides/component.md +3 -3
  29. package/dist/resources/guides/entity.md +16 -0
  30. package/dist/resources/guides/expressions.md +8 -7
  31. package/dist/resources/guides/merge.md +98 -18
  32. package/dist/resources/guides/microservice.md +3 -3
  33. package/dist/resources/guides/middleware.md +2 -0
  34. package/dist/resources/guides/mobile-layout.md +2 -1
  35. package/dist/resources/guides/mobile-publish.md +1 -0
  36. package/dist/resources/guides/mobile-steps.md +67 -0
  37. package/dist/resources/guides/mobile.md +51 -70
  38. package/dist/resources/guides/page.md +229 -137
  39. package/dist/resources/guides/translation.md +67 -1
  40. package/dist/resources/guides/workflow.md +31 -1
  41. package/dist/resources/schema-fingerprint.json +2 -2
  42. package/dist/resources/schemas/ResolveMergeConflictsCommand.json +30 -1
  43. package/dist/tools/activities.js +3 -1
  44. package/dist/tools/applications.js +16 -2
  45. package/dist/tools/components.js +12 -6
  46. package/dist/tools/designSchemaPatch.js +18 -13
  47. package/dist/tools/entities.js +41 -4
  48. package/dist/tools/layouts.js +29 -9
  49. package/dist/tools/merges.js +29 -9
  50. package/dist/tools/mobile.js +15 -1
  51. package/dist/tools/pages.js +156 -168
  52. package/dist/tools/platformInfo.js +3 -2
  53. package/dist/tools/profileWrite.js +2 -2
  54. package/dist/tools/queries.js +1 -1
  55. package/dist/tools/rows.js +14 -3
  56. package/dist/tools/schemaOps.js +132 -34
  57. package/dist/tools/screenWrite.js +3 -3
  58. package/dist/tools/screens.js +42 -3
  59. package/dist/tools/translations.js +148 -6
  60. package/package.json +2 -2
@@ -1,16 +1,16 @@
1
1
  import { guid, projectParam, environmentParam, pagingParams, asUserIdParam, readOnly, writes, updates, destructive, microOps, isBranchName, branchSlug } from './common.js';
2
- import { orphanedFlowWarnings, orphanedFlowPlan, orphanedFlowMessage, boundEventOps, stripGatewayEventFields, staleSetterWarnings, lostSetterTargets, fillComponentNames, componentNameNote, normalizeComponentDefaults, normalizeSchemaOps, schemaOpValidationErrors, codePropTemplateErrors, addComponentIdErrors, missingBlocksNodes, assertAddComponentIds, assertComponentBlocks, validationNote, componentDefaultsNote, replacePropNote, ensurePageContainer, retargetRootAdds, rootAddsNote, flexSizeWarnings, spacingLayerWarnings, reorderSchemaBlocks, reorderNote, nestedRepeaterNodes, nestedRepeaterMessage, stringStyleNodes, stringStyleWarning, inertFlexPropNodes, inertFlexPropWarning, FLEX_LAYOUT_PROP_NAMES, resetPageContainerPosition, pageContainerPositionWarning, verticalGapWarnings, flexIndexOrder, flexIndexOrderNote, withNormalization, parseVariableEntries, PAGE_CONTAINER_ELEMENT_ID } from '../knowledge/normalize.js';
2
+ import { orphanedFlowWarnings, orphanedFlowPlan, orphanedFlowMessage, boundEventOps, stripGatewayEventFields, staleSetterWarnings, lostSetterTargets, fillComponentNames, componentNameNote, normalizeComponentDefaults, normalizeSchemaOps, schemaOpValidationErrors, codePropTemplateErrors, addComponentIdErrors, missingBlocksNodes, retiredTypeNodes, assertNoRetiredNodes, validationNote, componentDefaultsNote, replacePropNote, ensurePageContainer, retargetRootAdds, rootAddsNote, flexSizeWarnings, spacingLayerWarnings, reorderSchemaBlocks, reorderNote, nestedRepeaterNodes, nestedRepeaterMessage, stringStyleNodes, stringStyleWarning, inertFlexPropNodes, inertFlexPropWarning, FLEX_LAYOUT_PROP_NAMES, resetPageContainerPosition, pageContainerPositionWarning, verticalGapWarnings, flexIndexOrder, flexIndexOrderNote, withNormalization, parseVariableEntries, PAGE_CONTAINER_ELEMENT_ID, screenEventsNeedPlatform } from '../knowledge/normalize.js';
3
3
  import { functionSignature } from '../knowledge/functionGuards.js';
4
4
  import { attachFindings } from '../knowledge/policy.js';
5
- import { fetchHost, pageUpdateBody, schemaParam, eventsParam, unwrap, modeParam, summarize, findNode, flowPath, countSchemaNodes, missingElementIds, splitSchemaIntoParts, encodeSchemaCursor, decodeSchemaCursor } from './screens.js';
5
+ import { fetchHost, pageUpdateBody, schemaParam, eventsParam, unwrap, modeParam, summarize, findNode, flowPath, countSchemaNodes, missingElementIds, readFullSchema } from './screens.js';
6
6
  import { fetchComponentEventNames } from './components.js';
7
- import { assertComponentNames, assertScreenWriteGuards, screenCatalogNotes, assertScreenCatalog } from './screenWrite.js';
8
- import { opsParam, writeViewParam, outlineWriteResponse, unknownEventOps, collectTypes, styleTargetTypes, simulateLayoutOps, applySkeletonOps, reshapesSkeleton, planEventRemovals, resizeServerOps, planResizes, planPropTypes, rejectedOpsMessage } from './schemaOps.js';
7
+ import { assertScreenWriteGuards, screenCatalogNotes, assertScreenCatalog } from './screenWrite.js';
8
+ import { opsParam, writeViewParam, outlineWriteResponse, unknownEventOps, collectTypes, simulateLayoutOps, applySkeletonOps, reshapesSkeleton, planEventRemovals, callerSlots, planEmulatedOps, recordsWithEventRemovals, serverOpsInOrder, rejectedOpsMessage } from './schemaOps.js';
9
9
  import { formBindingWarnings, formSubmitButtonWarnings } from '../knowledge/coverage.js';
10
10
  import { emptyWriteDiff, schemaOpDrops, unwrapProps, withWriteDiff, writeDiff } from '../platform/writeDiff.js';
11
11
  import { PlatformApiError } from '../platform/errors.js';
12
12
  import { existingMatch, ifExistsParam, listAll, withOutcome } from '../platform/ifExists.js';
13
- import { handle, toolResult, toolError, prune } from '../platform/responses.js';
13
+ import { handle, toolResult, toolError } from '../platform/responses.js';
14
14
  import { expressionErrorsNote, runtimeErrorsNote, StudioScreenshotter } from '../platform/capture/index.js';
15
15
  import { captureTargetFor } from '../platform/capture/target.js';
16
16
  import { diffSummaries, summaryLines, summaryStats } from '../platform/domSummary.js';
@@ -30,6 +30,9 @@ import { boxSectionNote, collectIds, ensureBoxSections, expandSectionToggles } f
30
30
  import { designSnapshotInput } from '../knowledge/designSnapshot.js';
31
31
  import { discoverPage } from '../knowledge/pageDiscover.js';
32
32
  import { applicationTypeField, resolveProfile, resolveProfileBySlug } from '../knowledge/platform/resolve.js';
33
+ import { batchEnvelopeNote, batchIndexHint, openBatchEnvelopes } from '../knowledge/platform/batchOps.js';
34
+ import { heroTags } from '../knowledge/platform/heroTag.js';
35
+ import { profileLintReadsSavedNodes } from '../knowledge/platform/lint.js';
33
36
  import { resolveThemeNative } from '../knowledge/styleResolveNative.js';
34
37
  import { boundFlowSteps, pageLayoutWarnings, screenProfileWarnings } from './profileWrite.js';
35
38
  import { applyMobileSpacingDefaults, applyMobileSpacingToOps, emptyMobileSpacingFix, mobileSpacingNote } from '../knowledge/platform/mobileSpacing.js';
@@ -76,7 +79,8 @@ async function fetchPage(platform, project, environment, applicationId, pageId)
76
79
  * Platformun sayfa micro-op sözlüğü (`PageSchemaMicroOpApplier.KnownOps`). Gateway'in sunucuya
77
80
  * ilettiği op'lar yalnız bunlardır; `test/page-micro-op-parity.test.ts` listeyi backend ve
78
81
  * `@ng-apps/screen-builder` ile karşılaştırır. `resize_component` gateway adıdır ve sunucuya
79
- * `set_block` + `set_appearance` + `set_states` olarak çevrilir.
82
+ * `set_block` + `set_appearance` + `set_states` olarak çevrilir. `batch` sözlüktedir ama iletilmez:
83
+ * zarf araç girişinde açılır (PAGE-048).
80
84
  */
81
85
  export const SERVER_PAGE_OPS = [
82
86
  'replace_prop', 'set_binding', 'set_prop_type', 'add_component', 'remove_component', 'move_component', 'reorder', 'set_block',
@@ -171,7 +175,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
171
175
  }));
172
176
  server.registerTool('page_runtime_get', {
173
177
  title: 'Sayfanın runtime çıktısını getir',
174
- description: "Çıkan uygulamanın sayfa için aldığı GERÇEK paketi döner (GET /{project}/{application}/p/{slug} — sayfanın ham serve yolu budur; Studio preview ve runtime aynı ucu tüketir): sayfa şeması + layout views'ü + sayfa olayları + flow'lar + değişken anahtarları (variableKeys: middleware değişkenleri, pageVariableKeys/appVariableKeys: state.page/state.app anahtarları) + kullanıcı fonksiyonu imzaları (appFunctions/pageFunctions — bir ifadeye Functions.<ad>(…) yazmadan önce adı ve parametre sırasını buradan alın; gövde taşınmaz, function_get ile okunur). Kurduğun sayfanın SON hâlini doğrulamanın yolu budur (layout-slot yerleşimi dahil — Kural 1f). DİKKAT: sayfaya bağlı middleware'ler bu çağrıda GERÇEKTEN koşar; middleware reddederse yanıt middlewareBlocked ile döner — korumalı sayfada bu beklenen davranıştır ve kendisi bir doğrulamadır. Kompleks projede yanıta 'accessDecision' eklenir (allow | deny | not-enforced | unknown, mode, izin, reason, next): sayfa reddi page.view kararından mı geldi, sıradaki adım ne.",
178
+ description: "Çıkan uygulamanın sayfa için aldığı GERÇEK paketi döner (GET /{project}/{application}/p/{slug} — sayfanın ham serve yolu budur; Studio preview ve runtime aynı ucu tüketir): sayfa şeması + layout views'ü + sayfa olayları + flow'lar + değişken anahtarları (variableKeys: middleware değişkenleri, pageVariableKeys/appVariableKeys: state.page/state.app anahtarları) + kullanıcı fonksiyonu imzaları (appFunctions/pageFunctions — bir ifadeye Functions.<ad>(…) yazmadan önce adı ve parametre sırasını buradan alın; gövde taşınmaz, function_get ile okunur). Kurduğun sayfanın SON hâlini doğrulamanın yolu budur (layout-slot yerleşimi dahil — Kural 1f). DİKKAT: sayfaya bağlı middleware'ler bu çağrıda GERÇEKTEN koşar; middleware reddederse yanıt middlewareBlocked ile döner — korumalı sayfada bu beklenen davranıştır ve kendisi bir doğrulamadır. Kompleks projede yanıta 'accessDecision' eklenir (allow | deny | not-enforced | unknown, mode, izin, reason, next): sayfa reddi page.view kararından mı geldi, sıradaki adım ne. Mobil sayfada heroTag taşıyan düğümler `heroTags`'te listelenir (layout'unkiler dahil; statik etiket metniyle, ifadeye bağlı olan `bound: true` ile): paylaşılan öğe çiftini kurarken iki sayfanın özetini buradan karşılaştırın (platform_guide('page') §Kural 1g-3).",
175
179
  inputSchema: {
176
180
  project: projectParam,
177
181
  environment: environmentParam,
@@ -224,6 +228,9 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
224
228
  const nativeTheme = resolveStyles && runtimeApplication.type === 'mobile' ? resolveThemeNative((theme ?? undefined)) : undefined;
225
229
  // Mobilde de tema katmanı (componentStyles ← $preset) çizerin tabanıdır (f-16); rapor aynı kaynağı okur.
226
230
  const nodeStyleSource = styleSource;
231
+ // Paylaşılan öğe etiketleri (frontend ADR 0022, MOB-030): iki sayfanın özeti karşılaştırılarak çift kurulur.
232
+ // Layout'un düğümleri de cihazda çizilir (başlıktaki logo); listede önce onlar gelir.
233
+ const pageHeroTags = runtimeApplication.type === 'mobile' ? [...heroTags(layout?.views), ...heroTags(body.schema)] : [];
227
234
  return {
228
235
  ...(decision ? { accessDecision: decision } : {}),
229
236
  page: { id: body.id, name: body.name, slug: body.slug, browserTitle: body.browserTitle, browserTitleKey: body.browserTitleKey, isHomepage: body.isHomepage },
@@ -231,6 +238,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
231
238
  events: body.events ?? [],
232
239
  layout: layout ? { id: layout.id, name: layout.name, views: asNodes(layout.views).map(node => summarize(node, nodeStyleSource, nativeTheme)) } : null,
233
240
  schema: asNodes(body.schema).map(node => summarize(node, nodeStyleSource, nativeTheme)),
241
+ ...(pageHeroTags.length > 0 ? { heroTags: pageHeroTags } : {}),
234
242
  ...(nativeTheme ? { styleResolver: 'native' } : {}),
235
243
  widgets: named(body.widgets),
236
244
  flows: named(body.flows),
@@ -251,7 +259,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
251
259
  }
252
260
  : {}),
253
261
  note: nativeTheme
254
- ? "Mobil uygulama: nativeStyle, mobil çizerin düğüme verdiği React Native stilidir — shell kutunun, text içine akan metnin stili (RN'de tipografi miras alınmaz); warnings mobilde çizilmeyen değerlerdir (MOB-002). Tema componentStyles ← $preset katmanı TABANDIR (panel grupları üstüne biner, serbest style son söz); mobil katalogda style prop'u olmadığı için $preset'e yeni başvuru yazılamaz, componentStyles tipin bütün düğümlerine iner."
262
+ ? "Mobil uygulama: nativeStyle, mobil çizerin düğüme verdiği React Native stilidir — shell kutunun, text içine akan metnin stili (RN'de tipografi miras alınmaz); warnings mobilde çizilmeyen değerlerdir (MOB-002; hareket alanları MOB-028). bound (yalnız varsa) değeri çalışma anında oluşan, ifadeye bağlı stil alanlarıdır (<grup>.<alan>) — stile girmezler. motion (yalnız hareketli düğümde) motionStyle'ın /dev ve cihazdaki çözümüdür; kanvas ve page_screenshot'ın donuk karesi uygulamaz. Tema componentStyles ← $preset katmanı TABANDIR (panel grupları üstüne biner, serbest style son söz); mobil katalogda style prop'u olmadığı için $preset'e yeni başvuru yazılamaz, componentStyles tipin bütün düğümlerine iner."
255
263
  : resolveStyles
256
264
  ? "schema, layout'taki slot'un İÇİNE yerleşerek çizilir (Kural 1f). resolvedStyle = componentStyles → preset → düğüm stili kaskadı (aibox'ta tipli grupların derlemesi TABAN katmandır); styleLayers hangi katmanların konuştuğunu söyler — styleLayers.componentPreset ise CSS DEĞİL, düğümün hangi bileşen preseti versiyonundan kurulduğunun işaretidir."
257
265
  : "schema, layout'taki slot'un İÇİNE yerleşerek çizilir (Kural 1f); tam gövde gerekirse view:'full'. Bir düğümün ekranda GERÇEKTEN aldığı stili görmek için resolveStyles:true."
@@ -267,7 +275,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
267
275
  project: projectParam,
268
276
  environment: environmentParam,
269
277
  applicationSlug: z.string().min(1).describe("Uygulamanın slug'ı (application_list / project_overview)"),
270
- pageSlug: z.string().min(1).describe("Sayfanın slug'ı (page_list)"),
278
+ pageSlug: z.string().min(1).describe("Sayfanın slug'ı (page_list); sayfa parametresi sorguyla verilebilir: 'ilac-detay?id=7' (language '&lang=' olarak eklenir)"),
271
279
  viewport: z.object({
272
280
  width: z.number().int().min(320).max(3840),
273
281
  height: z.number().int().min(240).max(2160)
@@ -359,7 +367,14 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
359
367
  throw new PlatformApiError("page_screenshot: asUserId ile cookies birlikte verilemez — uygulama oturum çerezi (ZY_App_…) geçerliyse platform başlığı değil çerezin sahibini özne yapar ve karenin kimin gözüyle çekildiği belirsiz kalır.");
360
368
  }
361
369
  const eye = await impersonationHeaders(platform, 'page_screenshot', project, environment, { asUserId, asUser, anonymous }, { runtime: true });
362
- const url = `${config.studioBaseUrl}/${lane}/${projectSlug}/${applicationSlug}/${pageSlug}${languageChoice ? `?lang=${languageChoice.code}` : ''}`;
370
+ // 37 S-17 / 38 S-13: sorgulu slug (`ilac-detay?id=7`) dizeyle birleşince dil ikinci bir '?' ile
371
+ // ekleniyordu ve runtime `id`'yi '7?lang=tr' okudu; sayfa isteği işareti de sorguyu taşıdığı
372
+ // için sayfanın kendi veri isteğiyle hiç eşleşmiyordu.
373
+ const address = new URL(`${config.studioBaseUrl}/${lane}/${projectSlug}/${applicationSlug}/${pageSlug}`);
374
+ if (languageChoice)
375
+ address.searchParams.set('lang', languageChoice.code);
376
+ const url = address.toString();
377
+ const pagePath = pageSlug.split(/[?#]/, 1)[0];
363
378
  // Hedef ve cihaz uygulamanın platform profilinden (G3): mobil uygulama react-native-web
364
379
  // çizimidir, varsayılan kare telefon ön ayarıdır. Tip okunamazsa web davranışı aynen.
365
380
  const resolved = await resolveProfileBySlug(platform, projectSlug, applicationSlug);
@@ -384,7 +399,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
384
399
  const cookieNames = [...new Set([...(identity === 'anonymous' ? [] : ['NG_AccessToken']), ...extraCookies.map(cookie => cookie.name)])];
385
400
  const shot = await screenshotter.capture({
386
401
  url,
387
- apiPathMarker: `/${applicationSlug}/p/${pageSlug}`,
402
+ apiPathMarker: `/${applicationSlug}/p/${pagePath}`,
388
403
  token: identityToken,
389
404
  ...(eye ? { headers: eye } : {}),
390
405
  ...(extraCookies.length > 0 ? { cookies: extraCookies } : {}),
@@ -657,41 +672,17 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
657
672
  throw new PlatformApiError(`cursor yalnız mode:'full' ile çalışır (verilen mode: '${mode ?? 'summary'}'); parçalı okuma tüm şema içindir. mode:'full' ile cursor:'0' verin ya da cursor'ı kaldırın.`, 400);
658
673
  }
659
674
  if (mode === 'full') {
660
- const schema = page.schema ?? [];
661
- const nodeCount = countSchemaNodes(schema);
662
- const versionKey = String(version ?? '');
663
- if (cursor !== undefined) {
664
- const decoded = decodeSchemaCursor(cursor);
665
- if (!decoded)
666
- throw new PlatformApiError(`cursor '${cursor}' çözülemedi; cursor yalnız '0' ya da önceki yanıttaki nextCursor olabilir. cursor:'0' ile baştan başlayın.`, 400);
667
- if (decoded.version !== undefined && decoded.version !== versionKey) {
668
- throw new PlatformApiError(`Sayfa bu cursor alındıktan sonra değişti (cursor sürümü '${decoded.version}', güncel sürüm '${versionKey}'); eski parçalarla yenileri birleştirilirse şema tutarsız olur. Toplanan parçaları atın ve cursor:'0' ile baştan okuyun.`, 409);
669
- }
670
- const parts = splitSchemaIntoParts(schema, Math.floor(config.maxResponseBytes * 0.75));
671
- const items = parts[decoded.partIndex];
672
- if (!items)
673
- throw new PlatformApiError(`cursor '${cursor}' ${decoded.partIndex}. parçayı istiyor ama şema ${parts.length} parça; son parçadan sonra nextCursor gelmez. cursor:'0' ile baştan başlayın.`, 400);
674
- const nextIndex = decoded.partIndex + 1;
675
- return {
676
- version,
677
- updatedAt,
678
- ...typeField,
679
- nodeCount,
680
- part: { index: decoded.partIndex, count: parts.length, nodes: countSchemaNodes(items.map(item => item.node)) },
681
- items,
682
- ...(nextIndex < parts.length ? { nextCursor: encodeSchemaCursor(versionKey, nextIndex) } : {})
683
- };
684
- }
685
- const full = { version, updatedAt, ...typeField, nodeCount, schema };
686
- const chars = (JSON.stringify(prune(full)) ?? '').length;
687
- if (chars > config.maxResponseBytes) {
688
- if (allowTruncated !== true) {
689
- const kb = (value) => (value / 1024).toFixed(1);
690
- throw new PlatformApiError(`Şema ${nodeCount} düğüm / ${kb(chars)} KB; tek yanıta sığmaz (bütçe ${kb(config.maxResponseBytes)} KB). Kırpılmış şema hangi düğümlerin düştüğünü söylemez ve geri yazılırsa sayfa eksilir. cursor:'0' ile parça parça okuyun ya da allowTruncated:true verin (kırpılır, hangi düğümlerin düştüğü söylenmez). Hedef bulmak için mode:'summary' yeter.`, 400);
691
- }
692
- schemaReadMemory.markTruncated(readKey(project, environment, pageId, version));
693
- }
694
- return full;
675
+ return readFullSchema({
676
+ noun: 'Sayfa',
677
+ field: 'schema',
678
+ nodes: page.schema ?? [],
679
+ versionKey: String(version ?? ''),
680
+ base: { version, updatedAt, ...typeField },
681
+ cursor,
682
+ allowTruncated,
683
+ maxResponseBytes: config.maxResponseBytes,
684
+ onTruncated: () => schemaReadMemory.markTruncated(readKey(project, environment, pageId, version))
685
+ });
695
686
  }
696
687
  if (mode === 'subtree') {
697
688
  if (!componentId)
@@ -709,98 +700,20 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
709
700
  inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, pageId: guid },
710
701
  annotations: readOnly
711
702
  }, handle(config, ({ project, environment, applicationId, pageId }) => platform.tenant('GET', project, `/pages/${applicationId}/${pageId}/ai-context`, { environment })));
712
- server.registerTool('page_schema_validate', {
713
- title: 'Sayfa şemasını doğrula (kuru çalıştırma)',
714
- 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. Gövdeye page_schema_patch ile AYNI normalizasyonu uygular (Prop sarmalı, validation biçimi) — kuru koşu ile yazma aynı gövdeyi görür.",
715
- 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") },
716
- annotations: readOnly
717
- }, handle(config, async ({ project, environment, applicationId, pageId, ops, operations }) => {
718
- const allOps = microOps('page_schema_validate', ops, operations).map(op => op);
719
- const propTypeIssues = setPropTypeErrors(allOps.filter(entry => entry.op === 'set_prop_type'));
720
- if (propTypeIssues.length > 0)
721
- throw new PlatformApiError(`set_prop_type gövdesi eksik (istek gönderilmedi): ${propTypeIssues.join(' · ')}`, 400);
722
- // Kuru koşu ile yazma AYNI gövdeyi görür (P0-2 Step 3): resize_component burada da sunucu
723
- // op'larına çevrilir, platform dokunulan düğümleri aynı kapsamla doğrular.
724
- const opRecords = allOps.filter(entry => entry.op !== 'resize_component');
725
- const resolved = await resolveProfile(platform, applicationId);
726
- // ARC-143: kuru koşu page_schema_patch'in add_component kapısını (PAGE-009 · 011 · 012 · 013)
727
- // atlıyordu; ayrılmış adlı komponent validate'ten geçip yamada reddediliyordu.
728
- assertScreenWriteGuards('page', { schema: opRecords.filter(entry => entry.op === 'add_component').map(entry => entry.component) }, resolved.profile.platform);
729
- const readPage = () => fetchPage(platform, project, environment, applicationId, pageId);
730
- const normalized = normalizeSchemaOps(opRecords, await styleTargetTypes(opRecords, readPage));
731
- const added = opRecords.filter(entry => entry.op === 'add_component').map(entry => entry.component).filter(Boolean);
732
- // page_schema_patch'in sırası: kimlik ve blocks op başına (PAGE-037), sonra ad (PAGE-009).
733
- assertAddComponentIds(opRecords);
734
- assertComponentBlocks(added);
735
- assertComponentNames('page', added);
736
- const validationIssues = [
737
- ...schemaOpValidationErrors(opRecords).map(issue => `PAGE-016 — ${issue}`),
738
- ...codePropTemplateErrors(opRecords).map(issue => `PAGE-032 — ${issue}`)
739
- ];
740
- const spacing = await mobileSpacingForOps(resolved.profile.platform, opRecords, () => fetchPage(platform, project, environment, applicationId, pageId));
741
- const ordering = resolved.profile.layout.orderBy === 'block-position'
742
- ? await orderByIndex(opRecords, () => fetchPage(platform, project, environment, applicationId, pageId))
743
- : { ops: opRecords, moved: [], warnings: [] };
744
- const writesStyle = resolved.profile.platform !== 'web' && opRecords.some(entry => (entry.op === 'replace_prop' || entry.op === 'set_binding') && entry.prop === 'style');
745
- const profileWarnings = await screenProfileWarnings(platform, resolved, project, environment, applicationId, {
746
- kind: 'page',
747
- ops: opRecords,
748
- savedNodes: writesStyle ? await fetchPage(platform, project, environment, applicationId, pageId).then(page => page.schema, () => undefined) : undefined
749
- });
750
- // page_schema_patch'in Connect Data duvarı kuru koşuda da koşar: patch'in reddedeceği op burada görünür.
751
- const connectedProps = opRecords.some(entry => ['set_binding', 'set_prop_type', 'replace_prop', 'set_connect_data', 'remove_connect_data'].includes(String(entry.op)))
752
- ? await fetchPage(platform, project, environment, applicationId, pageId).then(page => connectedPropKeys(page.schema), () => null)
753
- : null;
754
- const connectDataRejections = opRecords.flatMap((entry, index) => connectDataOpIssues(entry, connectedProps).map(issue => ({
755
- index,
756
- op: String(entry.op ?? ''),
757
- target: typeof entry.target === 'string' ? entry.target : null,
758
- code: issue.code,
759
- message: issue.message
760
- })));
761
- // Yazmadaki gibi katalog kuralları GİDEN listeye: kuru koşu kırpılmamış boyutu doğrulayıp
762
- // yazmanın geçireceği gövdeye hata veriyor, notu da vermiyordu (Y-13 C).
763
- const catalogNotes = await screenCatalogNotes(platform, project, environment, applicationId, ordering.ops.filter(entry => entry.op === 'add_component').map(entry => entry.component));
764
- const response = ((await platform.tenant('POST', project, `/pages/${applicationId}/${pageId}/schema/validate`, {
765
- environment,
766
- body: { ops: [...allOps.filter(entry => entry.op === 'resize_component').flatMap(resizeServerOps), ...ordering.ops] }
767
- })) ?? {});
768
- const skeletonWarnings = await simulatedPageLayoutWarnings(platform, resolved, project, environment, applicationId, () => fetchPage(platform, project, environment, applicationId, pageId), opRecords, 'audit');
769
- if (validationIssues.length > 0)
770
- response.validationWarnings = validationIssues;
771
- if (ordering.warnings.length > 0 || profileWarnings.length > 0 || skeletonWarnings.length > 0)
772
- response.layoutWarnings = [...ordering.warnings, ...profileWarnings, ...skeletonWarnings];
773
- if (connectDataRejections.length > 0)
774
- response.rejectedOps = connectDataRejections;
775
- Object.assign(response, applicationTypeField(resolved));
776
- return withNormalization(response, [
777
- ...componentNameNote(normalized.names),
778
- ...componentDefaultsNote(normalized.components),
779
- ...validationNote(normalized.validations),
780
- ...catalogNotes,
781
- ...replacePropNote(normalized.props),
782
- ...flexIndexOrderNote(ordering.moved),
783
- ...mobileSpacingNote(spacing)
784
- ]);
785
- }));
786
- server.registerTool('page_schema_patch', {
787
- title: 'Sayfa şemasına patch uygula',
788
- description: "Micro-op'ları doğrulama duvarından geçirip TEK PATCH ile kaydeder; açık studio canvas'ları SignalR ile canlı güncellenir. İstek atomiktir: bir op reddedilirse hiçbiri yazılmaz. baseVersion (page_schema_get çıktısındaki version ya da önceki yamanın newVersion'ı) verilirse sayfa o sürümden beri değişmişse 409 döner ve hiçbir op uygulanmaz (stale plan koruması); verilmezse gateway yalnız bu çağrıda zaten okuduğu sayfanın sürümünü gönderir. Yanıttaki appliedPatch, her op'un şemada tam olarak hangi JSON Pointer'a dokunduğunu söyler; gövdesi VARSAYILAN OLARAK iskelettir (eklenen düğüm id/type/children'a iner) — tam gövde için view:'full'. Op'un gerçekten kaydedilip kaydedilmediğini gövde değil silentlyDropped söyler. Gateway ön kontrolleri (PAGE-006/008/016/032, set_prop_type gövdesi, move_component size) op başına toplanır: düşen HER op tek hata yanıtında rejectedOps[] ({ index, op, target, code, message }) ile listelenir ve hiçbir op gönderilmez — hepsini düzeltip listeyi bir kez yeniden gönderin.",
789
- inputSchema: {
790
- project: projectParam,
791
- environment: environmentParam,
792
- applicationId: guid,
793
- pageId: guid,
794
- ops: opsParam.optional(),
795
- operations: opsParam.optional().describe("'ops' ile aynı alan (eşanlamlı) — entity/microservice/workflow patch'leriyle aynı adı kullanabilmeniz için"),
796
- 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"),
797
- expectedUpdatedAt: z.string().optional().describe("Eski koruma: page_schema_get çıktısındaki updatedAt; eşleşmezse patch uygulanmaz. baseVersion tercih edilir"),
798
- 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."),
799
- view: writeViewParam
800
- },
801
- annotations: updates
802
- }, handle(config, async ({ project, environment, applicationId, pageId, ops, operations, baseVersion, expectedUpdatedAt, allowFlowDeletion, view }) => {
803
- const allOps = microOps('page_schema_patch', ops, operations).map(op => op);
703
+ /**
704
+ * Sayfa şemasına yazımın PLANI — `page_schema_patch` ve `page_schema_validate` aynısını koşar: ön kontroller, onarım,
705
+ * öykünülen op'ların çevrilmesi, platforma gidecek liste, uyarılar. Kuru koşu yazımla AYNI kararı verir (yazımın
706
+ * reddedeceği yamayı aynı mesajla reddeder) ve platforma AYNI gövdeyi doğrulatır; fark yalnız gönderilen istekte.
707
+ *
708
+ * İki işleyici ayrı yazılmıştı ve ayrışmıştı (TOOL-059, ölçüldü 2026-10-10, gerçek uç): kuru koşu
709
+ * `remove_component page_container`'a `valid: true` diyor, yazım aynı op'u PAGE-006 ile reddediyordu; kuru koşu
710
+ * PAGE-034 · PAGE-008 · MOVE-SIZE kapılarını, akış silme planını (G-21), yama sonrası iç içe tekrarlayıcıyı (PAGE-013),
711
+ * kök eklemenin taşınmasını ve `resize_component` planını da koşmuyordu. Emsal: ARC-143, `page-meta.test.ts`
712
+ * "validate = yazma". Regresyon: `test/page-dry-run-parity.test.ts`.
713
+ */
714
+ const planPageWrite = async (tool, { project, environment, applicationId, pageId, ops, operations, expectedUpdatedAt, allowFlowDeletion }) => {
715
+ const opened = openBatchEnvelopes(tool, microOps(tool, ops, operations).map(op => op));
716
+ const allOps = opened.ops;
804
717
  const removeEventOps = allOps.filter(entry => entry.op === 'remove_event');
805
718
  const resizeOps = allOps.filter(entry => entry.op === 'resize_component');
806
719
  const propTypeOps = allOps.filter(entry => entry.op === 'set_prop_type');
@@ -843,14 +756,16 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
843
756
  const toggles = expandSectionToggles(opRecords, schema, taken);
844
757
  sectionNotes = boxSectionNote([...created, ...toggles.created], toggles.removed);
845
758
  }
846
- const normalized = normalizeSchemaOps(opRecords, await styleTargetTypes(opRecords, readPage));
759
+ const normalized = normalizeSchemaOps(opRecords);
847
760
  for (const entry of opRecords)
848
761
  reject('PAGE-016', entry, schemaOpValidationErrors([entry]));
849
762
  for (const entry of opRecords)
850
763
  reject('PAGE-032', entry, codePropTemplateErrors([entry]));
851
764
  for (const entry of opRecords)
852
765
  reject('PAGE-037', entry, [...addComponentIdErrors([entry]), ...(entry.op === 'add_component' ? missingBlocksNodes([entry.component]) : [])]);
853
- const touchesConnection = opRecords.some(entry => entry.op === 'set_binding' || entry.op === 'set_prop_type' || entry.op === 'replace_prop' || entry.op === 'remove_connect_data');
766
+ for (const entry of opRecords)
767
+ reject('PAGE-051', entry, entry.op === 'add_component' ? retiredTypeNodes([entry.component]) : []);
768
+ const touchesConnection = propTypeOps.length > 0 || opRecords.some(entry => entry.op === 'set_binding' || entry.op === 'replace_prop' || entry.op === 'remove_connect_data');
854
769
  let connectedProps = null;
855
770
  if (touchesConnection) {
856
771
  try {
@@ -860,7 +775,8 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
860
775
  connectedProps = null;
861
776
  }
862
777
  }
863
- for (const entry of opRecords) {
778
+ // `set_prop_type` ayrı listededir; bağlı prop'u ezen yazımı (CD-005) o da yapar.
779
+ for (const entry of [...opRecords, ...propTypeOps]) {
864
780
  for (const issue of connectDataOpIssues(entry, connectedProps))
865
781
  reject(issue.code, entry, [issue.message]);
866
782
  }
@@ -881,7 +797,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
881
797
  reject('PAGE-008', entry, unknownEventOps([entry], typesByElementId, eventsBySlug));
882
798
  }
883
799
  if (rejected.length > 0)
884
- throw new PlatformApiError(rejectedOpsMessage(rejected), 400);
800
+ throw new PlatformApiError(rejectedOpsMessage(rejected, batchIndexHint(opened)), 400);
885
801
  stripGatewayEventFields(opRecords);
886
802
  const wantsRootAdd = opRecords.some(entry => entry.op === 'add_component' && (entry.parent === undefined || entry.parent === null || entry.parent === 'root'));
887
803
  let retargeted = [];
@@ -899,16 +815,17 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
899
815
  ? await orderByIndex(opRecords, readPage)
900
816
  : { ops: opRecords, moved: [], warnings: [] };
901
817
  const sentOps = ordering.ops;
818
+ // Bu noktadan sonra `opRecords` yeni op almaz (bölüm anahtarı yukarıda eklendi): çağıranın sırası sabittir.
819
+ const slots = callerSlots(allOps, opRecords);
902
820
  // Akış silen op'lar yamadan ÖNCE hesaplanır: uyarı sonradan geldiğinde akış zaten kalıcı
903
821
  // silinmiş oluyordu ve "önce yedekle" tavsiyesi uygulanamıyordu (09-05 koşusu, G-21).
904
822
  let deletedFlows = [];
905
823
  // remove_event opRecords'ta değil, ayrı listede durur; koşul yalnız opRecords'a baktığı sürece
906
824
  // yalnız olay kaldıran bir yama bu korumayı hiç tetiklemiyordu (2026-09-14).
907
- // `batch` içindeki silme de planı gerektirir; açma `orphanedFlowPlan`'da.
908
- if ([...opRecords, ...removeEventOps].some(entry => ['remove_component', 'set_event', 'remove_event', 'batch'].includes(String(entry.op)))) {
825
+ if ([...opRecords, ...removeEventOps].some(entry => ['remove_component', 'set_event', 'remove_event'].includes(String(entry.op)))) {
909
826
  try {
910
827
  const page = await readPage();
911
- deletedFlows = orphanedFlowPlan(page.schema, page.events, [...opRecords, ...removeEventOps]);
828
+ deletedFlows = orphanedFlowPlan(page.schema, page.events, recordsWithEventRemovals(slots, opRecords));
912
829
  }
913
830
  catch {
914
831
  deletedFlows = [];
@@ -959,7 +876,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
959
876
  const touched = simulateLayoutOps(simulated, sentOps);
960
877
  // PAGE-013 op'lar UYGULANDIKTAN SONRAKİ ağaca bakar: tek başına eklenen düğüm masum
961
878
  // görünür, iç içeliği ancak hedef parent zinciri belli olunca anlarsın.
962
- nestedAfterOps = nestedRepeaterNodes(simulated);
879
+ nestedAfterOps = nestedRepeaterNodes(simulated, resolved.profile.platform);
963
880
  layoutWarnings = [
964
881
  ...(blocksMeaningful ? pageContainerPositionWarning(page.schema) : []),
965
882
  ...(blocksMeaningful ? verticalGapWarnings(simulated, 'PAGE-010 (uyarı)', touched) : []),
@@ -976,25 +893,100 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
976
893
  if (nestedAfterOps.length > 0)
977
894
  throw new PlatformApiError(nestedRepeaterMessage(nestedAfterOps, resolved.profile.platform), 400);
978
895
  const removedEvents = planEventRemovals(removeEventOps);
979
- const resized = resizeOps.length > 0 ? planResizes((await readPage()).schema ?? [], resizeOps) : { serverOps: [], applied: [], warnings: [] };
980
- const propTypes = propTypeOps.length > 0 ? planPropTypes((await readPage()).schema ?? [], propTypeOps) : { serverOps: [], applied: [] };
981
- const serverOps = [...removeEventOps, ...resized.serverOps, ...propTypes.serverOps, ...sentOps];
982
- const writesStyle = resolved.profile.platform !== 'web' && opRecords.some(entry => (entry.op === 'replace_prop' || entry.op === 'set_binding') && entry.prop === 'style');
896
+ // Öykünülen op'lar ağacın o andaki hâline göre planlanır ve çağıranın yazdığı yerde gider (PAGE-050).
897
+ const { resized, propTypes } = planEmulatedOps(resizeOps.length > 0 || propTypeOps.length > 0 ? (await readPage()).schema ?? [] : [], slots, opRecords);
898
+ const serverOps = serverOpsInOrder(slots, { sent: sentOps, resized: resized.groups, propTypes: propTypes.serverOps });
983
899
  const profileWarnings = await screenProfileWarnings(platform, resolved, project, environment, applicationId, {
984
900
  kind: 'page',
985
901
  ops: [...opRecords, ...propTypeOps],
986
- savedNodes: writesStyle ? await readPage().then(page => page.schema, () => undefined) : undefined,
902
+ // Kayıtlı ağaç: `style` yazımında hedefin tipi, `heroTag` yazımında sayfanın öteki etiketleri (MOB-030) için.
903
+ savedNodes: resolved.profile.platform !== 'web' && profileLintReadsSavedNodes(opRecords) ? await readPage().then(page => page.schema, () => undefined) : undefined,
987
904
  steps: await boundFlowSteps(platform, resolved, project, environment, 'page', applicationId, pageId, opRecords)
988
905
  });
989
- const skeletonWarnings = reshapesSkeleton(opRecords)
990
- ? await simulatedPageLayoutWarnings(platform, resolved, project, environment, applicationId, readPage, sentOps, 'new')
991
- : [];
906
+ // Kuru koşu hiçbir şey yazmaz: iskelet bulgularının tamamını döner; yazım yalnız bu yamayla YENİ geleni.
907
+ const skeletonWarnings = tool === 'page_schema_validate'
908
+ ? await simulatedPageLayoutWarnings(platform, resolved, project, environment, applicationId, readPage, sentOps, 'audit')
909
+ : reshapesSkeleton(opRecords)
910
+ ? await simulatedPageLayoutWarnings(platform, resolved, project, environment, applicationId, readPage, sentOps, 'new')
911
+ : [];
992
912
  layoutWarnings = [...ordering.warnings, ...layoutWarnings, ...profileWarnings, ...skeletonWarnings];
913
+ return {
914
+ opRecords,
915
+ sentOps,
916
+ serverOps,
917
+ resolved,
918
+ removedEvents,
919
+ resized,
920
+ propTypes,
921
+ deletedFlows,
922
+ formWarnings,
923
+ flowWarnings,
924
+ flowsBeforePatch,
925
+ layoutWarnings,
926
+ readVersion: () => (typeof cachedPage?.version === 'string' ? cachedPage.version : undefined),
927
+ notes: [
928
+ ...batchEnvelopeNote(opened),
929
+ ...rootAddsNote(retargeted, PAGE_CONTAINER_ELEMENT_ID),
930
+ ...componentNameNote(normalized.names),
931
+ ...sectionNotes,
932
+ ...componentDefaultsNote(normalized.components),
933
+ ...validationNote(normalized.validations),
934
+ ...catalogNotes,
935
+ ...replacePropNote(normalized.props),
936
+ ...flexIndexOrderNote(ordering.moved),
937
+ ...mobileSpacingNote(spacing)
938
+ ]
939
+ };
940
+ };
941
+ server.registerTool('page_schema_validate', {
942
+ title: 'Sayfa şemasını doğrula (kuru çalıştırma)',
943
+ 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.",
944
+ 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).') },
945
+ annotations: readOnly
946
+ }, handle(config, async ({ project, environment, applicationId, pageId, ops, operations, allowFlowDeletion }) => {
947
+ const plan = await planPageWrite('page_schema_validate', { project, environment, applicationId, pageId, ops, operations, allowFlowDeletion });
948
+ const response = ((await platform.tenant('POST', project, `/pages/${applicationId}/${pageId}/schema/validate`, {
949
+ environment,
950
+ body: { ops: plan.serverOps }
951
+ })) ?? {});
952
+ // Yazımın yanıtında dönecek uyarılar kuru koşuda da görünür: plan aynı, yalnız istek farklı.
953
+ if (plan.deletedFlows.length > 0)
954
+ response.deletedFlows = plan.deletedFlows;
955
+ if (plan.resized.warnings.length > 0)
956
+ response.resizeWarnings = plan.resized.warnings;
957
+ if (plan.formWarnings.length > 0)
958
+ response.formWarnings = plan.formWarnings;
959
+ if (plan.flowWarnings.length > 0)
960
+ response.flowWarnings = plan.flowWarnings;
961
+ if (plan.layoutWarnings.length > 0)
962
+ response.layoutWarnings = plan.layoutWarnings;
963
+ Object.assign(response, applicationTypeField(plan.resolved));
964
+ return withNormalization(response, plan.notes);
965
+ }));
966
+ server.registerTool('page_schema_patch', {
967
+ title: 'Sayfa şemasına patch uygula',
968
+ description: "Micro-op'ları doğrulama duvarından geçirip TEK PATCH ile kaydeder; açık studio canvas'ları SignalR ile canlı güncellenir. İstek atomiktir: bir op reddedilirse hiçbiri yazılmaz. baseVersion (page_schema_get çıktısındaki version ya da önceki yamanın newVersion'ı) verilirse sayfa o sürümden beri değişmişse 409 döner ve hiçbir op uygulanmaz (stale plan koruması); verilmezse gateway yalnız bu çağrıda zaten okuduğu sayfanın sürümünü gönderir. Yanıttaki appliedPatch, her op'un şemada tam olarak hangi JSON Pointer'a dokunduğunu söyler; gövdesi VARSAYILAN OLARAK iskelettir (eklenen düğüm id/type/children'a iner) — tam gövde için view:'full'. Op'un gerçekten kaydedilip kaydedilmediğini gövde değil silentlyDropped söyler. Gateway ön kontrolleri (PAGE-006/008/016/032/037/051, set_prop_type gövdesi, move_component size) op başına toplanır: düşen HER op tek hata yanıtında rejectedOps[] ({ index, op, target, code, message }) ile listelenir ve hiçbir op gönderilmez — hepsini düzeltip listeyi bir kez yeniden gönderin.",
969
+ inputSchema: {
970
+ project: projectParam,
971
+ environment: environmentParam,
972
+ applicationId: guid,
973
+ pageId: guid,
974
+ ops: opsParam.optional(),
975
+ operations: opsParam.optional().describe("'ops' ile aynı alan (eşanlamlı) — entity/microservice/workflow patch'leriyle aynı adı kullanabilmeniz için"),
976
+ 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"),
977
+ expectedUpdatedAt: z.string().optional().describe("Eski koruma: page_schema_get çıktısındaki updatedAt; eşleşmezse patch uygulanmaz. baseVersion tercih edilir"),
978
+ 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."),
979
+ view: writeViewParam
980
+ },
981
+ annotations: updates
982
+ }, handle(config, async ({ project, environment, applicationId, pageId, ops, operations, baseVersion, expectedUpdatedAt, allowFlowDeletion, view }) => {
983
+ const plan = await planPageWrite('page_schema_patch', { project, environment, applicationId, pageId, ops, operations, expectedUpdatedAt, allowFlowDeletion });
984
+ const { opRecords, sentOps, serverOps, resolved, removedEvents, resized, propTypes, deletedFlows, formWarnings, flowWarnings, flowsBeforePatch, layoutWarnings } = plan;
993
985
  // Tek istek, tek sürüm: öykünülen op'lar 2026-09-14'e kadar ayrı GET + tam PUT çiftleriydi ve
994
986
  // yamadan ÖNCE yazılıyordu — PATCH reddedilse bile kalıcıydılar. Artık hepsi aynı atomik PATCH'te.
995
987
  // baseVersion yalnız biliniyorsa gider (ajanın verdiği ya da bu çağrıda zaten okunan sayfanınki):
996
988
  // sürümü öğrenmek için ayrı GET atılmaz, platform satırı her yamada kilitler.
997
- const sentVersion = baseVersion ?? (typeof cachedPage?.version === 'string' ? cachedPage.version : undefined);
989
+ const sentVersion = baseVersion ?? plan.readVersion();
998
990
  const response = ((await platform.tenant('PATCH', project, `/pages/${applicationId}/${pageId}/schema`, {
999
991
  environment,
1000
992
  body: { ops: serverOps, baseVersion: sentVersion }
@@ -1066,17 +1058,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
1066
1058
  }
1067
1059
  }
1068
1060
  Object.assign(response, applicationTypeField(resolved));
1069
- return withWriteDiff(withNormalization(response, [
1070
- ...rootAddsNote(retargeted, PAGE_CONTAINER_ELEMENT_ID),
1071
- ...componentNameNote(normalized.names),
1072
- ...sectionNotes,
1073
- ...componentDefaultsNote(normalized.components),
1074
- ...validationNote(normalized.validations),
1075
- ...catalogNotes,
1076
- ...replacePropNote(normalized.props),
1077
- ...flexIndexOrderNote(ordering.moved),
1078
- ...mobileSpacingNote(spacing)
1079
- ]), opDrops);
1061
+ return withWriteDiff(withNormalization(response, plan.notes), opDrops);
1080
1062
  }));
1081
1063
  server.registerTool('page_discover', {
1082
1064
  title: 'Tasarım ekranından sayfa iskeleti öner',
@@ -1183,6 +1165,9 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
1183
1165
  summary.layoutWarnings = updateWarnings;
1184
1166
  return withNormalization(summary, schema === undefined ? [] : [...container.fixes, ...skeletonNotes, ...componentNameNote(named), ...reset, ...componentDefaultsNote(fixed), ...catalogNotes, ...reorderNote(moved), ...mobileSpacingNote(spacing)]);
1185
1167
  }
1168
+ // PAGE-051 yalnız gerçekten OLUŞTURAN dalda: `ifExists: 'update'` var olan sayfada page_update gibi
1169
+ // davranır ve kayıtlı emekli düğüm yazılabilir kalmalıdır.
1170
+ assertNoRetiredNodes(container.schema);
1186
1171
  if (templateRoot && layoutId === undefined)
1187
1172
  skeletonNotes = shellLessPageSkeleton(templateRoot);
1188
1173
  const response = await platform.tenant('POST', project, `/pages/${applicationId}`, {
@@ -1258,7 +1243,10 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
1258
1243
  const overrides = Object.fromEntries(Object.entries(changes).filter(([, value]) => value !== undefined));
1259
1244
  const named = fillComponentNames(overrides.schema);
1260
1245
  const resolved = overrides.schema === undefined ? undefined : await resolveProfile(platform, applicationId);
1261
- assertScreenWriteGuards('page', { schema: overrides.schema, events: overrides.events }, resolved?.profile.platform);
1246
+ // Kök ADR 0015: `focus` yalnız mobil sayfada geçerli — şemasız olay yazımında da uygulamanın platformu okunur.
1247
+ const eventPlatform = resolved?.profile.platform
1248
+ ?? (screenEventsNeedPlatform(overrides.events) ? (await resolveProfile(platform, applicationId)).profile.platform : undefined);
1249
+ assertScreenWriteGuards('page', { schema: overrides.schema, events: overrides.events }, eventPlatform);
1262
1250
  const current = await fetchHost(platform, 'page', project, environment, applicationId, pageId);
1263
1251
  if (overrides.schema !== undefined && allowNodeLoss !== true) {
1264
1252
  const storedSchema = current.schema;
@@ -1357,7 +1345,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
1357
1345
  */
1358
1346
  async function mobileSpacingForOps(platformName, ops, readSaved) {
1359
1347
  const fix = emptyMobileSpacingFix();
1360
- if (platformName !== 'mobile' || !ops.some(entry => entry.op === 'add_component' || entry.op === 'batch'))
1348
+ if (platformName !== 'mobile' || !ops.some(entry => entry.op === 'add_component'))
1361
1349
  return fix;
1362
1350
  const saved = await readSaved().then(page => page.schema, () => undefined);
1363
1351
  if (saved !== undefined)
@@ -66,8 +66,9 @@ const guideRouting = {
66
66
  entity: "alan tipleri, ilişkiler, hazır entity'ler",
67
67
  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)',
68
68
  layout: 'yerleşim kabuğu: tek slot, views, dar ekranda yığılma, widthType fill/fixed/auto',
69
- mobile: "mobil UYGULAMA (type:'mobile'): kurulum sırası (mobile_app_create), flex-only yerleşim, tipli stil, sekmeler (properties.mobile.tabs) ve çekmece, adım sözlüğü, MOB-* bulguları, page_screenshot device",
70
- 'mobile-publish': "mobil uygulamanın mağaza yayını: mobile_store_* / mobile_build_* akışı, ön kontrol P-01…P-11 (push kimlikleri dahil), derleme hata kodları, insanın Studio'da yaptıkları",
69
+ 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",
70
+ '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",
71
+ '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ı",
71
72
  '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ü',
72
73
  component: 'komponent modeli, olay sözleşmeleri, appearance boyut sözlüğü (widthString/heightString)',
73
74
  html: 'hazır komponent yetmediğinde tek seferlik kaçış kapısı (Mustache, fireEvent, script kuralları)',
@@ -48,8 +48,8 @@ async function pageShell(platform, project, environment, applicationId, layoutId
48
48
  }
49
49
  }
50
50
  /**
51
- * `set_event` ile bağlanan akışların adımları (MOB-005). Akış gövdeleri şemada değil ayrı uçtadır;
52
- * okunamazsa bulgu üretilmez, yazım yine geçer.
51
+ * `set_event` ile bağlanan akışların adımları (MOB-005). Akış gövdeleri şemada değil ayrı uçtadır; okunamazsa bulgu
52
+ * üretilmez, yazım yine geçer. `ops` araç girişinde açılmış listedir (PAGE-048): `batch` zarfı buraya ulaşmaz.
53
53
  */
54
54
  export async function boundFlowSteps(platform, resolved, project, environment, host, applicationId, hostId, ops) {
55
55
  if (resolved.profile.platform === 'web')
@@ -73,7 +73,7 @@ export function registerQueryTools(server, platform) {
73
73
  }, handle(config, ({ project, environment, id }) => platform.tenant('GET', project, `/queries/${id}`, { environment })));
74
74
  server.registerTool('query_create', {
75
75
  title: 'Query oluştur',
76
- description: "Yeni query tanımlar (ham SQL). definition = CreateQueryCommand gövdesi. AGREGASYON VE RAPORLAMANIN YOLU BUDUR (SUM/COUNT/AVG/GROUP BY, dönemsel özet, KPI) — view_* bir TAM METİN ARAMA indeksidir, özet üretmez (09-02 M-3). VAR OLAN SATIRLARDAN TÜRETİLEN SATIR YAZMANIN DA YOLU BUDUR: 'INSERT … SELECT' kaydedip query kaynaklı bir uçtan çalıştırmak, geçmiş/hareket/junction tablosunu TEK çağrıda doldurur ve hiçbir id elle taşınmaz (ölçüldü 2026-09-07; reçete platform_guide('entity') §'Toplu ve türetilmiş satır'). Kayıt sırasında gövde bir kez ÇALIŞTIRILIR ama geri alınır — yazan sorguyu kaydetmek satır bırakmaz ve 'returnScheme' boş döner. Kayıtlı query'nin parametreleri parameterScheme ile tanımlanır ve runtime'da bağlanır; tüketimi source:'query' microservice'idir. PARAMETRENİN DEĞERİ HER ZAMAN ÇAĞRIDAN GELİR (body → query-string → header): parametreye ifade kaynağı verilemez (parameters[].source komut şemasında yoktur, platform sessizce atar) ve middleware'in kurduğu user bu yola girmez. Kimlik/tenant kapsamı sunucu tarafında zorlanacaksa sorguyu bir workflow query adımından çağırın — reçete platform_guide('microservice') §'Kimlik kapsaması × uç kaynağı'. BOŞ STRING parametre NULL'a çevrilir: '= @p' koşulu hiçbir satırla eşleşmez ve sorgu sessizce 0 satır döner — 'filtre yok' için (@p IS NULL OR ...) yazın ya da sentinel kullanın; (@p = '' OR ...) kalıbı hiçbir zaman eşleşmez ve gateway `QRY-007` uyarısı düşürür. Yorum içindeki belirteç parametre sayılmaz. SQL çalıştırılamazsa kayıt YİNE de oluşur: returnScheme boş kalır ve yanıttaki message nedeni söyler — SQL'i düzeltip query_update ile kaydedin. SORGUNUN KENDİ AÇIKLAMASI VAR: `description` alanını doldurun — sorgu listesinde ad ve slug dışında ipucu yoktur ve ucun açıklaması (MS-014) bunun yerine geçmez, çünkü bir sorgu birden çok uçtan tüketilir; boş bırakılırsa gateway `QRY-006` uyarısı düşürür (yazmayı durdurmaz). " + constraintSummary('CreateQueryCommand'),
76
+ description: "Yeni query tanımlar (ham SQL). definition = CreateQueryCommand gövdesi. AGREGASYON VE RAPORLAMANIN YOLU BUDUR (SUM/COUNT/AVG/GROUP BY, dönemsel özet, KPI) — view_* bir TAM METİN ARAMA indeksidir, özet üretmez (09-02 M-3). VAR OLAN SATIRLARDAN TÜRETİLEN SATIR YAZMANIN DA YOLU BUDUR: 'INSERT … SELECT' kaydedip query kaynaklı bir uçtan çalıştırmak, geçmiş/hareket/junction tablosunu TEK çağrıda doldurur ve hiçbir id elle taşınmaz (ölçüldü 2026-09-07; reçete platform_guide('entity') §'Toplu ve türetilmiş satır'). Kayıt sırasında gövde bir kez ÇALIŞTIRILIR ama geri alınır — yazan sorguyu kaydetmek satır bırakmaz; 'returnScheme' yalnız sonuç kümesi DÖNMEYEN yazan sorguda boştur — 'INSERT/UPDATE/DELETE … RETURNING' ya da sonda bir SELECT taşıyan gövdede dönen kolonlarla DOLU gelir (37 S-5). json/jsonb kolonu returnScheme'de 'string' tiplenir ve değeri JSON METNİ gelir (preview'da da çalışma anında da); akışta JSON.parse ile açın. Şema tipi önizlemede değil KAYITTA sabitlenir (37 S-2, b-25 ertelendi). Kayıtlı query'nin parametreleri parameterScheme ile tanımlanır ve runtime'da bağlanır; tüketimi source:'query' microservice'idir. PARAMETRENİN DEĞERİ HER ZAMAN ÇAĞRIDAN GELİR (body → query-string → header): parametreye ifade kaynağı verilemez (parameters[].source komut şemasında yoktur, platform sessizce atar) ve middleware'in kurduğu user bu yola girmez. Kimlik/tenant kapsamı sunucu tarafında zorlanacaksa sorguyu bir workflow query adımından çağırın — reçete platform_guide('microservice') §'Kimlik kapsaması × uç kaynağı'. BOŞ STRING parametre NULL'a çevrilir: '= @p' koşulu hiçbir satırla eşleşmez ve sorgu sessizce 0 satır döner — 'filtre yok' için (@p IS NULL OR ...) yazın ya da sentinel kullanın; (@p = '' OR ...) kalıbı hiçbir zaman eşleşmez ve gateway `QRY-007` uyarısı düşürür. Yorum içindeki belirteç parametre sayılmaz. SQL çalıştırılamazsa kayıt YİNE de oluşur: returnScheme boş kalır ve yanıttaki message nedeni söyler — SQL'i düzeltip query_update ile kaydedin. SORGUNUN KENDİ AÇIKLAMASI VAR: `description` alanını doldurun — sorgu listesinde ad ve slug dışında ipucu yoktur ve ucun açıklaması (MS-014) bunun yerine geçmez, çünkü bir sorgu birden çok uçtan tüketilir; boş bırakılırsa gateway `QRY-006` uyarısı düşürür (yazmayı durdurmaz). " + constraintSummary('CreateQueryCommand'),
77
77
  inputSchema: { project: projectParam, environment: environmentParam, definition: definitionParam, policyOverride: policyOverrideParam },
78
78
  annotations: writes
79
79
  }, handle(config, async ({ project, environment, definition, policyOverride }) => {