@appaflytech/zeyrek-ai-mcp 0.0.32 → 0.0.33
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.
- package/.env.example +15 -0
- package/dist/config.js +11 -0
- package/dist/index.js +2 -0
- package/dist/knowledge/access.js +802 -0
- package/dist/knowledge/case.js +41 -0
- package/dist/knowledge/componentCatalog.js +82 -213
- package/dist/knowledge/componentEvents.js +21 -19
- package/dist/knowledge/connectDataBind.js +819 -0
- package/dist/knowledge/connectDataDefinition.js +341 -0
- package/dist/knowledge/connectDataExecute.js +93 -0
- package/dist/knowledge/connectDataRules.js +128 -0
- package/dist/knowledge/decision.js +121 -0
- package/dist/knowledge/expressionPrelude.js +59 -0
- package/dist/knowledge/layoutSummary.js +140 -2
- package/dist/knowledge/microserviceParameters.js +58 -0
- package/dist/knowledge/mining.js +94 -0
- package/dist/knowledge/mobileComponentCatalog.js +864 -0
- package/dist/knowledge/mobileComponentEvents.js +239 -0
- package/dist/knowledge/mobileStore.js +227 -0
- package/dist/knowledge/normalize.js +121 -35
- package/dist/knowledge/platform/lint.js +385 -0
- package/dist/knowledge/platform/mobile.js +142 -0
- package/dist/knowledge/platform/mobileLayoutLint.js +324 -0
- package/dist/knowledge/platform/mobileRules.js +231 -0
- package/dist/knowledge/platform/mobileSpacing.js +82 -0
- package/dist/knowledge/platform/mobileTabs.js +108 -0
- package/dist/knowledge/platform/nativeBoxModel.js +44 -0
- package/dist/knowledge/platform/profile.js +25 -0
- package/dist/knowledge/platform/resolve.js +122 -0
- package/dist/knowledge/platform/web.js +39 -0
- package/dist/knowledge/process.js +510 -0
- package/dist/knowledge/rowFilter.js +43 -0
- package/dist/knowledge/rules.js +291 -19
- package/dist/knowledge/styleResolve.js +55 -38
- package/dist/knowledge/styleResolveNative.js +527 -0
- package/dist/knowledge/themeResolve.js +3 -3
- package/dist/observability/trace.js +1 -1
- package/dist/platform/argumentAliases.js +128 -0
- package/dist/platform/bodyFile.js +103 -0
- package/dist/platform/capture/actions.js +333 -0
- package/dist/platform/capture/browser.js +1 -0
- package/dist/platform/{screenshot.js → capture/capture.js} +81 -519
- package/dist/platform/capture/console-log.js +122 -0
- package/dist/platform/capture/index.js +11 -0
- package/dist/platform/capture/readiness.js +103 -0
- package/dist/platform/capture/summary.js +77 -0
- package/dist/platform/capture/target.js +5 -0
- package/dist/platform/capture/targets/studio-mobile.js +15 -0
- package/dist/platform/capture/targets/studio-web.js +5 -0
- package/dist/platform/diagnostics.js +10 -4
- package/dist/platform/domSummary.js +1 -1
- package/dist/platform/http.js +23 -7
- package/dist/platform/impersonation.js +45 -0
- package/dist/platform/jsonArray.js +24 -0
- package/dist/platform/responses.js +6 -2
- package/dist/platform/schemaReadMemory.js +60 -0
- package/dist/platform/secrets.js +9 -0
- package/dist/platform/strictArguments.js +68 -12
- package/dist/platform/tokenVault.js +187 -4
- package/dist/resources/examples/bpm-gorev-kontrol.json +294 -0
- package/dist/resources/examples/bpm-iso-dokuman.json +228 -0
- package/dist/resources/examples/bpm-satinalma.json +376 -0
- package/dist/resources/examples/connect-data-convert-verify.json +107 -0
- package/dist/resources/examples/connect-data-dropdown-roles.json +66 -0
- package/dist/resources/examples/connect-data-edit-m2m.json +73 -0
- package/dist/resources/examples/connect-data-query-params.json +50 -0
- package/dist/resources/examples/connect-data-table-entity.json +147 -0
- package/dist/resources/examples/connect-data-workflow-microservice.json +65 -0
- package/dist/resources/examples/layout-app-shell.json +229 -707
- package/dist/resources/examples/mobile-app-shell-drawer.json +244 -0
- package/dist/resources/examples/mobile-app-shell-stack.json +157 -0
- package/dist/resources/examples/mobile-app-shell-tab.json +208 -0
- package/dist/resources/examples/mobile-form-screen.json +365 -0
- package/dist/resources/examples/mobile-list-detail-form.json +703 -0
- package/dist/resources/examples/page-flex-sections.json +1 -1
- package/dist/resources/guides/access.md +796 -0
- package/dist/resources/guides/bpm.md +686 -0
- package/dist/resources/guides/case.md +153 -0
- package/dist/resources/guides/component.md +10 -2
- package/dist/resources/guides/decision.md +185 -0
- package/dist/resources/guides/expressions.md +14 -5
- package/dist/resources/guides/functions.md +1 -1
- package/dist/resources/guides/layout.md +55 -58
- package/dist/resources/guides/microservice.md +9 -2
- package/dist/resources/guides/middleware.md +34 -2
- package/dist/resources/guides/mobile-layout.md +193 -0
- package/dist/resources/guides/mobile.md +578 -0
- package/dist/resources/guides/page.md +221 -92
- package/dist/resources/guides/theme.md +8 -2
- package/dist/resources/guides/translation.md +1 -1
- package/dist/resources/guides/workflow.md +7 -1
- package/dist/resources/read.js +41 -0
- package/dist/resources/schema-fingerprint.json +4 -4
- package/dist/resources/schemas/AccessExplanationDto.json +144 -0
- package/dist/resources/schemas/AccessMatrixDto.json +170 -0
- package/dist/resources/schemas/AccessPermissionDto.json +57 -0
- package/dist/resources/schemas/AccessPolicyDto.json +223 -0
- package/dist/resources/schemas/AccessResourceDto.json +86 -0
- package/dist/resources/schemas/AppSessionDto.json +53 -0
- package/dist/resources/schemas/ConnectDataDescribeDto.json +344 -0
- package/dist/resources/schemas/ConnectDataRequestModel.json +202 -0
- package/dist/resources/schemas/ConnectDataResultDto.json +421 -0
- package/dist/resources/schemas/ConnectorCredentialDto.json +70 -0
- package/dist/resources/schemas/ConvertConnectDataToMicroserviceCommand.json +37 -0
- package/dist/resources/schemas/CreateAccessPolicyCommand.json +209 -0
- package/dist/resources/schemas/CreateDecisionCommand.json +221 -0
- package/dist/resources/schemas/CreateProcessDefinitionCommand.json +1337 -0
- package/dist/resources/schemas/DecisionDto.json +302 -0
- package/dist/resources/schemas/DetachConnectDataMicroserviceCommand.json +28 -0
- package/dist/resources/schemas/ExplainAccessQuery.json +33 -0
- package/dist/resources/schemas/GenerateProcessDocumentCommand.json +116 -0
- package/dist/resources/schemas/GlobalFunctionUpdateResultDto.json +3 -1
- package/dist/resources/schemas/MicroserviceDto.json +2 -2
- package/dist/resources/schemas/OrganizationProjectDto.json +335 -0
- package/dist/resources/schemas/OrganizationSchemaDto.json +196 -0
- package/dist/resources/schemas/OrganizationSchemaVersionDto.json +207 -0
- package/dist/resources/schemas/PatchProcessDefinitionCommand.json +76 -0
- package/dist/resources/schemas/ProcessDefinitionDto.json +1480 -0
- package/dist/resources/schemas/ProcessSimulationDto.json +96 -0
- package/dist/resources/schemas/SaveConnectorCredentialCommand.json +90 -0
- package/dist/resources/schemas/SaveProcessEventSourceCommand.json +61 -0
- package/dist/resources/schemas/SaveProcessMailSourceCommand.json +89 -0
- package/dist/resources/schemas/SignProcessTaskCommand.json +73 -0
- package/dist/resources/schemas/SimulateProcessDefinitionQuery.json +92 -0
- package/dist/resources/schemas/StartMobileBuildCommand.json +54 -0
- package/dist/resources/schemas/UpdateAccessPolicyCommand.json +209 -0
- package/dist/resources/schemas/UpdateDecisionCommand.json +216 -0
- package/dist/resources/schemas/UpdateProcessDefinitionCommand.json +1357 -0
- package/dist/resources/schemas/UpsertMobileStoreSettingsCommand.json +259 -0
- package/dist/resources/schemas/ValidateProcessDefinitionQuery.json +1339 -0
- package/dist/server.js +7 -1
- package/dist/tools/accessOperations.js +135 -0
- package/dist/tools/accessPolicies.js +170 -0
- package/dist/tools/accessRuntime.js +203 -0
- package/dist/tools/applications.js +60 -3
- package/dist/tools/bpm.js +343 -0
- package/dist/tools/bpmGovernance.js +266 -0
- package/dist/tools/bpmOperations.js +230 -0
- package/dist/tools/bpmReporting.js +154 -0
- package/dist/tools/bpmRouting.js +150 -0
- package/dist/tools/bpmRuntime.js +396 -0
- package/dist/tools/case.js +178 -0
- package/dist/tools/caseRuntime.js +89 -0
- package/dist/tools/components.js +103 -12
- package/dist/tools/connectData.js +449 -0
- package/dist/tools/connectors.js +193 -0
- package/dist/tools/datasources.js +1 -1
- package/dist/tools/decisions.js +206 -0
- package/dist/tools/designSchemaPatch.js +22 -16
- package/dist/tools/externalComponents.js +25 -4
- package/dist/tools/flows.js +79 -6
- package/dist/tools/layouts.js +44 -12
- package/dist/tools/microservices.js +32 -10
- package/dist/tools/mobile.js +221 -0
- package/dist/tools/mobileStore.js +268 -0
- package/dist/tools/modules.js +48 -0
- package/dist/tools/organizationStructure.js +137 -0
- package/dist/tools/pages.js +391 -92
- package/dist/tools/platformInfo.js +7 -2
- package/dist/tools/profileWrite.js +92 -0
- package/dist/tools/rows.js +7 -1
- package/dist/tools/schemaOps.js +33 -1
- package/dist/tools/screenWrite.js +15 -7
- package/dist/tools/screens.js +90 -3
- package/dist/tools/variables.js +11 -5
- package/package.json +2 -2
- package/dist/knowledge/boxSections.js +0 -184
package/dist/tools/pages.js
CHANGED
|
@@ -1,28 +1,34 @@
|
|
|
1
1
|
import { guid, projectParam, environmentParam, pagingParams, readOnly, writes, updates, destructive, microOps, isBranchName } from './common.js';
|
|
2
2
|
import { orphanedFlowWarnings, orphanedFlowPlan, orphanedFlowMessage, boundEventOps, stripGatewayEventFields, staleSetterWarnings, lostSetterTargets, normalizeComponentDefaults, normalizeSchemaOps, schemaOpValidationErrors, codePropTemplateErrors, 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';
|
|
3
3
|
import { functionSignature } from '../knowledge/functionGuards.js';
|
|
4
|
-
import { fetchHost, pageUpdateBody, schemaParam, eventsParam, unwrap, modeParam, summarize, findNode, flowPath } from './screens.js';
|
|
4
|
+
import { fetchHost, pageUpdateBody, schemaParam, eventsParam, unwrap, modeParam, summarize, findNode, flowPath, countSchemaNodes, missingElementIds, splitSchemaIntoParts, encodeSchemaCursor, decodeSchemaCursor } from './screens.js';
|
|
5
5
|
import { fetchComponentEventNames } from './components.js';
|
|
6
6
|
import { assertScreenWriteGuards, screenCatalogNotes } from './screenWrite.js';
|
|
7
|
-
import { opsParam, writeViewParam, outlineWriteResponse, unknownEventOps, collectTypes, simulateLayoutOps, planEventRemovals, resizeServerOps, planResizes, planPropTypes, rejectedOpsMessage } from './schemaOps.js';
|
|
7
|
+
import { opsParam, writeViewParam, outlineWriteResponse, unknownEventOps, collectTypes, simulateLayoutOps, applySkeletonOps, reshapesSkeleton, planEventRemovals, resizeServerOps, planResizes, planPropTypes, rejectedOpsMessage } from './schemaOps.js';
|
|
8
8
|
import { formBindingWarnings, formSubmitButtonWarnings } from '../knowledge/coverage.js';
|
|
9
9
|
import { emptyWriteDiff, schemaOpDrops, unwrapProps, withWriteDiff, writeDiff } from '../platform/writeDiff.js';
|
|
10
10
|
import { PlatformApiError } from '../platform/errors.js';
|
|
11
11
|
import { existingMatch, ifExistsParam, listAll, withOutcome } from '../platform/ifExists.js';
|
|
12
|
-
import { handle, toolResult, toolError } from '../platform/responses.js';
|
|
13
|
-
import { StudioScreenshotter } from '../platform/
|
|
12
|
+
import { handle, toolResult, toolError, prune } from '../platform/responses.js';
|
|
13
|
+
import { expressionErrorsNote, StudioScreenshotter } from '../platform/capture/index.js';
|
|
14
|
+
import { captureTargetFor } from '../platform/capture/target.js';
|
|
14
15
|
import { diffSummaries, summaryLines, summaryStats } from '../platform/domSummary.js';
|
|
15
16
|
import { captureKey, imageHash, sharedCaptureMemory } from '../platform/screenshotMemory.js';
|
|
17
|
+
import { pageReadKey, schemaReadKey, sharedSchemaReadMemory } from '../platform/schemaReadMemory.js';
|
|
16
18
|
import { summarizeLayout } from '../knowledge/layoutSummary.js';
|
|
17
19
|
import { normalizeLanguageCode } from '../knowledge/languageCodes.js';
|
|
18
20
|
import { readProjectLanguages } from '../knowledge/languages.js';
|
|
19
|
-
import {
|
|
21
|
+
import { resolveIdentity } from '../platform/tokenVault.js';
|
|
20
22
|
import { mkdir, writeFile } from 'node:fs/promises';
|
|
21
23
|
import { dirname, resolve } from 'node:path';
|
|
22
24
|
import { setPropTypeErrors } from '../knowledge/propTypes.js';
|
|
23
|
-
import { boxSectionNote, collectIds, ensureBoxSections, expandSectionToggles } from '../knowledge/boxSections.js';
|
|
24
25
|
import { designSnapshotInput } from '../knowledge/designSnapshot.js';
|
|
25
26
|
import { discoverPage } from '../knowledge/pageDiscover.js';
|
|
27
|
+
import { applicationTypeField, resolveProfile, resolveProfileBySlug } from '../knowledge/platform/resolve.js';
|
|
28
|
+
import { resolveThemeNative } from '../knowledge/styleResolveNative.js';
|
|
29
|
+
import { boundFlowSteps, pageLayoutWarnings, screenProfileWarnings } from './profileWrite.js';
|
|
30
|
+
import { applyMobileSpacingDefaults, applyMobileSpacingToOps, emptyMobileSpacingFix, mobileSpacingNote } from '../knowledge/platform/mobileSpacing.js';
|
|
31
|
+
import { shellLessPageSkeleton } from '../knowledge/platform/mobile.js';
|
|
26
32
|
import { z } from 'zod';
|
|
27
33
|
/**
|
|
28
34
|
* Runtime paketindeki `appFunctions`/`pageFunctions` (UiFunctionRuntimeDto: id, name, parameters,
|
|
@@ -57,10 +63,6 @@ async function orderByIndex(ops, readPage) {
|
|
|
57
63
|
return { ops, moved: [], warnings: [] };
|
|
58
64
|
}
|
|
59
65
|
}
|
|
60
|
-
/** Şema ağacındaki TÜM düğümler (kök + iç içe çocuklar); page_get ve page_create özeti aynı sayımı kullanır. */
|
|
61
|
-
function countSchemaNodes(nodes) {
|
|
62
|
-
return (nodes ?? []).reduce((total, node) => total + 1 + countSchemaNodes(node.children), 0);
|
|
63
|
-
}
|
|
64
66
|
async function fetchPage(platform, project, environment, applicationId, pageId) {
|
|
65
67
|
const response = await platform.tenant('GET', project, `/pages/${applicationId}/${pageId}`, { environment });
|
|
66
68
|
return response?.data ?? {};
|
|
@@ -75,11 +77,41 @@ export const SERVER_PAGE_OPS = [
|
|
|
75
77
|
'replace_prop', 'set_binding', 'set_prop_type', 'add_component', 'remove_component', 'move_component', 'reorder', 'set_block',
|
|
76
78
|
'set_appearance', 'set_states', 'set_event', 'add_event', 'remove_event', 'set_validations', 'set_state_binding', 'remove_state_binding', 'batch'
|
|
77
79
|
];
|
|
78
|
-
export function registerPageTools(server, platform, injectedScreenshotter, injectedMemory) {
|
|
80
|
+
export function registerPageTools(server, platform, injectedScreenshotter, injectedMemory, injectedSchemaReadMemory) {
|
|
79
81
|
const config = platform.config;
|
|
80
|
-
const
|
|
81
|
-
|
|
82
|
-
const
|
|
82
|
+
const schemaReadMemory = injectedSchemaReadMemory ?? sharedSchemaReadMemory;
|
|
83
|
+
const readKey = (project, environment, pageId, version) => schemaReadKey(project ?? config.defaultProject ?? '', environment ?? config.defaultEnvironment, pageId, String(version ?? ''));
|
|
84
|
+
const pageKey = (project, environment, pageId) => pageReadKey(project ?? config.defaultProject ?? '', environment ?? config.defaultEnvironment, pageId);
|
|
85
|
+
const rememberVersion = (project, environment, pageId, version) => {
|
|
86
|
+
if ((typeof version === 'string' && version.length > 0) || typeof version === 'number') {
|
|
87
|
+
schemaReadMemory.rememberVersion(pageKey(project, environment, pageId), String(version));
|
|
88
|
+
}
|
|
89
|
+
};
|
|
90
|
+
/**
|
|
91
|
+
* g-05: sayfa sürüm çakışması (409 `PageSchemaVersionConflictException`) ajana "sayfa hangi
|
|
92
|
+
* sürümde, kim ne zaman değiştirdi" ile döner. Güncel sürüm sayfadan, son yazma revizyon
|
|
93
|
+
* defterinden (`/revisions/{projectId}`, en yeni tek satır) okunur; ikisi de okunamazsa mesaj
|
|
94
|
+
* o parçasız gider — çeviri hiçbir zaman çakışmanın kendisini gizlemez. Başka her hata olduğu
|
|
95
|
+
* gibi döner.
|
|
96
|
+
*/
|
|
97
|
+
const versionConflict = async (error, project, environment, applicationId, pageId, sentVersion, nextStep) => {
|
|
98
|
+
if (!(error instanceof PlatformApiError) || error.code !== 'PageSchemaVersionConflictException')
|
|
99
|
+
return error;
|
|
100
|
+
const currentVersion = await fetchPage(platform, project, environment, applicationId, pageId).then(page => page.version, () => undefined);
|
|
101
|
+
const revision = await (async () => {
|
|
102
|
+
const projectPayload = await platform.org('GET', `/p/${platform.resolveProject(project)}`);
|
|
103
|
+
const revisions = await platform.org('GET', `/revisions/${projectPayload?.data?.id ?? ''}`, {
|
|
104
|
+
query: { environment: environment ?? config.defaultEnvironment, module: 'page', recordId: pageId, pageLength: 1 }
|
|
105
|
+
});
|
|
106
|
+
return revisions?.data?.[0];
|
|
107
|
+
})().catch(() => undefined);
|
|
108
|
+
const actor = (revision?.actor ?? {});
|
|
109
|
+
const lastWrite = revision
|
|
110
|
+
? ` — son yazma ${String(revision.createdAt ?? '?')}, ${String(actor.name ?? actor.id ?? 'bilinmeyen kullanıcı')}, kaynak ${String(revision.source ?? '?')}, revizyon ${String(revision.revisionNo ?? '?')}`
|
|
111
|
+
: '';
|
|
112
|
+
return new PlatformApiError(`Sayfa siz okuduktan sonra değişti: gönderilen sürüm ${sentVersion ?? '(yok)'}, güncel sürüm ${String(currentVersion ?? '?')}${lastWrite}. HİÇBİR ŞEY yazılmadı. ${nextStep}`, 409, error.code);
|
|
113
|
+
};
|
|
114
|
+
const asUserParam = z.string().min(1).optional().describe("Uygulama üyesinin kimliği: istek gateway'in servis jetonu yerine bu kimlikle gider. Jeton HEM Authorization başlığında HEM NG_AccessToken çerezinde taşınır, böylece çerez okuyan middleware de geçer. ÜÇ ŞEKİL kabul edilir: (1) TERCİH EDİLEN `test:<ad>` — gateway kök .env'deki MCP_TEST_USER_<AD> satırının tarif ettiği giriş ucunu kendisi çağırır ve jetonu kasadan yeniden kullanır (satırı insan yazar; tanımsızsa hata eklenecek değişkeni söyler), (2) `tok_…` referansı — uygulamanın giriş ucunu microservice_execute ile çağırdığınızda jeton maskelenir ama yanıtın `tokenRefs` alanında referansı döner (ömür MCP_TOKEN_TTL_MINUTES; MCP_STATE_DIR varsa gateway yeniden başlayınca da çözülür), (3) ham JWT. anonymous ile birlikte verilemez.");
|
|
83
115
|
server.registerTool('page_list', {
|
|
84
116
|
title: 'Sayfaları listele',
|
|
85
117
|
description: 'Uygulamanın sayfalarını (id, name, slug) listeler; hedef sayfayı bulmak için ilk adım.',
|
|
@@ -101,12 +133,14 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
|
|
|
101
133
|
}));
|
|
102
134
|
server.registerTool('page_get', {
|
|
103
135
|
title: 'Sayfa üstbilgisini getir',
|
|
104
|
-
description: "Sayfanın kimlik ve bağ bilgisi: slug, browserTitle, layoutId, middlewareIds, roleIds, sayfa düzeyi olaylar (events[].value = flow id) ve flow özetleri. ŞEMA DÖNDÜRMEZ — şema için page_schema_get. 'Sayfa middleware'e bağlı mı, hangi roller görüyor, hangi olaya hangi akış bağlı' sorularının cevabı budur (Kural 8 denetimi).",
|
|
136
|
+
description: "Sayfanın kimlik ve bağ bilgisi: slug, browserTitle, layoutId, middlewareIds, roleIds, sayfa düzeyi olaylar (events[].value = flow id) ve flow özetleri. ŞEMA DÖNDÜRMEZ — şema için page_schema_get. 'Sayfa middleware'e bağlı mı, hangi roller görüyor, hangi olaya hangi akış bağlı' sorularının cevabı budur (Kural 8 denetimi). Yanıttaki version gateway'de hatırlanır: ardından gelen page_update onu baseVersion olarak gönderir (PAGE-039).",
|
|
105
137
|
inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, pageId: guid },
|
|
106
138
|
annotations: readOnly
|
|
107
139
|
}, handle(config, async ({ project, environment, applicationId, pageId }) => {
|
|
108
140
|
const page = await fetchPage(platform, project, environment, applicationId, pageId);
|
|
141
|
+
const resolved = await resolveProfile(platform, applicationId);
|
|
109
142
|
const layout = (page.layout ?? {});
|
|
143
|
+
rememberVersion(project, environment, pageId, page.version);
|
|
110
144
|
return {
|
|
111
145
|
id: page.id,
|
|
112
146
|
name: page.name,
|
|
@@ -124,7 +158,9 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
|
|
|
124
158
|
flows: (Array.isArray(page.flows) ? page.flows : [])
|
|
125
159
|
.map(flow => ({ id: flow.id, name: flow.name, slug: flow.slug })),
|
|
126
160
|
schemaNodes: countSchemaNodes(page.schema),
|
|
127
|
-
|
|
161
|
+
version: page.version,
|
|
162
|
+
updatedAt: page.audit?.updatedAt ?? page.audit?.createdAt,
|
|
163
|
+
...applicationTypeField(resolved)
|
|
128
164
|
};
|
|
129
165
|
}));
|
|
130
166
|
server.registerTool('page_runtime_get', {
|
|
@@ -148,7 +184,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
|
|
|
148
184
|
}
|
|
149
185
|
// page_screenshot çerez, bu tool başlık taşıyordu; çerez okuyan middleware ikincisinden
|
|
150
186
|
// yapısal olarak geçemiyordu. Kimlik artık iki kanalda birden gider (Y-02).
|
|
151
|
-
const identity = asUser === undefined ? {} : { headers: { authorization: `Bearer ${resolveIdentity(asUser)}` } };
|
|
187
|
+
const identity = asUser === undefined ? {} : { headers: { authorization: `Bearer ${await resolveIdentity(asUser, platform, project, environment)}` } };
|
|
152
188
|
try {
|
|
153
189
|
response = await platform.tenant('GET', project, `/${applicationSlug}/p/${pageSlug}`, { environment, anonymous, mirrorAuthorizationCookie: true, ...identity });
|
|
154
190
|
}
|
|
@@ -172,11 +208,18 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
|
|
|
172
208
|
const styleSource = resolveStyles ? (theme ?? null) : undefined;
|
|
173
209
|
const asNodes = (value) => (Array.isArray(value) ? value : []);
|
|
174
210
|
const named = (value) => (Array.isArray(value) ? value : []).map(entry => ({ id: entry.id, name: entry.name, slug: entry.slug }));
|
|
211
|
+
const runtimeApplication = (body.application ?? {});
|
|
212
|
+
// Mobil uygulama React Native stiliyle çizilir (G4): rapor CSS kaskadı değil `shell`/`text`.
|
|
213
|
+
const nativeTheme = resolveStyles && runtimeApplication.type === 'mobile' ? resolveThemeNative((theme ?? undefined)) : undefined;
|
|
214
|
+
// Mobilde de tema katmanı (componentStyles ← $preset) çizerin tabanıdır (f-16); rapor aynı kaynağı okur.
|
|
215
|
+
const nodeStyleSource = styleSource;
|
|
175
216
|
return {
|
|
176
217
|
page: { id: body.id, name: body.name, slug: body.slug, browserTitle: body.browserTitle, browserTitleKey: body.browserTitleKey, isHomepage: body.isHomepage },
|
|
218
|
+
...(typeof runtimeApplication.type === 'string' ? { applicationType: runtimeApplication.type } : {}),
|
|
177
219
|
events: body.events ?? [],
|
|
178
|
-
layout: layout ? { id: layout.id, name: layout.name, views: asNodes(layout.views).map(node => summarize(node,
|
|
179
|
-
schema: asNodes(body.schema).map(node => summarize(node,
|
|
220
|
+
layout: layout ? { id: layout.id, name: layout.name, views: asNodes(layout.views).map(node => summarize(node, nodeStyleSource, nativeTheme)) } : null,
|
|
221
|
+
schema: asNodes(body.schema).map(node => summarize(node, nodeStyleSource, nativeTheme)),
|
|
222
|
+
...(nativeTheme ? { styleResolver: 'native' } : {}),
|
|
180
223
|
widgets: named(body.widgets),
|
|
181
224
|
flows: named(body.flows),
|
|
182
225
|
variableKeys: Object.keys((body.variables ?? {})),
|
|
@@ -195,9 +238,11 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
|
|
|
195
238
|
}
|
|
196
239
|
}
|
|
197
240
|
: {}),
|
|
198
|
-
note:
|
|
199
|
-
? "
|
|
200
|
-
:
|
|
241
|
+
note: nativeTheme
|
|
242
|
+
? "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."
|
|
243
|
+
: resolveStyles
|
|
244
|
+
? "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."
|
|
245
|
+
: "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."
|
|
201
246
|
};
|
|
202
247
|
}));
|
|
203
248
|
const screenshotter = injectedScreenshotter ?? new StudioScreenshotter(config);
|
|
@@ -205,7 +250,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
|
|
|
205
250
|
const maxInlinePngBytes = 5 * 1024 * 1024;
|
|
206
251
|
server.registerTool('page_screenshot', {
|
|
207
252
|
title: 'Sayfanın ekran görüntüsünü al',
|
|
208
|
-
description: "Ö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. 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).",
|
|
253
|
+
description: "Ö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).",
|
|
209
254
|
inputSchema: {
|
|
210
255
|
project: projectParam,
|
|
211
256
|
environment: environmentParam,
|
|
@@ -214,14 +259,22 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
|
|
|
214
259
|
viewport: z.object({
|
|
215
260
|
width: z.number().int().min(320).max(3840),
|
|
216
261
|
height: z.number().int().min(240).max(2160)
|
|
217
|
-
}).optional().describe('Varsayılan 1280x800 (deviceScaleFactor 1)'),
|
|
262
|
+
}).optional().describe('Varsayılan 1280x800 (deviceScaleFactor 1); mobil uygulamada varsayılan device. Verilirse device yok sayılır'),
|
|
263
|
+
device: z.union([
|
|
264
|
+
z.enum(['phone', 'tablet']),
|
|
265
|
+
z.object({
|
|
266
|
+
width: z.number().int().min(320).max(3840),
|
|
267
|
+
height: z.number().int().min(240).max(2160),
|
|
268
|
+
scale: z.number().min(1).max(3).optional()
|
|
269
|
+
})
|
|
270
|
+
]).optional().describe("Yalnız MOBİL uygulama: cihaz ön ayarı — 'phone' 390x844 @2x (varsayılan), 'tablet' 820x1180 @2x, ya da { width, height, scale? }. Kare cihaz piksel yoğunluğunda çıkar (phone → 780x1688 px); raster küçültme için scale parametresi bununla çarpılır. Web uygulamasında reddedilir: dar ekran için viewport verin."),
|
|
218
271
|
fullPage: z.boolean().optional().describe('true: kaydırılan kısım dahil tüm sayfa; varsayılan yalnız viewport karesi'),
|
|
219
272
|
delayMs: z.number().int().min(0).max(60000).optional().describe("Hazırlık bütçesine EK süre (ms). Varsayılan bütçe 15 sn'dir ve kare sayfa hazır olur olmaz alınır (akışsız giriş ekranı ~1 sn, dashboard mount akışları bitince) — normalde vermeye gerek yok. Yalnız sayfa gerçekten uzun sürüyorsa (soğuk Vite derlemesi, ağır mount akışı) büyütün: bütçe dolduğunda sayfa hâlâ hazır değilse çağrı hatayla döner, kare alınmaz. Sayfanın AÇILMASI için beklenen 20 sn'lik navigasyon süresi de bu kadar uzar — soğuk Studio'da tek düğme budur (09-08 S-8)."),
|
|
220
273
|
captureUnready: z.boolean().optional().describe("true: TEŞHİS kipi — bütçe dolduğunda sayfa hazır olmasa da kare alınır ve yanıt pageState: 'not-ready' taşır (iskelet/yarım kare görülebilir). Varsayılan false: yüklenmemiş sayfa çekilmez, hata döner."),
|
|
221
274
|
anonymous: z.boolean().optional().describe("true: hiçbir çerez enjekte edilmez — anonim ziyaretçinin gördüğü kare. Korumalı sayfada middlewareBlocked bekleyin."),
|
|
222
275
|
asUser: asUserParam,
|
|
223
276
|
expectFailure: z.boolean().optional().describe("true: bu çekimde bir akış adımının düşmesi BEKLENİYOR (kasıtlı negatif test — yanlış parola, yetkisiz kullanıcı, geçersiz gövde). Kare yine alınır ve runtimeErrors yine dolar, ama yanıt expectedFailure:true taşır ve benchmark raporu bu satırı plansız hata saymaz: 2026-09-06 koşusunda on başarısız çağrının ALTISI kasıtlı negatif testti ve ayıklama elle yapıldı (S-4)."),
|
|
224
|
-
layoutReport: z.boolean().optional().describe("true: kareyle birlikte her runtime düğümünün efektif piksel kutusunu ve özetini (taşan / viewport dışı / sıfır boyutlu elementId'ler) döner — taşma ve çakışmayı görüntüsüz, sayısal yakalar. Düğümler data-element-id taşımıyorsa layoutReportUnavailable döner."),
|
|
277
|
+
layoutReport: z.boolean().optional().describe("true: kareyle birlikte her runtime düğümünün efektif piksel kutusunu ve özetini (taşan / viewport dışı / sıfır boyutlu elementId'ler) döner — taşma ve çakışmayı görüntüsüz, sayısal yakalar. Mobil uygulamada özet ayrıca layoutSummary.alignment taşır: gutter (ekran kenarı boşluğu), leftEdges (aynı kapsamdaki geniş içeriğin sol kenar kümeleri — sözleşmede tek küme), surfaces (iç hizası bozuk yüzey kapları), widthOutliers (sağ kenarı sapan geniş öğeler, içeri itilme dp'si), offScaleGaps (0/4/8/16/24/32 dışı dikey aralıklar). Yan yana dizilen, ekran dışında kalan ve akış dışı (app-bar, fab, modal…) öğeler kıyasa girmez. Düğümler data-element-id taşımıyorsa layoutReportUnavailable döner."),
|
|
225
278
|
cookies: z.record(z.string()).optional().describe("Tarayıcıya enjekte edilecek EK çerezler (ad → değer): uygulamanın kendi oturum çerezi buraya verilir. Aynı ada sahip çerez gateway jetonunun yerine geçer. anonymous ile birlikte verilemez."),
|
|
226
279
|
actions: z.array(z.object({
|
|
227
280
|
action: z.enum(['set', 'click', 'wait', 'drag', 'tab', 'select', 'submit']),
|
|
@@ -230,8 +283,9 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
|
|
|
230
283
|
value: z.unknown().optional().describe("'set' için yazılacak değer. Tarih kutularına ISO yazın ('2026-08-01'); çok alanlı tarih aralığında kök DEĞİL kutu hedeflenir: '<elementId>__start' / '<elementId>__end'. 'tab' için sekmenin ANAHTARI ('iot') ya da görünen metni; 'select' için seçeneğin value'su ya da görünen metni"),
|
|
231
284
|
ms: z.number().int().min(0).max(15000).optional().describe("'wait' için bekleme süresi")
|
|
232
285
|
})).max(20).optional().describe("Kare ALINMADAN ÖNCE sayfada koşturulacak etkileşim adımları: [{action:'set', target:'flt_month', value:'2022-10'}, {action:'click', target:'btn_sign_in'}, {action:'tab', target:'tabs_settings', value:'iot'}, {action:'select', target:'dd_city', value:'34'}, {action:'submit', target:'frm_note'}, {action:'drag', target:'kb_board__card-42', to:'kb_board__col-Assigned'}]. 'tab' SEKME SEÇER: sekme grubunun köküne 'click' göndermek DOM sırasındaki İLK sekmeye gider ve ikinci sekme hiç açılamıyordu — tablist köküne click artık reddedilir ve bu fiile yönlendirir. Eşleme önce '<elementId>__tab-<sekme anahtarı>' kimliğiyle, o yoksa görünen metinle yapılır; actionsReport.matchedBy hangisi olduğunu, actionsReport.activeTab adımdan SONRA hangi sekmenin açık olduğunu söyler. Etkin olmayan sekmenin içeriği DOM'da YOKTUR: o sekmedeki bir düğüme yazmadan önce 'tab' adımı gerekir. 'select' açılır kutudan seçer — kutu native alan değildir, değeri yazmak hiçbir şey yapmaz, seçeneğe tıklanması gerekir; liste 3 sn'ye kadar YOKLANIR (sorgudan beslenen kutuda seçenekler geç basılır) ve actionsReport.optionsSeen + waitedMs neyin görüldüğünü söyler. 'submit' formu gönder butonu OLMADAN gönderir (form.requestSubmit); actionsReport.submitVia hangi yolun kullanıldığını yazar. 'drag' HTML5 sürükle-bırak olaylarını (dragstart→dragover→drop→dragend) hedefin merkezinde atar; kanban cardMove ve takvim eventMove bununla tetiklenir. 'set' native setter kullanır ve input+change olaylarını bubbles ile atar (düz DOM ataması framework'ün duyduğu olayı üretmez); ardından kök düğümün runtime prop'larını yeniden okur: actionsReport.propWritten değerin prop'a ULAŞIP ulaşmadığıdır ve false ise applied da false döner — DOM'a yazılmış ama bileşenin duymadığı değer 'uygulandı' sayılmaz (G-14). Her adımdan sonra yerleşme beklenir ve yanıttaki actionsReport hedefin bulunup bulunmadığını ve adımdan sonra KAÇ AĞ İSTEĞİ çıktığını söyler — 'bağ kuruldu' ile 'çalışıyor' arasındaki farkı ancak bu ayırır (G-24)."),
|
|
233
|
-
language: z.string().min(1).optional().describe("Kareyi BU DİLDE çeker: adrese '?lang=<kod>' eklenir ve runtime dili oradan seçer (öncelik: ?lang → tarayıcıda kayıtlı seçim → tarayıcı dilleri → projenin varsayılanı). Seçim hem çeviriye bağlı prop'ları hem çok dilli alanların satır değerlerini kapsar, yani ikinci dilin karesi için sayfaya dil değiştirici KOYMAK GEREKMEZ — referans tasarımı bozulmadan ikinci dil kanıtlanır. ISO 639-1 iki harfli kod ('tr', 'en'); bölgeli kod ('tr-TR') indirgenir ve indirgeme yanıtta bildirilir. Kod projenin languages listesinde yoksa çağrı REDDEDİLİR: runtime tanımadığı kodu yok sayıp kareyi varsayılan dilde çizerdi ve 'çevrildi' sanılan yanlış bir kare raporlanırdı."),
|
|
286
|
+
language: z.string().min(1).optional().describe("Kareyi BU DİLDE çeker: adrese '?lang=<kod>' eklenir ve runtime dili oradan seçer (öncelik: ?lang → tarayıcıda kayıtlı seçim → tarayıcı dilleri → projenin varsayılanı). Seçim hem çeviriye bağlı prop'ları hem çok dilli alanların satır değerlerini kapsar, yani ikinci dilin karesi için sayfaya dil değiştirici KOYMAK GEREKMEZ — referans tasarımı bozulmadan ikinci dil kanıtlanır. ISO 639-1 iki harfli kod ('tr', 'en'); bölgeli kod ('tr-TR') indirgenir ve indirgeme yanıtta bildirilir. Kod projenin languages listesinde yoksa çağrı REDDEDİLİR: runtime tanımadığı kodu yok sayıp kareyi varsayılan dilde çizerdi ve 'çevrildi' sanılan yanlış bir kare raporlanırdı. MOBİL uygulamada da geçerlidir (/preview aynı ?lang'i okur); cihazın kendisinde ?lang yoktur (platform_guide('mobile') §Çok dil)."),
|
|
234
287
|
colorScheme: z.enum(['light', 'dark']).optional().describe("Kareyi açık ya da koyu temada çeker. Ziyaretçi tema tercihi çerezde değil localStorage'da yaşar ve tema store'u onu sayfa açılırken bir kez okur; gateway tercihi sayfa script'lerinden ÖNCE eker, bu yüzden sayfada 'theme-toggle' komponenti OLMASA DA koyu tema karesi alınabilir. Verilmezse projenin kendi modu çizilir."),
|
|
288
|
+
motion: z.enum(['frozen', 'play']).optional().describe("Varsayılan 'frozen': bağlam 'hareketi azalt' (prefers-reduced-motion: reduce) ile açılır; mobil runtime hareketi dondurur ve kare tekrarlanabilir olur — diff'in imageUnchanged'ı ancak böyle anlamlıdır. Web sayfasında yalnız bu tercihe uyan CSS animasyonları durur. 'play': hareket oynar (giriş animasyonu, dönen gösterge, iskelet parıltısı); kare çekildiği ana bağlıdır, iki kare bayt bayt aynı çıkmayabilir ve yanıt bunu motionNote ile söyler. diff belleği iki kipi ayrı tutar."),
|
|
235
289
|
format: z.enum(['png', 'jpeg']).optional().describe("Kare biçimi; varsayılan 'png'. Doğrulama karesi için 'jpeg' + quality 60 bağlamı küçültür (ölçüldü 2026-09-16, aynı sayfa: scale 1'de png 8639 B / jpeg60 8691 B — kazanç yok; scale 0.5'te png 3603 B / jpeg60 3035 B). Asıl kaldıraç ÖLÇEKTİR; renk ve kenar keskinliğinin kendisi inceleniyorsa png'de kalın."),
|
|
236
290
|
quality: z.number().int().min(1).max(100).optional().describe("Yalnız format:'jpeg' ile: 1-100, doğrulama için 60 yeter. format 'png' iken verilirse çağrı reddedilir — PNG kayıpsızdır, kalite ayarı yoktur."),
|
|
237
291
|
scale: z.number().min(0.25).max(1).optional().describe("Karenin RASTER ölçeği (deviceScaleFactor); varsayılan 1. 0.5 verildiğinde sayfa yine 1280 CSS pikseli genişliğinde ÇİZİLİR ama kare 640 piksel çıkar: yerleşim, kırılım noktaları ve hideOn davranışı değişmez, yalnız görüntü küçülür. Dar ekran denemek için scale değil viewport kullanın. Yanıttaki imageSize ölçeğin gerçekten uygulandığını sayıyla gösterir."),
|
|
@@ -240,12 +294,12 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
|
|
|
240
294
|
z.object({ x: z.number(), y: z.number(), width: z.number().positive(), height: z.number().positive() })
|
|
241
295
|
]).optional().describe("Kareyi bir bölgeyle sınırlar: { element: '<elementId>' } o düğümün kutusunu, { x, y, width, height } elle verilen dikdörtgeni (CSS pikseli) kırpar — yan sütunu ya da tek kartı görmek için tüm sayfayı çekip elle kırpmaya gerek yok. Kutu katlanmış alanın altındaysa viewport onu kapsayana kadar BÜYÜTÜLÜR ve kutu yeniden okunur; düğüm yoksa ya da 0x0 çizildiyse çağrı boş kare yerine HATA döner."),
|
|
242
296
|
summary: z.union([z.enum(['compact', 'full']), z.literal(false)]).optional().describe("Sayfada NE GÖRÜNDÜĞÜNÜN metin özeti; varsayılan 'compact'. Her KÖK runtime düğümü için tek satır: kimlik (tip) · görünür|GİZLİ|ekran dışı · metnin ilk 80 karakteri · rows=<satır> · tab=<açık sekme> · value=<kutudaki değer> · BOŞ · errors=<sayı>; sonda toast ve hata sayfası mesajları. 'full' bunun yanına yapısal domSummary dizisini ve messages'ı koyar; false hiç toplamaz. 'Kart göründü mü, tablo doldu mu, hata var mı' sorularının cevabı buradadır — o sorular için KAREYE GEREK YOKTUR (image:'none' ile birlikte kullanın). Tip alanı runtime'ın data-component-type basmasına bağlıdır; basmıyorsa tipler yazılmaz ve summaryNote bunu söyler."),
|
|
243
|
-
diff: z.boolean().optional().describe("true: aynı sayfanın ÖNCEKİ çekimine göre ne değiştiğini döner (changes.added / removed / changed / messages) ve karenin bayt bayt aynı olup olmadığını söyler (imageUnchanged). Bellek gateway SÜRECİ içindedir: yeniden başlatılınca silinir ve ilk çağrı changes.firstCapture: true döner; sonraki çağrılar baselineAt taşır. Anahtar adres, kimlik, dil, tema, viewport, fullPage, actions, clip, scale ve biçimdir — asUser karesi gateway karesiyle karşılaştırılmaz."),
|
|
297
|
+
diff: z.boolean().optional().describe("true: aynı sayfanın ÖNCEKİ çekimine göre ne değiştiğini döner (changes.added / removed / changed / messages) ve karenin bayt bayt aynı olup olmadığını söyler (imageUnchanged). Bellek gateway SÜRECİ içindedir: yeniden başlatılınca silinir ve ilk çağrı changes.firstCapture: true döner; sonraki çağrılar baselineAt taşır. Anahtar adres, kimlik, dil, tema, hareket kipi, viewport, fullPage, actions, clip, scale ve biçimdir — asUser karesi gateway karesiyle karşılaştırılmaz."),
|
|
244
298
|
image: z.enum(['inline', 'none', 'ifChanged']).optional().describe("'none': kare HİÇ ÇEKİLMEZ, yanıt yalnız özet ve ölçümlerden oluşur — olgu doğrulamasının (kart göründü mü, tablo kaç satır) maliyeti bir kareden iki-üç kat küçüktür ve model bağlamına görüntü girmez. Varsayılan 'inline'. 'ifChanged': kare çekilir ama ÖNCEKİ çekimle bayt bayt aynıysa yanıta KONULMAZ (imageSkipped: true) — aynı sayfayı yeniden koştururken değişmemiş kareyi ikinci kez okumak bağlamın boşa gitmesidir; diff:true ima edilir. outPath ile 'none' birlikte verilemez (yazılacak kare üretilmiyor). Renk, hizalama, referansa sadakat gibi GÖRSEL sorular için kareyi açık bırakın."),
|
|
245
299
|
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')
|
|
246
300
|
},
|
|
247
301
|
annotations: readOnly
|
|
248
|
-
}, async ({ project, environment, applicationSlug, pageSlug, viewport, fullPage, delayMs, captureUnready, anonymous, asUser, cookies, layoutReport, actions, outPath, expectFailure, language, colorScheme, summary, image, format, quality, scale, clip, diff }) => {
|
|
302
|
+
}, async ({ project, environment, applicationSlug, pageSlug, viewport, device, fullPage, delayMs, captureUnready, anonymous, asUser, cookies, layoutReport, actions, outPath, expectFailure, language, colorScheme, motion, summary, image, format, quality, scale, clip, diff }) => {
|
|
249
303
|
try {
|
|
250
304
|
if (anonymous === true && (asUser !== undefined || cookies !== undefined)) {
|
|
251
305
|
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.");
|
|
@@ -289,10 +343,27 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
|
|
|
289
343
|
}
|
|
290
344
|
}
|
|
291
345
|
const url = `${config.studioBaseUrl}/${lane}/${projectSlug}/${applicationSlug}/${pageSlug}${languageChoice ? `?lang=${languageChoice.code}` : ''}`;
|
|
292
|
-
|
|
346
|
+
// Hedef ve cihaz uygulamanın platform profilinden (G3): mobil uygulama react-native-web
|
|
347
|
+
// çizimidir, varsayılan kare telefon ön ayarıdır. Tip okunamazsa web davranışı aynen.
|
|
348
|
+
const resolved = await resolveProfileBySlug(platform, projectSlug, applicationSlug);
|
|
349
|
+
const target = captureTargetFor(resolved.profile.capture.target);
|
|
350
|
+
const mobile = resolved.profile.platform === 'mobile';
|
|
351
|
+
if (device !== undefined && !mobile) {
|
|
352
|
+
throw new PlatformApiError(`page_screenshot: device yalnız MOBİL uygulamada geçerlidir — '${applicationSlug}' ${resolved.known ? 'bir web uygulaması' : 'uygulamasının tipi okunamadı (web varsayıldı)'}. Web'in dar ekran kırılımını görmek için viewport verin (ör. { width: 390, height: 844 }).`);
|
|
353
|
+
}
|
|
354
|
+
const deviceName = typeof device === 'string' ? device : device === undefined && mobile ? resolved.profile.capture.defaultDevice : undefined;
|
|
355
|
+
const preset = typeof device === 'object'
|
|
356
|
+
? { width: device.width, height: device.height, dpr: device.scale ?? 1 }
|
|
357
|
+
: deviceName === undefined ? undefined : resolved.profile.capture.devices[deviceName];
|
|
358
|
+
const appliedDevice = viewport === undefined && preset !== undefined ? preset : undefined;
|
|
359
|
+
const deviceNote = viewport !== undefined && device !== undefined
|
|
360
|
+
? 'viewport verildiği için device yok sayıldı: kare verilen viewport ve deviceScaleFactor 1 ile çekildi.'
|
|
361
|
+
: undefined;
|
|
362
|
+
const size = viewport ?? (appliedDevice ? { width: appliedDevice.width, height: appliedDevice.height } : { width: 1280, height: 800 });
|
|
363
|
+
const dpr = appliedDevice && appliedDevice.dpr !== 1 ? appliedDevice.dpr : undefined;
|
|
293
364
|
const extraCookies = Object.entries(cookies ?? {}).map(([name, value]) => ({ name, value }));
|
|
294
365
|
const identity = anonymous === true ? 'anonymous' : asUser === undefined ? 'gateway' : 'asUser';
|
|
295
|
-
const identityToken = anonymous ? undefined : resolveIdentity(asUser) ?? await platform.accessToken();
|
|
366
|
+
const identityToken = anonymous ? undefined : await resolveIdentity(asUser, platform, project, environment) ?? await platform.accessToken();
|
|
296
367
|
const cookieNames = [...new Set([...(identity === 'anonymous' ? [] : ['NG_AccessToken']), ...extraCookies.map(cookie => cookie.name)])];
|
|
297
368
|
const shot = await screenshotter.capture({
|
|
298
369
|
url,
|
|
@@ -306,6 +377,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
|
|
|
306
377
|
...(captureUnready === true ? { captureUnready: true } : {}),
|
|
307
378
|
...(layoutReport === true ? { layoutReport: true } : {}),
|
|
308
379
|
...(colorScheme === undefined ? {} : { colorScheme }),
|
|
380
|
+
...(motion === 'play' ? { motion } : {}),
|
|
309
381
|
// B-2: `summary:false` + `diff` verildiğinde özet yine toplanır — fark ona dayanır ve
|
|
310
382
|
// toplanmazsa bellek hiç yazılmaz, `ifChanged` sessizce ölü bir özellik olurdu.
|
|
311
383
|
...(summary === false && !(diff === true || image === 'ifChanged') ? { summary: false } : {}),
|
|
@@ -314,7 +386,9 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
|
|
|
314
386
|
...(quality === undefined ? {} : { quality }),
|
|
315
387
|
...(scale === undefined ? {} : { scale }),
|
|
316
388
|
...(clip === undefined ? {} : { clip: clip }),
|
|
317
|
-
...(actions === undefined ? {} : { actions: actions })
|
|
389
|
+
...(actions === undefined ? {} : { actions: actions }),
|
|
390
|
+
...(mobile ? { target } : {}),
|
|
391
|
+
...(dpr === undefined ? {} : { dpr })
|
|
318
392
|
});
|
|
319
393
|
// Fark ÖZETTEN çıkar; `summary:false` verilse de fark için toplanmıştır (yanıta girmez).
|
|
320
394
|
// Anahtar KİMLİĞİ ayırır (K8): 'asUser' etiketi yetmez — iki farklı üyenin jetonu aynı
|
|
@@ -328,6 +402,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
|
|
|
328
402
|
cookieValues: extraCookies.map(cookie => `${cookie.name}=${cookie.value}`),
|
|
329
403
|
language: languageChoice?.code,
|
|
330
404
|
colorScheme,
|
|
405
|
+
motion: motion ?? 'frozen',
|
|
331
406
|
viewport: size,
|
|
332
407
|
fullPage: fullPage === true,
|
|
333
408
|
actions,
|
|
@@ -384,7 +459,13 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
|
|
|
384
459
|
...(languageChoice ? { language: languageChoice.code } : {}),
|
|
385
460
|
...(languageChoice?.note ? { languageNote: languageChoice.note } : {}),
|
|
386
461
|
...(colorScheme === undefined ? {} : { colorScheme }),
|
|
462
|
+
...(motion === 'play' ? { motion, motionNote: 'Hareket açık: kare çekildiği ana bağlıdır, aynı sayfanın iki karesi bayt bayt aynı çıkmayabilir (diff imageUnchanged hareketi ölçmez). Tekrarlanabilir kare için motion verilmez.' } : {}),
|
|
387
463
|
viewport: size,
|
|
464
|
+
...(appliedDevice === undefined ? {} : { device: typeof device === 'object' ? { ...device } : deviceName, deviceScaleFactor: appliedDevice.dpr }),
|
|
465
|
+
...(deviceNote === undefined ? {} : { deviceNote }),
|
|
466
|
+
// Web karesinin yanıtı profil öncesiyle aynı kalır (G3 kısıtı); alan yalnız mobilde.
|
|
467
|
+
...(mobile ? applicationTypeField(resolved) : {}),
|
|
468
|
+
...(target.platformNote === undefined ? {} : { platformNote: target.platformNote }),
|
|
388
469
|
fullPage: fullPage === true,
|
|
389
470
|
identity,
|
|
390
471
|
cookieNames,
|
|
@@ -475,13 +556,24 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
|
|
|
475
556
|
runtimeErrors: shot.runtimeErrors,
|
|
476
557
|
runtimeErrorsNote: `Sayfa akışı ${shot.runtimeErrors.length} yapısal hata bıraktı; kare 'çalışıyor' görünse bile bu adımlar işini YAPMADI. element/property alanı hangi komponentin hangi prop'unun yazılamadığını söyler — o komponent eski/boş değerindedir. Adımı flow_get ile açıp ifadeyi düzeltin.`
|
|
477
558
|
}),
|
|
559
|
+
...(shot.expressionErrors === undefined
|
|
560
|
+
? {}
|
|
561
|
+
: { expressionErrors: shot.expressionErrors, expressionErrorsNote: expressionErrorsNote(shot.expressionErrors) }),
|
|
562
|
+
...(shot.renderErrors === undefined
|
|
563
|
+
? {}
|
|
564
|
+
: {
|
|
565
|
+
renderErrors: shot.renderErrors,
|
|
566
|
+
renderErrorsNote: `${shot.renderErrors.length} düğüm çizilemedi: sayfanın geri kalanı çizildi, bu düğümlerin yerinde hata yer tutucusu var. message bileşen tipini ve hatayı söyler; genelde prop değeri ya da bileşenin kendisi (ARC kaydı).`
|
|
567
|
+
}),
|
|
568
|
+
...(shot.pageErrors === undefined ? {} : { pageErrors: shot.pageErrors }),
|
|
569
|
+
...(shot.consoleErrors === undefined ? {} : { consoleErrors: shot.consoleErrors }),
|
|
478
570
|
...(actionNotes.length === 0 ? {} : { actionsNote: actionNotes.join('\n') }),
|
|
479
571
|
...(shot.layout === undefined
|
|
480
572
|
? {}
|
|
481
573
|
: shot.layout.length === 0
|
|
482
574
|
? { layoutReportUnavailable: true, note: "Sayfada data-element-id taşıyan düğüm yok — runtime bu attribute'u henüz basmıyor olabilir (F-04) ya da sayfa boş render edildi." }
|
|
483
575
|
: {
|
|
484
|
-
layoutSummary: summarizeLayout(shot.layout, size),
|
|
576
|
+
layoutSummary: summarizeLayout(shot.layout, size, { alignment: mobile }),
|
|
485
577
|
...(shot.layout.length <= 100 ? { layout: shot.layout } : { layoutTruncatedTo: 'summary' })
|
|
486
578
|
})
|
|
487
579
|
};
|
|
@@ -524,31 +616,73 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
|
|
|
524
616
|
});
|
|
525
617
|
server.registerTool('page_schema_get', {
|
|
526
618
|
title: 'Sayfa şemasını oku',
|
|
527
|
-
description: "Sayfanın komponent şemasını okur. Yanıttaki version değerini page_schema_patch'e baseVersion olarak verin: sayfa o okumadan beri değiştiyse yama 409 ile reddedilir ve hiçbir op uygulanmaz.",
|
|
619
|
+
description: "Sayfanın komponent şemasını okur. Yanıttaki version değerini page_schema_patch'e baseVersion olarak verin: sayfa o okumadan beri değiştiyse yama 409 ile reddedilir ve hiçbir op uygulanmaz. full ve subtree yanıtı nodeCount taşır. full tek yanıta sığmazsa HATA döner (sessiz kırpma yok): cursor:'0' ile parça parça okuyun — her parça items[] ({ parentElementId, index, node }) taşır, kalem parentElementId düğümünün children[index]'inin yerine geçer (parentElementId yoksa kök dizinin [index]'i), alt ağacı sığmayan düğüm kabuk gelir (children: [{ elementId, deferred: true }]) ve sonraki parçalar onu doldurur; nextCursor bitene kadar sürün. allowTruncated:true kırpılmış gövdeyi açıkça verir (truncated: true; hangi düğümlerin düştüğü söylenmez) — o gövdeyi page_update'e geri yazmayın (PAGE-037).",
|
|
528
620
|
inputSchema: {
|
|
529
621
|
project: projectParam,
|
|
530
622
|
environment: environmentParam,
|
|
531
623
|
applicationId: guid,
|
|
532
624
|
pageId: guid,
|
|
533
|
-
mode: modeParam,
|
|
534
|
-
componentId: z.string().optional().describe("subtree kipinde kök alınacak komponentin elementId'si")
|
|
625
|
+
mode: modeParam.describe("summary (varsayılan): yalnız id/elementId/name/type ağacı — hedef bulmak için bunu kullanın. subtree: componentId ile tek alt ağaç. full: tüm şema; tek yanıta sığmazsa HATA döner — cursor:'0' ile parça parça okuyun (nextCursor bitene kadar) ya da allowTruncated:true ile kırpılmış gövdeyi açıkça isteyin."),
|
|
626
|
+
componentId: z.string().optional().describe("subtree kipinde kök alınacak komponentin elementId'si"),
|
|
627
|
+
cursor: z.string().min(1).optional().describe("Yalnız mode:'full': parçalı okuma. İlk çağrıda '0', sonra yanıttaki nextCursor; nextCursor gelmeyince şema bitmiştir. Sayfa okuma arasında değişirse 409 döner — cursor:'0' ile baştan başlayın."),
|
|
628
|
+
allowTruncated: z.boolean().optional().describe("Yalnız mode:'full': true verilirse sığmayan şema hata yerine kırpılarak döner (truncated: true, nodeCount toplamı söyler, düşen düğümler söylenmez). Varsayılan false: sığmayan şema hata verir.")
|
|
535
629
|
},
|
|
536
630
|
annotations: readOnly
|
|
537
|
-
}, handle(config, async ({ project, environment, applicationId, pageId, mode, componentId }) => {
|
|
631
|
+
}, handle(config, async ({ project, environment, applicationId, pageId, mode, componentId, cursor, allowTruncated }) => {
|
|
538
632
|
const page = await fetchPage(platform, project, environment, applicationId, pageId);
|
|
633
|
+
const typeField = applicationTypeField(await resolveProfile(platform, applicationId));
|
|
539
634
|
const updatedAt = page.audit?.updatedAt ?? page.audit?.createdAt;
|
|
540
635
|
const version = page.version;
|
|
541
|
-
|
|
542
|
-
|
|
636
|
+
rememberVersion(project, environment, pageId, version);
|
|
637
|
+
if (cursor !== undefined && mode !== 'full') {
|
|
638
|
+
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);
|
|
639
|
+
}
|
|
640
|
+
if (mode === 'full') {
|
|
641
|
+
const schema = page.schema ?? [];
|
|
642
|
+
const nodeCount = countSchemaNodes(schema);
|
|
643
|
+
const versionKey = String(version ?? '');
|
|
644
|
+
if (cursor !== undefined) {
|
|
645
|
+
const decoded = decodeSchemaCursor(cursor);
|
|
646
|
+
if (!decoded)
|
|
647
|
+
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);
|
|
648
|
+
if (decoded.version !== undefined && decoded.version !== versionKey) {
|
|
649
|
+
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);
|
|
650
|
+
}
|
|
651
|
+
const parts = splitSchemaIntoParts(schema, Math.floor(config.maxResponseBytes * 0.75));
|
|
652
|
+
const items = parts[decoded.partIndex];
|
|
653
|
+
if (!items)
|
|
654
|
+
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);
|
|
655
|
+
const nextIndex = decoded.partIndex + 1;
|
|
656
|
+
return {
|
|
657
|
+
version,
|
|
658
|
+
updatedAt,
|
|
659
|
+
...typeField,
|
|
660
|
+
nodeCount,
|
|
661
|
+
part: { index: decoded.partIndex, count: parts.length, nodes: countSchemaNodes(items.map(item => item.node)) },
|
|
662
|
+
items,
|
|
663
|
+
...(nextIndex < parts.length ? { nextCursor: encodeSchemaCursor(versionKey, nextIndex) } : {})
|
|
664
|
+
};
|
|
665
|
+
}
|
|
666
|
+
const full = { version, updatedAt, ...typeField, nodeCount, schema };
|
|
667
|
+
const chars = (JSON.stringify(prune(full)) ?? '').length;
|
|
668
|
+
if (chars > config.maxResponseBytes) {
|
|
669
|
+
if (allowTruncated !== true) {
|
|
670
|
+
const kb = (value) => (value / 1024).toFixed(1);
|
|
671
|
+
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);
|
|
672
|
+
}
|
|
673
|
+
schemaReadMemory.markTruncated(readKey(project, environment, pageId, version));
|
|
674
|
+
}
|
|
675
|
+
return full;
|
|
676
|
+
}
|
|
543
677
|
if (mode === 'subtree') {
|
|
544
678
|
if (!componentId)
|
|
545
679
|
throw new PlatformApiError("mode='subtree' için componentId zorunludur.");
|
|
546
680
|
const subtree = findNode(page.schema, componentId);
|
|
547
681
|
if (!subtree)
|
|
548
682
|
throw new PlatformApiError(`Sayfada '${componentId}' id'li bir komponent yok; page_schema_get'i summary kipinde çağırıp hedefi doğrulayın.`);
|
|
549
|
-
return { version, updatedAt, schema: subtree };
|
|
683
|
+
return { version, updatedAt, ...typeField, nodeCount: countSchemaNodes([subtree]), schema: subtree };
|
|
550
684
|
}
|
|
551
|
-
return { version, updatedAt, schema: (page.schema ?? []).map(node => summarize(node)) };
|
|
685
|
+
return { version, updatedAt, ...typeField, schema: (page.schema ?? []).map(node => summarize(node)) };
|
|
552
686
|
}));
|
|
553
687
|
server.registerTool('page_state', {
|
|
554
688
|
title: 'Sayfa durumunu getir',
|
|
@@ -569,25 +703,41 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
|
|
|
569
703
|
// Kuru koşu ile yazma AYNI gövdeyi görür (P0-2 Step 3): resize_component burada da sunucu
|
|
570
704
|
// op'larına çevrilir, platform dokunulan düğümleri aynı kapsamla doğrular.
|
|
571
705
|
const opRecords = allOps.filter(entry => entry.op !== 'resize_component');
|
|
706
|
+
const resolved = await resolveProfile(platform, applicationId);
|
|
707
|
+
// ARC-143: kuru koşu page_schema_patch'in add_component kapısını (PAGE-009 · 011 · 012 · 013)
|
|
708
|
+
// atlıyordu; ayrılmış adlı komponent validate'ten geçip yamada reddediliyordu.
|
|
709
|
+
assertScreenWriteGuards('page', { schema: opRecords.filter(entry => entry.op === 'add_component').map(entry => entry.component) }, resolved.profile.platform);
|
|
572
710
|
const normalized = normalizeSchemaOps(opRecords);
|
|
573
711
|
const validationIssues = [
|
|
574
712
|
...schemaOpValidationErrors(opRecords).map(issue => `PAGE-016 — ${issue}`),
|
|
575
713
|
...codePropTemplateErrors(opRecords).map(issue => `PAGE-032 — ${issue}`)
|
|
576
714
|
];
|
|
577
|
-
const
|
|
715
|
+
const spacing = await mobileSpacingForOps(resolved.profile.platform, opRecords, () => fetchPage(platform, project, environment, applicationId, pageId));
|
|
716
|
+
const ordering = resolved.profile.layout.orderBy === 'block-position'
|
|
717
|
+
? await orderByIndex(opRecords, () => fetchPage(platform, project, environment, applicationId, pageId))
|
|
718
|
+
: { ops: opRecords, moved: [], warnings: [] };
|
|
719
|
+
const writesStyle = resolved.profile.platform !== 'web' && opRecords.some(entry => (entry.op === 'replace_prop' || entry.op === 'set_binding') && entry.prop === 'style');
|
|
720
|
+
const profileWarnings = await screenProfileWarnings(platform, resolved, project, environment, applicationId, {
|
|
721
|
+
kind: 'page',
|
|
722
|
+
ops: opRecords,
|
|
723
|
+
savedNodes: writesStyle ? await fetchPage(platform, project, environment, applicationId, pageId).then(page => page.schema, () => undefined) : undefined
|
|
724
|
+
});
|
|
578
725
|
const response = ((await platform.tenant('POST', project, `/pages/${applicationId}/${pageId}/schema/validate`, {
|
|
579
726
|
environment,
|
|
580
727
|
body: { ops: [...allOps.filter(entry => entry.op === 'resize_component').flatMap(resizeServerOps), ...ordering.ops] }
|
|
581
728
|
})) ?? {});
|
|
729
|
+
const skeletonWarnings = await simulatedPageLayoutWarnings(platform, resolved, project, environment, applicationId, () => fetchPage(platform, project, environment, applicationId, pageId), opRecords, 'audit');
|
|
582
730
|
if (validationIssues.length > 0)
|
|
583
731
|
response.validationWarnings = validationIssues;
|
|
584
|
-
if (ordering.warnings.length > 0)
|
|
585
|
-
response.layoutWarnings = ordering.warnings;
|
|
732
|
+
if (ordering.warnings.length > 0 || profileWarnings.length > 0 || skeletonWarnings.length > 0)
|
|
733
|
+
response.layoutWarnings = [...ordering.warnings, ...profileWarnings, ...skeletonWarnings];
|
|
734
|
+
Object.assign(response, applicationTypeField(resolved));
|
|
586
735
|
return withNormalization(response, [
|
|
587
736
|
...componentDefaultsNote(normalized.components),
|
|
588
737
|
...validationNote(normalized.validations),
|
|
589
738
|
...replacePropNote(normalized.props),
|
|
590
|
-
...flexIndexOrderNote(ordering.moved)
|
|
739
|
+
...flexIndexOrderNote(ordering.moved),
|
|
740
|
+
...mobileSpacingNote(spacing)
|
|
591
741
|
]);
|
|
592
742
|
}));
|
|
593
743
|
server.registerTool('page_schema_patch', {
|
|
@@ -638,18 +788,6 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
|
|
|
638
788
|
throw new PlatformApiError(`Sayfa siz okuduktan sonra değişmiş (updatedAt: ${updatedAt}). page_schema_get ile yeniden okuyup planı tazeleyin.`, 409);
|
|
639
789
|
}
|
|
640
790
|
}
|
|
641
|
-
// BX-002: bölge anahtarı Studio'da düğüm kurar; aynısı yamaya burada eklenir ki eklenen
|
|
642
|
-
// bölge düğümü de aşağıdaki normalizasyon ve doğrulama duvarından geçsin.
|
|
643
|
-
let sectionNotes = [];
|
|
644
|
-
if (opRecords.some(entry => entry.op === 'add_component' || (entry.op === 'replace_prop' && (entry.prop === 'hasHeader' || entry.prop === 'hasFooter')))) {
|
|
645
|
-
const schema = await readPage().then(page => page.schema ?? []).catch(() => []);
|
|
646
|
-
const taken = collectIds(schema, new Set());
|
|
647
|
-
const addedBodies = opRecords.filter(entry => entry.op === 'add_component').map(entry => entry.component);
|
|
648
|
-
collectIds(addedBodies, taken);
|
|
649
|
-
const created = ensureBoxSections(addedBodies, taken);
|
|
650
|
-
const toggles = expandSectionToggles(opRecords, schema, taken);
|
|
651
|
-
sectionNotes = boxSectionNote([...created, ...toggles.created], toggles.removed);
|
|
652
|
-
}
|
|
653
791
|
const normalized = normalizeSchemaOps(opRecords);
|
|
654
792
|
for (const entry of opRecords)
|
|
655
793
|
reject('PAGE-016', entry, schemaOpValidationErrors([entry]));
|
|
@@ -682,14 +820,21 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
|
|
|
682
820
|
retargeted = retargetRootAdds(opRecords, PAGE_CONTAINER_ELEMENT_ID);
|
|
683
821
|
}
|
|
684
822
|
}
|
|
685
|
-
const
|
|
823
|
+
const resolved = await resolveProfile(platform, applicationId);
|
|
824
|
+
const spacing = await mobileSpacingForOps(resolved.profile.platform, opRecords, readPage);
|
|
825
|
+
const blocksMeaningful = resolved.profile.layout.blocksMeaningful;
|
|
826
|
+
// Mobil (dizi sırası): index platformun kendi add/move index'idir, konum çevirisi yapılmaz.
|
|
827
|
+
const ordering = resolved.profile.layout.orderBy === 'block-position'
|
|
828
|
+
? await orderByIndex(opRecords, readPage)
|
|
829
|
+
: { ops: opRecords, moved: [], warnings: [] };
|
|
686
830
|
const sentOps = ordering.ops;
|
|
687
831
|
// Akış silen op'lar yamadan ÖNCE hesaplanır: uyarı sonradan geldiğinde akış zaten kalıcı
|
|
688
832
|
// silinmiş oluyordu ve "önce yedekle" tavsiyesi uygulanamıyordu (09-05 koşusu, G-21).
|
|
689
833
|
let deletedFlows = [];
|
|
690
834
|
// remove_event opRecords'ta değil, ayrı listede durur; koşul yalnız opRecords'a baktığı sürece
|
|
691
835
|
// yalnız olay kaldıran bir yama bu korumayı hiç tetiklemiyordu (2026-09-14).
|
|
692
|
-
|
|
836
|
+
// `batch` içindeki silme de planı gerektirir; açma `orphanedFlowPlan`'da.
|
|
837
|
+
if ([...opRecords, ...removeEventOps].some(entry => ['remove_component', 'set_event', 'remove_event', 'batch'].includes(String(entry.op)))) {
|
|
693
838
|
try {
|
|
694
839
|
const page = await readPage();
|
|
695
840
|
deletedFlows = orphanedFlowPlan(page.schema, page.events, [...opRecords, ...removeEventOps]);
|
|
@@ -704,7 +849,7 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
|
|
|
704
849
|
const added = opRecords
|
|
705
850
|
.filter(entry => entry.op === 'add_component')
|
|
706
851
|
.map(entry => entry.component);
|
|
707
|
-
assertScreenWriteGuards('page', { schema: added });
|
|
852
|
+
assertScreenWriteGuards('page', { schema: added }, resolved.profile.platform);
|
|
708
853
|
const catalogNotes = await screenCatalogNotes(platform, project, environment, applicationId, added);
|
|
709
854
|
const formWarnings = [...formBindingWarnings(opRecords), ...formSubmitButtonWarnings(opRecords)];
|
|
710
855
|
let flowWarnings = [];
|
|
@@ -742,10 +887,10 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
|
|
|
742
887
|
// görünür, iç içeliği ancak hedef parent zinciri belli olunca anlarsın.
|
|
743
888
|
nestedAfterOps = nestedRepeaterNodes(simulated);
|
|
744
889
|
layoutWarnings = [
|
|
745
|
-
...pageContainerPositionWarning(page.schema),
|
|
746
|
-
...verticalGapWarnings(simulated, 'PAGE-010 (uyarı)', touched),
|
|
890
|
+
...(blocksMeaningful ? pageContainerPositionWarning(page.schema) : []),
|
|
891
|
+
...(blocksMeaningful ? verticalGapWarnings(simulated, 'PAGE-010 (uyarı)', touched) : []),
|
|
747
892
|
...stringStyleWarning(stringStyleNodes(simulated)),
|
|
748
|
-
...inertFlexPropWarning(inertFlexPropNodes(simulated)),
|
|
893
|
+
...(resolved.profile.layout.modes.has('grid') ? inertFlexPropWarning(inertFlexPropNodes(simulated)) : []),
|
|
749
894
|
...flexSizeWarnings(simulated, 'PAGE-017 (uyarı)', 'PAGE-018 (uyarı)'),
|
|
750
895
|
...spacingLayerWarnings(simulated, 'PAGE-029 (uyarı)', 'PAGE-030 (uyarı)')
|
|
751
896
|
];
|
|
@@ -755,22 +900,54 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
|
|
|
755
900
|
}
|
|
756
901
|
}
|
|
757
902
|
if (nestedAfterOps.length > 0)
|
|
758
|
-
throw new PlatformApiError(nestedRepeaterMessage(nestedAfterOps), 400);
|
|
903
|
+
throw new PlatformApiError(nestedRepeaterMessage(nestedAfterOps, resolved.profile.platform), 400);
|
|
759
904
|
const removedEvents = planEventRemovals(removeEventOps);
|
|
760
905
|
const resized = resizeOps.length > 0 ? planResizes((await readPage()).schema ?? [], resizeOps) : { serverOps: [], applied: [], warnings: [] };
|
|
761
906
|
const propTypes = propTypeOps.length > 0 ? planPropTypes((await readPage()).schema ?? [], propTypeOps) : { serverOps: [], applied: [] };
|
|
762
907
|
const serverOps = [...removeEventOps, ...resized.serverOps, ...propTypes.serverOps, ...sentOps];
|
|
763
|
-
|
|
908
|
+
const writesStyle = resolved.profile.platform !== 'web' && opRecords.some(entry => (entry.op === 'replace_prop' || entry.op === 'set_binding') && entry.prop === 'style');
|
|
909
|
+
const profileWarnings = await screenProfileWarnings(platform, resolved, project, environment, applicationId, {
|
|
910
|
+
kind: 'page',
|
|
911
|
+
ops: [...opRecords, ...propTypeOps],
|
|
912
|
+
savedNodes: writesStyle ? await readPage().then(page => page.schema, () => undefined) : undefined,
|
|
913
|
+
steps: await boundFlowSteps(platform, resolved, project, environment, 'page', applicationId, pageId, opRecords)
|
|
914
|
+
});
|
|
915
|
+
const skeletonWarnings = reshapesSkeleton(opRecords)
|
|
916
|
+
? await simulatedPageLayoutWarnings(platform, resolved, project, environment, applicationId, readPage, sentOps, 'new')
|
|
917
|
+
: [];
|
|
918
|
+
layoutWarnings = [...ordering.warnings, ...layoutWarnings, ...profileWarnings, ...skeletonWarnings];
|
|
764
919
|
// Tek istek, tek sürüm: öykünülen op'lar 2026-09-14'e kadar ayrı GET + tam PUT çiftleriydi ve
|
|
765
920
|
// yamadan ÖNCE yazılıyordu — PATCH reddedilse bile kalıcıydılar. Artık hepsi aynı atomik PATCH'te.
|
|
766
921
|
// baseVersion yalnız biliniyorsa gider (ajanın verdiği ya da bu çağrıda zaten okunan sayfanınki):
|
|
767
922
|
// sürümü öğrenmek için ayrı GET atılmaz, platform satırı her yamada kilitler.
|
|
923
|
+
const sentVersion = baseVersion ?? (typeof cachedPage?.version === 'string' ? cachedPage.version : undefined);
|
|
768
924
|
const response = ((await platform.tenant('PATCH', project, `/pages/${applicationId}/${pageId}/schema`, {
|
|
769
925
|
environment,
|
|
770
|
-
body: { ops: serverOps, baseVersion:
|
|
926
|
+
body: { ops: serverOps, baseVersion: sentVersion }
|
|
927
|
+
}).catch(async (error) => {
|
|
928
|
+
throw await versionConflict(error, project, environment, applicationId, pageId, sentVersion, "page_schema_get ile yeniden okuyup planı tazeleyin ve yeni version'ı baseVersion olarak gönderin; aynı op'ları eski sürümle tekrar göndermek yine 409 alır.");
|
|
771
929
|
})) ?? {});
|
|
930
|
+
const patched = (response.data && typeof response.data === 'object' && !Array.isArray(response.data) ? response.data : response);
|
|
931
|
+
const unchanged = Array.isArray(patched.unchanged) ? patched.unchanged.map(String) : [];
|
|
932
|
+
rememberVersion(project, environment, pageId, patched.newVersion);
|
|
933
|
+
// g-05: platform (b-05) aynı yere aynı içerikle zaten duran add_component'i etkisiz sayar; bütün
|
|
934
|
+
// op'lar etkisizse yazmaz ve eski baseVersion'a 409 demez. Ajan bunu "hata yok ama bir şey de
|
|
935
|
+
// olmadı" diye okumasın: yanıtı kaybolan çağrının tekrarı olduğu açıkça söylenir.
|
|
936
|
+
if (unchanged.length > 0) {
|
|
937
|
+
response.alreadyApplied = patched.noop !== true
|
|
938
|
+
? `Şu op'lar sayfada zaten duruyordu, yeniden yazılmadı (tekrar zararsız): ${unchanged.join(', ')}. Diğer op'lar uygulandı.`
|
|
939
|
+
: patched.stale === true
|
|
940
|
+
? `Bu yamanın bütün op'ları sayfada zaten duruyor (${unchanged.join(', ')}) — hiçbir şey yazılmadı. AMA sayfa gönderdiğiniz baseVersion'dan beri başka bir yazımla da değişti: newVersion sizin gönderdiğiniz sürümdür, güncel sürüm değil. Devam etmeden önce page_schema_get ile güncel hâli okuyun; eski sürümle gelen sonraki yazma 409 alır.`
|
|
941
|
+
: `Bu yamanın bütün op'ları sayfada zaten duruyor (${unchanged.join(', ')}): büyük olasılıkla önceki çağrı uygulandı ama yanıtı size ulaşmadı. Tekrar zararsızdır — hiçbir şey yazılmadı, sürüm artmadı; newVersion sayfanın güncel sürümüdür.`;
|
|
942
|
+
}
|
|
772
943
|
if (view !== 'full')
|
|
773
944
|
outlineWriteResponse(response);
|
|
945
|
+
if (baseVersion && schemaReadMemory.wasTruncated(readKey(project, environment, pageId, baseVersion))) {
|
|
946
|
+
response.warnings = [
|
|
947
|
+
...(Array.isArray(response.warnings) ? response.warnings : []),
|
|
948
|
+
`PAGE-038 (uyarı) — baseVersion '${baseVersion}' bu gateway'de page_schema_get allowTruncated:true ile KIRPIK okundu; plan düşen düğümleri görmeden yapılmış olabilir. Micro-op veri düşürmez ve yama uygulandı, ama hedef ve konumları page_schema_get mode:'summary' ya da cursor:'0' ile tam okuyup doğrulayın.`
|
|
949
|
+
];
|
|
950
|
+
}
|
|
774
951
|
if (removedEvents.length > 0)
|
|
775
952
|
response.removedEvents = removedEvents;
|
|
776
953
|
if (propTypes.applied.length > 0)
|
|
@@ -814,14 +991,15 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
|
|
|
814
991
|
opDrops = emptyWriteDiff();
|
|
815
992
|
}
|
|
816
993
|
}
|
|
994
|
+
Object.assign(response, applicationTypeField(resolved));
|
|
817
995
|
return withWriteDiff(withNormalization(response, [
|
|
818
996
|
...rootAddsNote(retargeted, PAGE_CONTAINER_ELEMENT_ID),
|
|
819
|
-
...sectionNotes,
|
|
820
997
|
...componentDefaultsNote(normalized.components),
|
|
821
998
|
...validationNote(normalized.validations),
|
|
822
999
|
...catalogNotes,
|
|
823
1000
|
...replacePropNote(normalized.props),
|
|
824
|
-
...flexIndexOrderNote(ordering.moved)
|
|
1001
|
+
...flexIndexOrderNote(ordering.moved),
|
|
1002
|
+
...mobileSpacingNote(spacing)
|
|
825
1003
|
]), opDrops);
|
|
826
1004
|
}));
|
|
827
1005
|
server.registerTool('page_discover', {
|
|
@@ -855,20 +1033,33 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
|
|
|
855
1033
|
events: eventsParam.optional(),
|
|
856
1034
|
schema: schemaParam.optional(),
|
|
857
1035
|
view: writeViewParam,
|
|
858
|
-
ifExists: ifExistsParam('sayfa', "mevcut sayfayı page_update gibi günceller — yalnız bu çağrıda VERİLEN alanlar yazılır, verilmeyen şema/olaylar/roller korunur (page_schema_patch ile kurulmuş şema betik tekrar koşunca silinmez); id'si ve flow'ları korunur")
|
|
1036
|
+
ifExists: ifExistsParam('sayfa', "mevcut sayfayı page_update gibi günceller — yalnız bu çağrıda VERİLEN alanlar yazılır, verilmeyen şema/olaylar/roller korunur (page_schema_patch ile kurulmuş şema betik tekrar koşunca silinmez); id'si ve flow'ları korunur. Şema verilirse sayfanın şeması BİLEREK tam yazılır (page_update force:true gibi — gateway sayfayı okuduğu anın sürümüyle yazar, aradaki Studio değişikliği ezilir); hedefli değişiklik için page_schema_patch")
|
|
859
1037
|
},
|
|
860
1038
|
annotations: writes
|
|
861
1039
|
}, handle(config, async ({ project, environment, applicationId, name, slug, browserTitle, browserTitleKey, layoutId, roleIds, middlewareIds, events, schema, view, ifExists }) => {
|
|
862
|
-
const
|
|
863
|
-
|
|
1040
|
+
const resolved = await resolveProfile(platform, applicationId);
|
|
1041
|
+
const blocksMeaningful = resolved.profile.layout.blocksMeaningful;
|
|
1042
|
+
const container = ensurePageContainer(schema ?? [], resolved.profile.layout.rootContainer);
|
|
1043
|
+
const spacing = emptyMobileSpacingFix();
|
|
1044
|
+
// Kabuksuz iskelet yalnız gateway'in kurduğu köke uygulanır; sayfanın layout'u yazımda kesinleşir.
|
|
1045
|
+
const templateRoot = resolved.profile.platform === 'mobile' && container.fixes.length > 0 ? container.schema[0] : undefined;
|
|
1046
|
+
let skeletonNotes = [];
|
|
1047
|
+
if (resolved.profile.platform === 'mobile') {
|
|
1048
|
+
for (const root of container.schema)
|
|
1049
|
+
applyMobileSpacingDefaults(root.children, [], spacing, String(root.elementId ?? ''));
|
|
1050
|
+
}
|
|
1051
|
+
assertScreenWriteGuards('page', { schema: container.schema, events }, resolved.profile.platform);
|
|
864
1052
|
const stringStyles = stringStyleNodes(container.schema);
|
|
865
1053
|
const fixed = normalizeComponentDefaults(container.schema);
|
|
866
|
-
|
|
1054
|
+
// Mobil çizer blokları okumaz (D3): kök konumu sıfırlama, blok sıralama ve dikey boşluk
|
|
1055
|
+
// uyarısı yalnız ızgaranın anlamlı olduğu profilde koşar.
|
|
1056
|
+
const reset = blocksMeaningful ? resetPageContainerPosition(container.schema) : [];
|
|
867
1057
|
const catalogNotes = (schema ?? []).length > 0
|
|
868
1058
|
? await screenCatalogNotes(platform, project, environment, applicationId, container.schema)
|
|
869
1059
|
: [];
|
|
870
|
-
const moved = reorderSchemaBlocks(container.schema);
|
|
871
|
-
const gaps = (schema ?? []).length > 0 ? verticalGapWarnings(container.schema, 'PAGE-010 (uyarı)') : [];
|
|
1060
|
+
const moved = blocksMeaningful ? reorderSchemaBlocks(container.schema) : [];
|
|
1061
|
+
const gaps = (schema ?? []).length > 0 && blocksMeaningful ? verticalGapWarnings(container.schema, 'PAGE-010 (uyarı)') : [];
|
|
1062
|
+
const profileWarnings = await screenProfileWarnings(platform, resolved, project, environment, applicationId, { kind: 'page', nodes: container.schema });
|
|
872
1063
|
const existing = await existingMatch({
|
|
873
1064
|
code: 'PAGE-035',
|
|
874
1065
|
noun: 'sayfa',
|
|
@@ -885,6 +1076,9 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
|
|
|
885
1076
|
if (existing !== undefined) {
|
|
886
1077
|
const pageId = String(existing.id);
|
|
887
1078
|
const current = await fetchHost(platform, 'page', project, environment, applicationId, pageId);
|
|
1079
|
+
if (templateRoot && schema !== undefined && (layoutId ?? current.layoutId ?? current.layout?.id ?? null) === null) {
|
|
1080
|
+
skeletonNotes = shellLessPageSkeleton(templateRoot);
|
|
1081
|
+
}
|
|
888
1082
|
const overrides = Object.fromEntries(Object.entries({
|
|
889
1083
|
name, slug, browserTitle, browserTitleKey, layoutId, roleIds, middlewareIds, events,
|
|
890
1084
|
schema: schema === undefined ? undefined : container.schema
|
|
@@ -893,20 +1087,25 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
|
|
|
893
1087
|
const before = pageUpdateBody(current);
|
|
894
1088
|
// Aynı ad/slug ile tekrar koşan betik o alanları "değişti" diye görmemeli (Gözlem 2).
|
|
895
1089
|
const changed = Object.keys(overrides).filter(key => JSON.stringify(before[key]) !== JSON.stringify(overrides[key]));
|
|
896
|
-
await platform.tenant('PUT', project, `/pages/${applicationId}/${pageId}`, { environment, body });
|
|
1090
|
+
const written = await platform.tenant('PUT', project, `/pages/${applicationId}/${pageId}`, { environment, body });
|
|
1091
|
+
rememberVersion(project, environment, pageId, written?.data?.version);
|
|
897
1092
|
const updateWarnings = schema === undefined
|
|
898
1093
|
? []
|
|
899
|
-
: [...gaps, ...stringStyleWarning(stringStyles), ...inertFlexPropWarning(inertFlexPropNodes(container.schema)), ...flexSizeWarnings(container.schema, 'PAGE-017 (uyarı)', 'PAGE-018 (uyarı)'), ...spacingLayerWarnings(container.schema, 'PAGE-029 (uyarı)', 'PAGE-030 (uyarı)')
|
|
1094
|
+
: [...gaps, ...stringStyleWarning(stringStyles), ...(resolved.profile.layout.modes.has('grid') ? inertFlexPropWarning(inertFlexPropNodes(container.schema)) : []), ...flexSizeWarnings(container.schema, 'PAGE-017 (uyarı)', 'PAGE-018 (uyarı)'), ...spacingLayerWarnings(container.schema, 'PAGE-029 (uyarı)', 'PAGE-030 (uyarı)'), ...profileWarnings,
|
|
1095
|
+
...await pageLayoutWarnings(platform, resolved, project, environment, applicationId, { tree: container.schema, layoutId: layoutId ?? current.layoutId ?? current.layout?.id })];
|
|
900
1096
|
const summary = {
|
|
901
1097
|
id: pageId,
|
|
902
1098
|
outcome: 'updated',
|
|
903
1099
|
changed,
|
|
904
|
-
preserved: { schemaNodes: countSchemaNodes(body.schema), events: body.events.length }
|
|
1100
|
+
preserved: { schemaNodes: countSchemaNodes(body.schema), events: body.events.length },
|
|
1101
|
+
...applicationTypeField(resolved)
|
|
905
1102
|
};
|
|
906
1103
|
if (updateWarnings.length > 0)
|
|
907
1104
|
summary.layoutWarnings = updateWarnings;
|
|
908
|
-
return withNormalization(summary, schema === undefined ? [] : [...container.fixes, ...reset, ...componentDefaultsNote(fixed), ...catalogNotes, ...reorderNote(moved)]);
|
|
1105
|
+
return withNormalization(summary, schema === undefined ? [] : [...container.fixes, ...skeletonNotes, ...reset, ...componentDefaultsNote(fixed), ...catalogNotes, ...reorderNote(moved), ...mobileSpacingNote(spacing)]);
|
|
909
1106
|
}
|
|
1107
|
+
if (templateRoot && layoutId === undefined)
|
|
1108
|
+
skeletonNotes = shellLessPageSkeleton(templateRoot);
|
|
910
1109
|
const response = await platform.tenant('POST', project, `/pages/${applicationId}`, {
|
|
911
1110
|
environment,
|
|
912
1111
|
body: {
|
|
@@ -924,6 +1123,8 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
|
|
|
924
1123
|
const saved = (response && typeof response === 'object' && !Array.isArray(response)
|
|
925
1124
|
? (response.data ?? response)
|
|
926
1125
|
: {});
|
|
1126
|
+
if (typeof saved.id === 'string')
|
|
1127
|
+
rememberVersion(project, environment, saved.id, saved.version);
|
|
927
1128
|
// Kırpmadan ÖNCE doğrulama yolu (B-55): yanıt gövdesi iskelete inince "gönderdiğim prop
|
|
928
1129
|
// kaydedildi mi" sorusunu gövde değil bu diff cevaplar. `layout_create`'in yaptığının sayfa
|
|
929
1130
|
// ikizi; Prop sarmalı açılmazsa doğru kaydedilmiş her prop düşmüş görünür (G-28).
|
|
@@ -933,15 +1134,19 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
|
|
|
933
1134
|
if (view !== 'full' && Array.isArray(saved.schema)) {
|
|
934
1135
|
saved.schema = saved.schema.map(node => summarize(node));
|
|
935
1136
|
}
|
|
936
|
-
const normalized = withWriteDiff(withNormalization(withOutcome(response, undefined), [...container.fixes, ...reset, ...componentDefaultsNote(fixed), ...catalogNotes, ...reorderNote(moved)]), drops);
|
|
937
|
-
const createWarnings = [...gaps, ...stringStyleWarning(stringStyles), ...inertFlexPropWarning(inertFlexPropNodes(container.schema)), ...flexSizeWarnings(container.schema, 'PAGE-017 (uyarı)', 'PAGE-018 (uyarı)'), ...spacingLayerWarnings(container.schema, 'PAGE-029 (uyarı)', 'PAGE-030 (uyarı)')
|
|
938
|
-
|
|
1137
|
+
const normalized = withWriteDiff(withNormalization(withOutcome(response, undefined), [...container.fixes, ...skeletonNotes, ...reset, ...componentDefaultsNote(fixed), ...catalogNotes, ...reorderNote(moved), ...mobileSpacingNote(spacing)]), drops);
|
|
1138
|
+
const createWarnings = [...gaps, ...stringStyleWarning(stringStyles), ...(resolved.profile.layout.modes.has('grid') ? inertFlexPropWarning(inertFlexPropNodes(container.schema)) : []), ...flexSizeWarnings(container.schema, 'PAGE-017 (uyarı)', 'PAGE-018 (uyarı)'), ...spacingLayerWarnings(container.schema, 'PAGE-029 (uyarı)', 'PAGE-030 (uyarı)'), ...profileWarnings,
|
|
1139
|
+
...await pageLayoutWarnings(platform, resolved, project, environment, applicationId, { tree: container.schema, layoutId })];
|
|
1140
|
+
const typeField = applicationTypeField(resolved);
|
|
1141
|
+
if (!normalized || typeof normalized !== 'object')
|
|
939
1142
|
return normalized;
|
|
940
|
-
|
|
1143
|
+
if (createWarnings.length === 0)
|
|
1144
|
+
return Object.keys(typeField).length === 0 ? normalized : { ...normalized, ...typeField };
|
|
1145
|
+
return { ...normalized, ...typeField, layoutWarnings: createWarnings };
|
|
941
1146
|
}));
|
|
942
1147
|
server.registerTool('page_update', {
|
|
943
1148
|
title: 'Sayfa üstbilgisini güncelle',
|
|
944
|
-
description: "Sayfanın adını/slug'ını/layout'unu/rollerini değiştirir. Platformun PUT'u REPLACE'tir; gateway sayfayı önce okur, yalnız verdiğiniz alanları değiştirip tam gövdeyi geri yazar — bu yüzden şema ve olaylar kaybolmaz. ŞEMA değişikliği için bu tool'u değil page_schema_patch'i kullanın (doğrulama duvarı + canlı canvas orada).",
|
|
1149
|
+
description: "Sayfanın adını/slug'ını/layout'unu/rollerini değiştirir. Platformun PUT'u REPLACE'tir; gateway sayfayı önce okur, yalnız verdiğiniz alanları değiştirip tam gövdeyi geri yazar — bu yüzden şema ve olaylar kaybolmaz. ŞEMA değişikliği için bu tool'u değil page_schema_patch'i kullanın (doğrulama duvarı + canlı canvas orada). SÜRÜMSÜZ YAZMAZ (PAGE-039): baseVersion verilmezse bu gateway'in o sayfada en son gördüğü sürüm gider (page_get, page_schema_get, page_schema_patch'in newVersion'ı ya da önceki page_update); hiçbiri yoksa istek gönderilmez — önce okuyun. Sayfa o sürümden beri değiştiyse (Studio'da açık sekme, başka ajan) 409 döner, kim ve ne zaman değiştirdiği söylenir ve hiçbir şey yazılmaz. force:true son sürümü okuyup onun üstüne bilerek yazar (yanıt forced: true).",
|
|
945
1150
|
inputSchema: {
|
|
946
1151
|
project: projectParam,
|
|
947
1152
|
environment: environmentParam,
|
|
@@ -955,29 +1160,69 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
|
|
|
955
1160
|
roleIds: z.array(guid).optional(),
|
|
956
1161
|
middlewareIds: z.array(guid).optional(),
|
|
957
1162
|
events: eventsParam.optional(),
|
|
958
|
-
schema: schemaParam.optional().describe('Nadiren gerekir; verilmezse mevcut şema korunur')
|
|
1163
|
+
schema: schemaParam.optional().describe('Nadiren gerekir; verilmezse mevcut şema korunur. Tam REPLACE: kayıtlı sayfadan daha az düğüm taşıyan şema allowNodeLoss olmadan reddedilir (PAGE-037)'),
|
|
1164
|
+
allowNodeLoss: z.boolean().optional().describe('true: gönderilen schema kayıtlı sayfadan daha az düğüm taşısa da yazılır — eksik düğümler geri dönüşsüz silinir. Varsayılan false: PAGE-037 ile reddedilir (kırpık okumanın geri yazılması)'),
|
|
1165
|
+
baseVersion: z.string().optional().describe("Değişikliği planladığınız sayfa sürümü (page_get / page_schema_get yanıtındaki version). Verilmezse bu gateway'in o sayfada en son gördüğü sürüm gider; sayfa o sürümden beri değiştiyse 409 döner ve hiçbir şey yazılmaz"),
|
|
1166
|
+
force: z.boolean().optional().describe("true: sürüm kontrolünü bilerek geçer — gateway sayfanın son sürümünü okuyup onun üstüne yazar, aradaki değişiklik (Studio sekmesi, başka ajan) ezilir. Yanıt forced: true taşır. Varsayılan false")
|
|
959
1167
|
},
|
|
960
1168
|
annotations: updates
|
|
961
|
-
}, handle(config, async ({ project, environment, applicationId, pageId, ...changes }) => {
|
|
1169
|
+
}, handle(config, async ({ project, environment, applicationId, pageId, allowNodeLoss, baseVersion, force, ...changes }) => {
|
|
1170
|
+
const knownVersion = baseVersion ?? schemaReadMemory.lastVersion(pageKey(project, environment, pageId));
|
|
1171
|
+
if (knownVersion === undefined && force !== true) {
|
|
1172
|
+
throw new PlatformApiError("PAGE-039 — page_update hangi sürümün üstüne yazdığını bilmiyor: baseVersion verilmedi ve bu gateway sayfayı henüz okumadı. Platformun PUT'u REPLACE'tir; sürümsüz tam gövde Studio'da açık bir sekmenin ya da başka bir ajanın değişikliğini sessizce ezer (Bitki Bakım koşusu, 14:02). Önce page_get ya da page_schema_get ile okuyun — yanıttaki version gateway'de hatırlanır — ya da onu baseVersion olarak verin. Son sürümün üstüne bilerek yazmak için force:true. İstek gönderilmedi.", 400);
|
|
1173
|
+
}
|
|
962
1174
|
const overrides = Object.fromEntries(Object.entries(changes).filter(([, value]) => value !== undefined));
|
|
963
|
-
|
|
1175
|
+
const resolved = overrides.schema === undefined ? undefined : await resolveProfile(platform, applicationId);
|
|
1176
|
+
assertScreenWriteGuards('page', { schema: overrides.schema, events: overrides.events }, resolved?.profile.platform);
|
|
964
1177
|
const current = await fetchHost(platform, 'page', project, environment, applicationId, pageId);
|
|
1178
|
+
if (overrides.schema !== undefined && allowNodeLoss !== true) {
|
|
1179
|
+
const storedSchema = current.schema;
|
|
1180
|
+
const sentSchema = overrides.schema;
|
|
1181
|
+
const stored = countSchemaNodes(storedSchema);
|
|
1182
|
+
const sent = countSchemaNodes(sentSchema);
|
|
1183
|
+
if (sent < stored) {
|
|
1184
|
+
const missing = missingElementIds(storedSchema, sentSchema);
|
|
1185
|
+
const listed = missing.slice(0, 10).join(', ');
|
|
1186
|
+
const more = missing.length > 10 ? ` (+${missing.length - 10} daha)` : '';
|
|
1187
|
+
throw new PlatformApiError(`PAGE-037 — gönderilen şema ${sent} düğüm, kayıtlı sayfa ${stored} düğüm; eksilen elementId'ler: ${listed}${more}. Platformun PUT'u REPLACE'tir: eksik düğümler geri dönüşsüz silinir — kırpık (allowTruncated) ya da yarım bir okuma geri yazılıyor olabilir, istek gönderilmedi. Şema değişikliğini page_schema_patch micro-op'larıyla yapın (silmek için remove_component); düğümleri bilerek siliyorsanız allowNodeLoss:true verin.`, 400);
|
|
1188
|
+
}
|
|
1189
|
+
}
|
|
1190
|
+
const blocksMeaningful = resolved?.profile.layout.blocksMeaningful ?? true;
|
|
965
1191
|
const fixed = normalizeComponentDefaults(overrides.schema);
|
|
966
|
-
const reset = overrides.schema === undefined ? [] : resetPageContainerPosition(overrides.schema);
|
|
1192
|
+
const reset = overrides.schema === undefined || !blocksMeaningful ? [] : resetPageContainerPosition(overrides.schema);
|
|
967
1193
|
const catalogNotes = await screenCatalogNotes(platform, project, environment, applicationId, overrides.schema);
|
|
968
|
-
const moved = overrides.schema === undefined ? [] : reorderSchemaBlocks(overrides.schema);
|
|
1194
|
+
const moved = overrides.schema === undefined || !blocksMeaningful ? [] : reorderSchemaBlocks(overrides.schema);
|
|
969
1195
|
const gaps = overrides.schema === undefined
|
|
970
1196
|
? []
|
|
971
|
-
: [
|
|
1197
|
+
: [
|
|
1198
|
+
...(blocksMeaningful ? verticalGapWarnings(overrides.schema, 'PAGE-010 (uyarı)') : []),
|
|
1199
|
+
...(resolved?.profile.layout.modes.has('grid') ?? true ? inertFlexPropWarning(inertFlexPropNodes(overrides.schema)) : []),
|
|
1200
|
+
...flexSizeWarnings(overrides.schema, 'PAGE-017 (uyarı)', 'PAGE-018 (uyarı)'),
|
|
1201
|
+
...spacingLayerWarnings(overrides.schema, 'PAGE-029 (uyarı)', 'PAGE-030 (uyarı)'),
|
|
1202
|
+
...(resolved ? await screenProfileWarnings(platform, resolved, project, environment, applicationId, { kind: 'page', nodes: overrides.schema }) : [])
|
|
1203
|
+
];
|
|
972
1204
|
const body = pageUpdateBody(current, overrides);
|
|
973
|
-
|
|
1205
|
+
// Mizanpaj iskeleti (MOB-015…018) kabukla birlikte karar verilir: sayfa kabuğa bağlanınca ya da kabuktan
|
|
1206
|
+
// çıkınca da denetlenir (kabuksuz iskeletteki üst pay, payı veren kabukta çift olur).
|
|
1207
|
+
const skeletonProfile = resolved ?? (overrides.layoutId !== undefined ? await resolveProfile(platform, applicationId) : undefined);
|
|
1208
|
+
const skeletonWarnings = skeletonProfile
|
|
1209
|
+
? await pageLayoutWarnings(platform, skeletonProfile, project, environment, applicationId, { tree: body.schema, layoutId: body.layoutId })
|
|
1210
|
+
: [];
|
|
1211
|
+
if (force !== true)
|
|
1212
|
+
body.baseVersion = knownVersion;
|
|
1213
|
+
const written = await platform.tenant('PUT', project, `/pages/${applicationId}/${pageId}`, { environment, body }).catch(async (error) => {
|
|
1214
|
+
throw await versionConflict(error, project, environment, applicationId, pageId, String(body.baseVersion ?? ''), "page_schema_get ile yeniden okuyun ve şema değişikliğini page_schema_patch ile uygulayın — yalnız dokunduğunuz yer yazılır, aradaki değişiklik korunur. Üstbilgi (ad, slug, layout, roller) için okuduktan sonra page_update'i yeniden çağırın; aradaki değişikliği bilerek ezmek için force:true.");
|
|
1215
|
+
});
|
|
1216
|
+
rememberVersion(project, environment, pageId, written?.data?.version);
|
|
974
1217
|
const summary = {
|
|
975
1218
|
id: pageId,
|
|
976
1219
|
changed: Object.keys(overrides),
|
|
977
|
-
preserved: { schemaNodes: body.schema
|
|
1220
|
+
preserved: { schemaNodes: countSchemaNodes(body.schema), events: body.events.length }
|
|
978
1221
|
};
|
|
979
|
-
if (
|
|
980
|
-
summary.
|
|
1222
|
+
if (force === true)
|
|
1223
|
+
summary.forced = true;
|
|
1224
|
+
if (gaps.length > 0 || skeletonWarnings.length > 0)
|
|
1225
|
+
summary.layoutWarnings = [...gaps, ...skeletonWarnings];
|
|
981
1226
|
return withNormalization(summary, [...reset, ...componentDefaultsNote(fixed), ...catalogNotes, ...reorderNote(moved)]);
|
|
982
1227
|
}));
|
|
983
1228
|
server.registerTool('page_clone', {
|
|
@@ -986,6 +1231,26 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
|
|
|
986
1231
|
inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, pageId: guid },
|
|
987
1232
|
annotations: writes
|
|
988
1233
|
}, handle(config, ({ project, environment, applicationId, pageId }) => platform.tenant('POST', project, `/pages/${applicationId}/clone/${pageId}`, { environment })));
|
|
1234
|
+
server.registerTool('page_restore', {
|
|
1235
|
+
title: 'Sayfayı bir revizyona döndür',
|
|
1236
|
+
description: "Sayfayı revizyon defterindeki N. sürümüne döndürür: şema (komponentler eski id'leriyle), sayfa olayları, roller, middleware'ler ve layout o sürümdeki gibi yazılır; o sürümün bağladığı ama bugün silinmiş akışlar da kendi son revizyonlarından AYNI id ile geri kurulur (önce adımsız akış, sonra şema, sonra adımlar — tek transaction). Boşalan ya da bayat bir kaydın ezdiği sayfayı (ZM-27) böyle geri alın; tek akış için flow_restore. N'yi revision_list(module: 'page', recordId: <pageId>) ile bulun, içeriğini revision_get/revision_diff ile doğrulayın. N'den SONRA bağlanan akışlar yetim kalır ve silinir — yanıt deletedFlows ile listeler, flow_restore ile geri gelir. baseVersion (page_schema_get version) verilirse sayfa o sürümden beri değiştiyse 409. N'nin bağladığı bir akışın revizyonu kalmamışsa 409 ve hiçbir şey yazılmaz (hata akış id'lerini söyler). DİKKAT: şemayı yüklemeyen komutların (UpdateProjectCommand, UpdateApplicationCommand…) yazdığı sayfa revizyonları komponent TAŞIMAZ; komponenti olan bir sayfayı böyle bir revizyona döndürmek platformca 409 ile reddedilir — correlationId'si sayfa kaydı olan (PatchPageSchemaCommand, UpdatePageCommand) revizyonu seçin. Sayfayı bilerek boşaltmak için allowEmpty: true.",
|
|
1237
|
+
inputSchema: {
|
|
1238
|
+
project: projectParam,
|
|
1239
|
+
environment: environmentParam,
|
|
1240
|
+
applicationId: guid,
|
|
1241
|
+
pageId: guid,
|
|
1242
|
+
revisionNo: z.number().int().min(0).describe("Dönülecek sayfa revizyonunun numarası (revision_list revisionNo)"),
|
|
1243
|
+
baseVersion: z.string().min(1).optional().describe('page_schema_get çıktısındaki version; sayfa o sürümden beri değiştiyse 409 döner ve hiçbir şey yazılmaz'),
|
|
1244
|
+
allowEmpty: z.boolean().optional().describe('true: komponentsiz bir revizyona dönüp sayfayı bilerek boşalt. Varsayılan false — platform komponenti olan sayfayı boş revizyona döndürmeyi 409 ile reddeder')
|
|
1245
|
+
},
|
|
1246
|
+
annotations: destructive
|
|
1247
|
+
}, handle(config, async ({ project, environment, applicationId, pageId, revisionNo, baseVersion, allowEmpty }) => {
|
|
1248
|
+
const restored = unwrap(await platform.tenant('POST', project, `/pages/${applicationId}/${pageId}/restore`, {
|
|
1249
|
+
environment,
|
|
1250
|
+
body: { revisionNo, ...(baseVersion ? { baseVersion } : {}), ...(allowEmpty ? { allowEmpty: true } : {}) }
|
|
1251
|
+
}));
|
|
1252
|
+
return { pageId, ...restored };
|
|
1253
|
+
}));
|
|
989
1254
|
server.registerTool('page_delete', {
|
|
990
1255
|
title: 'Sayfa sil',
|
|
991
1256
|
description: 'Sayfayı siler. Ana sayfa (isHomepage) silinemez; önce başka bir sayfayı ana sayfa yapın. Silmeden önce dependency_graph module:\'page\' ile bağımlılıkları kontrol edin.',
|
|
@@ -1000,3 +1265,37 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
|
|
|
1000
1265
|
return { deleted: pageId, name: page.name };
|
|
1001
1266
|
}));
|
|
1002
1267
|
}
|
|
1268
|
+
/**
|
|
1269
|
+
* Mobil yazımda yeni düğümlerin boşluk varsayılanı (mizanpaj S5/S6); kardeşler kayıtlı ağaçtan okunur.
|
|
1270
|
+
* Ağaç okunamazsa dokunulmaz: eski bir kaba eklenen düğümü yanlışlıkla kaydırmaktansa varsayılan kalsın.
|
|
1271
|
+
*/
|
|
1272
|
+
async function mobileSpacingForOps(platformName, ops, readSaved) {
|
|
1273
|
+
const fix = emptyMobileSpacingFix();
|
|
1274
|
+
if (platformName !== 'mobile' || !ops.some(entry => entry.op === 'add_component' || entry.op === 'batch'))
|
|
1275
|
+
return fix;
|
|
1276
|
+
const saved = await readSaved().then(page => page.schema, () => undefined);
|
|
1277
|
+
if (saved !== undefined)
|
|
1278
|
+
applyMobileSpacingToOps(ops, saved, fix);
|
|
1279
|
+
return fix;
|
|
1280
|
+
}
|
|
1281
|
+
/**
|
|
1282
|
+
* Yazımdan sonraki sayfa ağacının mizanpaj iskeleti (MOB-015…018). `audit` (kuru koşu) ağacın tamamını,
|
|
1283
|
+
* `new` (yama) yalnız yazımın getirdiği bulguları söyler — yoksa bozuk bir sayfaya yapılan her yama aynı
|
|
1284
|
+
* uyarıları tekrarlardı. Kayıtlı sayfa okunamazsa denetim koşmaz.
|
|
1285
|
+
*/
|
|
1286
|
+
async function simulatedPageLayoutWarnings(platform, resolved, project, environment, applicationId, readSaved, ops, mode) {
|
|
1287
|
+
if (resolved.profile.platform !== 'mobile')
|
|
1288
|
+
return [];
|
|
1289
|
+
const page = await readSaved().catch(() => undefined);
|
|
1290
|
+
if (!page)
|
|
1291
|
+
return [];
|
|
1292
|
+
const saved = page.schema ?? [];
|
|
1293
|
+
const simulated = JSON.parse(JSON.stringify(saved));
|
|
1294
|
+
simulateLayoutOps(simulated, ops);
|
|
1295
|
+
applySkeletonOps(simulated, ops);
|
|
1296
|
+
return pageLayoutWarnings(platform, resolved, project, environment, applicationId, {
|
|
1297
|
+
tree: simulated,
|
|
1298
|
+
...(mode === 'new' ? { before: saved } : {}),
|
|
1299
|
+
layoutId: page.layoutId ?? page.layout?.id
|
|
1300
|
+
});
|
|
1301
|
+
}
|