@appaflytech/zeyrek-ai-mcp 0.0.18 → 0.0.20
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/README.md +13 -14
- package/dist/config.js +2 -0
- package/dist/knowledge/componentCatalog.js +204 -836
- package/dist/knowledge/componentEvents.js +75 -368
- package/dist/knowledge/mobileComponentCatalog.js +331 -0
- package/dist/knowledge/mobileComponentEvents.js +50 -0
- package/dist/knowledge/normalize.js +63 -66
- package/dist/knowledge/platform/lint.js +205 -0
- package/dist/knowledge/platform/mobile.js +78 -0
- package/dist/knowledge/platform/mobileRules.js +121 -0
- package/dist/knowledge/platform/mobileTabs.js +108 -0
- package/dist/knowledge/platform/profile.js +20 -0
- package/dist/knowledge/platform/resolve.js +122 -0
- package/dist/knowledge/platform/web.js +38 -0
- package/dist/knowledge/rules.js +6 -29
- package/dist/knowledge/styleResolve.js +1 -1
- package/dist/knowledge/styleResolveNative.js +410 -0
- package/dist/knowledge/themeResolve.js +3 -3
- package/dist/platform/capture/actions.js +333 -0
- package/dist/platform/capture/browser.js +1 -0
- package/dist/platform/{screenshot.js → capture/capture.js} +23 -509
- package/dist/platform/capture/index.js +10 -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/domSummary.js +1 -1
- package/dist/platform/responses.js +1 -2
- package/dist/platform/strictArguments.js +2 -22
- package/dist/platform/writeDiff.js +31 -58
- package/dist/resources/examples/mobile-app-shell-drawer.json +209 -0
- package/dist/resources/examples/mobile-app-shell-stack.json +123 -0
- package/dist/resources/examples/mobile-app-shell-tab.json +174 -0
- package/dist/resources/examples/mobile-list-detail-form.json +656 -0
- package/dist/resources/guides/component.md +6 -9
- package/dist/resources/guides/functions.md +3 -32
- package/dist/resources/guides/getting-started.md +0 -35
- package/dist/resources/guides/layout.md +11 -7
- package/dist/resources/guides/mobile.md +215 -0
- package/dist/resources/guides/page.md +71 -49
- package/dist/resources/guides/translation.md +6 -5
- package/dist/resources/schema-fingerprint.json +2 -2
- package/dist/resources/schemas/GlobalFunctionUpdateResultDto.json +0 -18
- package/dist/server.js +2 -0
- package/dist/tools/applications.js +60 -3
- package/dist/tools/components.js +50 -10
- package/dist/tools/designSchemaPatch.js +18 -13
- package/dist/tools/externalComponents.js +25 -4
- package/dist/tools/flows.js +51 -38
- package/dist/tools/functions.js +10 -20
- package/dist/tools/layouts.js +41 -9
- package/dist/tools/microservices.js +11 -39
- package/dist/tools/mobile.js +203 -0
- package/dist/tools/pages.js +127 -95
- package/dist/tools/platformInfo.js +2 -1
- package/dist/tools/profileWrite.js +45 -0
- package/dist/tools/schemaOps.js +2 -2
- package/dist/tools/screenWrite.js +2 -2
- package/dist/tools/screens.js +9 -3
- package/dist/tools/workflows.js +12 -39
- package/package.json +2 -7
- package/dist/platform/diagnostics.js +0 -85
- package/dist/platform/ifExists.js +0 -129
- package/dist/platform/writeView.js +0 -17
package/dist/tools/workflows.js
CHANGED
|
@@ -7,13 +7,10 @@ import { writeDiff, withWriteDiff } from '../platform/writeDiff.js';
|
|
|
7
7
|
import { policyRules, microfunctionStepFindings, workflowStepFindings, undefinedInputFieldFindings } from '../knowledge/rules.js';
|
|
8
8
|
import { languageHeader } from '../knowledge/languageCodes.js';
|
|
9
9
|
import { handle } from '../platform/responses.js';
|
|
10
|
-
import { existingMatch, ifExistsParam, listAll, platformRename, withOutcome, withRename } from '../platform/ifExists.js';
|
|
11
|
-
import { outlineWrite, recordWriteViewParam } from '../platform/writeView.js';
|
|
12
10
|
import fastJsonPatch from 'fast-json-patch';
|
|
13
11
|
import { z } from 'zod';
|
|
14
12
|
import { constraintSummary } from '../knowledge/backendConstraints.js';
|
|
15
13
|
import { unmappedMembers, introducedUnmappedMembers, withUnmappedMembers } from '../knowledge/schemaGuard.js';
|
|
16
|
-
const workflowIfExistsParam = ifExistsParam('workflow', 'mevcut workflow\'u bu tanımla tam gövde günceller (id\'si korunur; workflow_update ile aynı yazma)');
|
|
17
14
|
const policyOverrideParam = z.boolean().optional()
|
|
18
15
|
.describe('true: politika block bulgularını warn\'a indirir (bilinçli istisna; yanıtta işaretlenir)');
|
|
19
16
|
const patchOperationsParam = z.array(z.record(z.unknown())).min(1)
|
|
@@ -114,51 +111,27 @@ export function registerWorkflowTools(server, platform) {
|
|
|
114
111
|
}));
|
|
115
112
|
server.registerTool('workflow_create', {
|
|
116
113
|
title: 'Workflow oluştur',
|
|
117
|
-
description: "Yeni workflow tanımlar (definition = CreateWorkflowCommand). type: 'workflow' | 'automation' | 'middleware'.
|
|
118
|
-
inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, definition: definitionParam,
|
|
114
|
+
description: "Yeni workflow tanımlar (definition = CreateWorkflowCommand). type: 'workflow' | 'automation' | 'middleware'. İlk kullanımdan önce platform_guide('workflow') okuyun: DTO-önce akışı, branch bağlama (branches[].nextStepId), tip×step matrisi. Her adım ve akışın kendisi 'description' taşımak ZORUNDADIR (WF-024, block): adımın NE İŞE YARADIĞINI 1-2 cümleyle yazın — Studio kanvasında ⓘ ikonu olarak görünür; mekanizmayı değil niyeti yazın. Middleware (istek öncesi koşan guard/setter, user değişkeni, alfabetik sıra) için platform_guide('middleware') + ngapps://examples/middleware-authenticate. Adımın gerçek bir tuzağı varsa (idempotent değil, kapsam adımda değil, dış bağımlılık, sessiz düşen dal) 'caution' alanına yazın — OPSİYONELDİR, tuzak yoksa boş bırakın; doldurma metin yazmayın. Gövde politika kontrolünden geçer. " + constraintSummary('CreateWorkflowCommand'),
|
|
115
|
+
inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, definition: definitionParam, policyOverride: policyOverrideParam },
|
|
119
116
|
annotations: writes
|
|
120
|
-
}, handle(config, async ({ project, environment, applicationId, definition,
|
|
117
|
+
}, handle(config, async ({ project, environment, applicationId, definition, policyOverride }) => {
|
|
121
118
|
const normalized = normalizeWorkflowDefinition(definition);
|
|
122
|
-
|
|
123
|
-
|
|
119
|
+
const findings = enforcePolicy([
|
|
120
|
+
...evaluatePolicy(config, policyRules, 'workflow', definition, { operation: 'create', workflowKind: definition.type }, policyOverride),
|
|
124
121
|
...await microfunctionStepFindings(platform, project, environment, definition, definition.type, policyOverride),
|
|
125
122
|
...await workflowStepFindings(platform, project, environment, applicationId, definition, definition.type, policyOverride),
|
|
126
123
|
...await undefinedInputFieldFindings(platform, project, environment, definition, definition.type, policyOverride)
|
|
127
|
-
];
|
|
128
|
-
const
|
|
129
|
-
const
|
|
130
|
-
|
|
131
|
-
code: 'WF-034',
|
|
132
|
-
noun: 'workflow',
|
|
133
|
-
where: 'bu uygulamada',
|
|
134
|
-
name: typeof definition.name === 'string' ? definition.name : undefined,
|
|
135
|
-
slug: typeof definition.slug === 'string' ? definition.slug : undefined,
|
|
136
|
-
id: typeof definition.id === 'string' ? definition.id : undefined,
|
|
137
|
-
idParam: 'definition.id',
|
|
138
|
-
ifExists,
|
|
139
|
-
list: () => listAll(platform, project, environment, `/workflows/${applicationId}`),
|
|
140
|
-
listTool: 'workflow_list',
|
|
141
|
-
copyCheck: 'kullanılıp kullanılmadığını workflow_dependencies ile kontrol edip gerekirse silin',
|
|
142
|
-
updateTool: 'id ile workflow_update',
|
|
143
|
-
kind: { key: 'type', value: definition.type }
|
|
144
|
-
});
|
|
145
|
-
// Kayıt bulunduysa yazma bir UPDATE'tir: gövde kuralları workflow_update ile aynı kipte yeniden
|
|
146
|
-
// değerlendirilir (R-1). Adım denetimleri operasyondan bağımsızdır, tekrar koşmaz.
|
|
147
|
-
const findings = existing === undefined ? createFindings : enforcePolicy([...bodyFindings('update'), ...stepFindings]);
|
|
148
|
-
const drift = unmappedMembers(existing === undefined ? 'CreateWorkflowCommand' : 'UpdateWorkflowCommand', definition);
|
|
149
|
-
const payload = existing === undefined
|
|
150
|
-
? await platform.tenant('POST', project, `/workflows/${applicationId}`, { environment, body: definition })
|
|
151
|
-
: await platform.tenant('PUT', project, `/workflows/${applicationId}/${String(existing.id)}`, { environment, body: definition });
|
|
152
|
-
const saved = payload?.data;
|
|
153
|
-
const rename = ifExists === 'duplicate' ? platformRename(definition, saved, 'dash') : { sent: definition };
|
|
154
|
-
return attachFindings(withUnmappedMembers(withWriteDiff(withRename(withNormalization(withOutcome(outlineWrite(payload, view, ['type']), existing), normalized), rename.renamed), writeDiff(rename.sent, payload)), drift), findings);
|
|
124
|
+
]);
|
|
125
|
+
const drift = unmappedMembers('CreateWorkflowCommand', definition);
|
|
126
|
+
const payload = await platform.tenant('POST', project, `/workflows/${applicationId}`, { environment, body: definition });
|
|
127
|
+
return attachFindings(withUnmappedMembers(withWriteDiff(withNormalization(payload, normalized), writeDiff(definition, payload)), drift), findings);
|
|
155
128
|
}));
|
|
156
129
|
server.registerTool('workflow_update', {
|
|
157
130
|
title: 'Workflow güncelle',
|
|
158
131
|
description: 'Workflow tanımını günceller (definition = UpdateWorkflowCommand, tam gövde). Hedefli değişiklik için workflow_patch tercih edin. Her adım ve akışın kendisi \'description\' taşımak ZORUNDADIR (WF-024, block). Adımın gerçek bir tuzağı varsa (idempotent değil, kapsam adımda değil, dış bağımlılık, sessiz düşen dal) \'caution\' alanına yazın — OPSİYONELDİR, tuzak yoksa boş bırakın; doldurma metin yazmayın. Gövde politika kontrolünden geçer. ' + constraintSummary('UpdateWorkflowCommand'),
|
|
159
|
-
inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, id: guid, definition: definitionParam,
|
|
132
|
+
inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, id: guid, definition: definitionParam, policyOverride: policyOverrideParam },
|
|
160
133
|
annotations: updates
|
|
161
|
-
}, handle(config, async ({ project, environment, applicationId, id, definition,
|
|
134
|
+
}, handle(config, async ({ project, environment, applicationId, id, definition, policyOverride }) => {
|
|
162
135
|
const normalized = normalizeWorkflowDefinition(definition);
|
|
163
136
|
const findings = enforcePolicy([
|
|
164
137
|
...evaluatePolicy(config, policyRules, 'workflow', definition, { operation: 'update', workflowKind: definition.type }, policyOverride),
|
|
@@ -168,7 +141,7 @@ export function registerWorkflowTools(server, platform) {
|
|
|
168
141
|
]);
|
|
169
142
|
const drift = unmappedMembers('UpdateWorkflowCommand', definition);
|
|
170
143
|
const payload = await platform.tenant('PUT', project, `/workflows/${applicationId}/${id}`, { environment, body: definition });
|
|
171
|
-
return attachFindings(withUnmappedMembers(withWriteDiff(withNormalization(
|
|
144
|
+
return attachFindings(withUnmappedMembers(withWriteDiff(withNormalization(payload, normalized), writeDiff(definition, payload)), drift), findings);
|
|
172
145
|
}));
|
|
173
146
|
server.registerTool('workflow_patch', {
|
|
174
147
|
title: 'Workflow\'a patch uygula',
|
package/package.json
CHANGED
|
@@ -1,14 +1,9 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@appaflytech/zeyrek-ai-mcp",
|
|
3
|
-
"version": "0.0.
|
|
3
|
+
"version": "0.0.20",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"description": "Zeyrek (NgApps) platform APIs as MCP tools — data, logic and Studio design surface in one gateway",
|
|
6
6
|
"license": "UNLICENSED",
|
|
7
|
-
"repository": {
|
|
8
|
-
"type": "git",
|
|
9
|
-
"url": "git+https://github.com/zeyrek-v2/zeyrek-app.git",
|
|
10
|
-
"directory": "zeyrek-mcp"
|
|
11
|
-
},
|
|
12
7
|
"engines": {
|
|
13
8
|
"node": ">=20"
|
|
14
9
|
},
|
|
@@ -60,4 +55,4 @@
|
|
|
60
55
|
"typescript": "^5.7.2",
|
|
61
56
|
"vitest": "^3.0.0"
|
|
62
57
|
}
|
|
63
|
-
}
|
|
58
|
+
}
|
|
@@ -1,85 +0,0 @@
|
|
|
1
|
-
import { AsyncLocalStorage } from 'node:async_hooks';
|
|
2
|
-
import { z } from 'zod';
|
|
3
|
-
const activeMode = new AsyncLocalStorage();
|
|
4
|
-
const MAX_NOTES = 8;
|
|
5
|
-
const MAX_NOTE_CHARS = 240;
|
|
6
|
-
const MAX_DROPS = 5;
|
|
7
|
-
export const diagnosticsParam = z.enum(['compact', 'full']).optional().describe("Yanıttaki gatewayNormalized / silentlyDropped listelerinin boyu. compact (varsayılan): aynı not tekilleşir, uzun not kısalır (en fazla 8); aynı yolun düşmeleri tek satırda sayıyla toplanır (en fazla 5 grup); droppedCount her zaman tam sayıdır. full: listelerin tamamı.");
|
|
8
|
-
export function runWithDiagnostics(mode, run) {
|
|
9
|
-
return activeMode.run(mode, run);
|
|
10
|
-
}
|
|
11
|
-
/**
|
|
12
|
-
* Tanılama listeleri her yazma çağrısında yanıta girer ve aynı gerekçe cümlesi çağrı başına tekrar
|
|
13
|
-
* eder. Kırpma yalnız GÖRÜNÜMÜ küçültür: `silentlyDropped` "kaydedildi mi" sorusunun tek kanıtı olduğu
|
|
14
|
-
* için liste hiçbir zaman sessizce boşalmaz — toplam sayı ve kalan satır sayısı yanıtta kalır, tam
|
|
15
|
-
* liste gateway günlüğünde (`sessiz düşme` / `düzeltme` adımları) durur.
|
|
16
|
-
*
|
|
17
|
-
* Kip bağlamı olmayan çağrı (okuma ve silme tool'ları, doğrudan `toolResult` kullanan testler) tam
|
|
18
|
-
* listeyi görür; kısaltma yalnız `diagnostics` parametresini taşıyan yazma tool'larında devreye girer.
|
|
19
|
-
*/
|
|
20
|
-
export function compactDiagnostics(payload) {
|
|
21
|
-
if (activeMode.getStore() !== 'compact')
|
|
22
|
-
return payload;
|
|
23
|
-
if (!payload || typeof payload !== 'object' || Array.isArray(payload))
|
|
24
|
-
return payload;
|
|
25
|
-
const record = payload;
|
|
26
|
-
const notes = Array.isArray(record.gatewayNormalized) ? record.gatewayNormalized.map(String) : undefined;
|
|
27
|
-
const drops = Array.isArray(record.silentlyDropped) ? record.silentlyDropped.map(String) : undefined;
|
|
28
|
-
if (notes === undefined && drops === undefined)
|
|
29
|
-
return payload;
|
|
30
|
-
const hidden = [];
|
|
31
|
-
const result = { ...record };
|
|
32
|
-
if (notes !== undefined) {
|
|
33
|
-
const counts = new Map();
|
|
34
|
-
for (const note of notes)
|
|
35
|
-
counts.set(note, (counts.get(note) ?? 0) + 1);
|
|
36
|
-
const unique = [...counts.entries()].map(([note, count]) => {
|
|
37
|
-
const shortened = note.length > MAX_NOTE_CHARS ? `${note.slice(0, MAX_NOTE_CHARS - 1)}…` : note;
|
|
38
|
-
return count > 1 ? `${shortened} (×${count})` : shortened;
|
|
39
|
-
});
|
|
40
|
-
const shortenedCount = notes.filter(note => note.length > MAX_NOTE_CHARS).length;
|
|
41
|
-
const kept = unique.slice(0, MAX_NOTES);
|
|
42
|
-
result.gatewayNormalized = unique.length > MAX_NOTES ? [...kept, `… ${unique.length - MAX_NOTES} not daha`] : kept;
|
|
43
|
-
if (unique.length > MAX_NOTES)
|
|
44
|
-
hidden.push(`${unique.length - MAX_NOTES} not`);
|
|
45
|
-
if (shortenedCount > 0)
|
|
46
|
-
hidden.push(`${shortenedCount} notun gerekçesi kısaltıldı`);
|
|
47
|
-
}
|
|
48
|
-
if (drops !== undefined) {
|
|
49
|
-
const droppedCount = typeof record.droppedCount === 'number' ? record.droppedCount : drops.length;
|
|
50
|
-
const grouped = groupDrops(drops, record.droppedCountCapped === true || droppedCount > drops.length);
|
|
51
|
-
const kept = grouped.slice(0, MAX_DROPS);
|
|
52
|
-
if (grouped.length !== drops.length)
|
|
53
|
-
hidden.push('benzer düşme satırları toplandı');
|
|
54
|
-
if (grouped.length > MAX_DROPS)
|
|
55
|
-
hidden.push(`${grouped.length - MAX_DROPS} düşme grubu`);
|
|
56
|
-
result.silentlyDropped = grouped.length > MAX_DROPS ? [...kept, `… ${grouped.length - MAX_DROPS} grup daha`] : kept;
|
|
57
|
-
result.droppedCount = droppedCount;
|
|
58
|
-
}
|
|
59
|
-
if (hidden.length === 0)
|
|
60
|
-
return result;
|
|
61
|
-
return { ...result, diagnosticsNote: "Kısaltıldı; yazmayı tekrarlamayın. Tam liste: sonraki çağrıda diagnostics:'full'." };
|
|
62
|
-
}
|
|
63
|
-
/**
|
|
64
|
-
* Aynı yolun farklı öğelerindeki düşmeler (`selectFields[fieldId=a].path`, `selectFields[fieldId=b].path`, …)
|
|
65
|
-
* aynı sorunu tekrar eder. Seçici ve indeks `[*]`'a indirgenir, grup tek satırda sayıyla ve bir örnekle
|
|
66
|
-
* döner. Listedeki HER satır kayıptır (sıra uyarısı ve kesme bilgisi `silentlyDroppedNotes`'tadır ve
|
|
67
|
-
* buraya hiç girmez); micro-op satırları (`add_component 'x': …`) da kendi yolu altında gruplanır.
|
|
68
|
-
* Liste kesildiyse ya da sayım tavana vurduysa grup sayısı "en az" diye yazılır.
|
|
69
|
-
*/
|
|
70
|
-
function groupDrops(drops, partial) {
|
|
71
|
-
const groups = new Map();
|
|
72
|
-
for (const line of drops) {
|
|
73
|
-
const separator = line.indexOf(': ');
|
|
74
|
-
const path = separator === -1 ? line : line.slice(0, separator);
|
|
75
|
-
const outcome = line.includes(' ↔ ') ? (line.endsWith('kaydedilen yok') ? ' · kaydedilmedi' : ' · farklı kaydedildi') : '';
|
|
76
|
-
const pattern = `${path.replace(/\[[^\]]*\]/g, '[*]')}${outcome}`;
|
|
77
|
-
groups.set(pattern, [...(groups.get(pattern) ?? []), line]);
|
|
78
|
-
}
|
|
79
|
-
return [...groups.entries()].map(([pattern, lines]) => {
|
|
80
|
-
if (lines.length === 1)
|
|
81
|
-
return lines[0];
|
|
82
|
-
const example = lines[0].length > 160 ? `${lines[0].slice(0, 159)}…` : lines[0];
|
|
83
|
-
return `${pattern}: ${partial ? 'en az ' : ''}${lines.length} öğe — ör. ${example}`;
|
|
84
|
-
});
|
|
85
|
-
}
|
|
@@ -1,129 +0,0 @@
|
|
|
1
|
-
import { z } from 'zod';
|
|
2
|
-
import { PlatformApiError } from './errors.js';
|
|
3
|
-
/**
|
|
4
|
-
* `ifExists` parametresi. Aynı ad ya da slug'la ikinci kaydın `"<ad> (1)"` olarak açılması platformun
|
|
5
|
-
* ürün kararıdır (akış, sayfa, workflow ve microservice servisleri aynı sayaç kuralını uygular) ve
|
|
6
|
-
* değişmez. MCP ajanı çağrıyı tekrar edebildiği için varsayılan "yazma, mevcut id'yi söyle"dir.
|
|
7
|
-
*/
|
|
8
|
-
export function ifExistsParam(noun, updateNote) {
|
|
9
|
-
return z.enum(['error', 'update', 'duplicate']).default('error').describe(`Aynı ad ya da slug'da (büyük/küçük harf duyarsız) ${noun} varsa ne olacağı. 'error' (varsayılan): yazmaz, mevcut kaydın id'sini döner. 'update': ${updateNote}. 'duplicate': platformun ürün davranışı — ikinci kayıt açılır, platform ada/slug'a ' (1)' sayacını ekler (Studio'daki 'New … (1)' ile aynı kural).`);
|
|
10
|
-
}
|
|
11
|
-
const upper = (value) => String(value ?? '').toUpperCase();
|
|
12
|
-
const isPresent = (value) => value !== undefined && value !== null && String(value) !== '';
|
|
13
|
-
/**
|
|
14
|
-
* Var-mı kapısı (FLOW-026 ve kardeşleri). Aday araması platformda harfe duyarlıdır; gateway bilinçli
|
|
15
|
-
* olarak harf duyarsız karşılaştırır. Var-mı okuması başarısız olursa çağrı düşer — okuyamadığı
|
|
16
|
-
* listeyi boş sayan kontrol tam da zaman aşımında kopya üretirdi.
|
|
17
|
-
*/
|
|
18
|
-
export async function existingMatch(options) {
|
|
19
|
-
const { code, noun, where, name, slug, id, idParam, ifExists } = options;
|
|
20
|
-
const slugCounter = (options.slugSuffix ?? 'dash') === 'dash' ? "'-1'" : "' (1)'";
|
|
21
|
-
if (ifExists === 'duplicate')
|
|
22
|
-
return undefined;
|
|
23
|
-
if (!name && !slug)
|
|
24
|
-
return undefined;
|
|
25
|
-
let records;
|
|
26
|
-
try {
|
|
27
|
-
records = await options.list();
|
|
28
|
-
}
|
|
29
|
-
catch (error) {
|
|
30
|
-
throw new PlatformApiError(`${code}: mevcut ${noun} kayıtları okunamadı, ${noun} YAZILMADI (${error instanceof Error ? error.message : String(error)}). Liste okunmadan yazmak aynı adla ikinci kayıt açabilir; ${options.listTool} ile tekrar deneyin ya da bilerek ikinci kayıt istiyorsanız ifExists:'duplicate' verin.`);
|
|
31
|
-
}
|
|
32
|
-
const matches = records.filter(record => (name !== undefined && name !== '' && upper(record.name) === upper(name)) ||
|
|
33
|
-
(slug !== undefined && slug !== '' && upper(record.slug) === upper(slug)));
|
|
34
|
-
const [match] = matches;
|
|
35
|
-
if (match === undefined)
|
|
36
|
-
return undefined;
|
|
37
|
-
const describe = (record) => `${String(record.id)} ('${String(record.name)}', slug '${String(record.slug)}')`;
|
|
38
|
-
const copyPattern = name
|
|
39
|
-
? new RegExp(`^${name.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')} \\(\\d+\\)$`, 'i')
|
|
40
|
-
: undefined;
|
|
41
|
-
const copies = copyPattern ? records.filter(record => copyPattern.test(String(record.name ?? ''))) : [];
|
|
42
|
-
const copyNote = copies.length > 0
|
|
43
|
-
? ` ${where[0].toUpperCase()}${where.slice(1)} bu adın sayaçlı eşleri de var: ${copies.map(describe).join(' · ')} — ${options.copyCheck}.`
|
|
44
|
-
: '';
|
|
45
|
-
if (ifExists === 'error') {
|
|
46
|
-
throw new PlatformApiError(`${code}: ${where} aynı ad ya da slug'da ${noun} zaten var: ${matches.map(describe).join(' · ')}. İstek gönderilmedi — gönderilseydi platform ürün kuralı gereği ikinci bir ${noun} açardı (çakışan ada ' (1)', slug'a ${slugCounter} sayacı eklenerek; yalnız harf farkı varsa sayaçsız). Mevcut kaydı güncellemek için aynı çağrıyı ifExists:'update' ile tekrarlayın; bilerek ikinci kayıt istiyorsanız ifExists:'duplicate'.${copyNote}`, 409);
|
|
47
|
-
}
|
|
48
|
-
if (matches.length > 1) {
|
|
49
|
-
throw new PlatformApiError(`${code}: ad ve slug farklı kayıtlara çıkıyor (${matches.map(describe).join(' · ')}); hangisinin güncelleneceği belirsiz, istek gönderilmedi. ${options.updateTool} kullanın.${copyNote}`, 409);
|
|
50
|
-
}
|
|
51
|
-
// Eşleşme tipten bağımsızdır (platform sayacı tipe bakmaz), ama 'update' tipi farklı kaydın üstüne
|
|
52
|
-
// yazarsa kaydın türü değişir: backend PUT'ta tipi de yazar ve middleware automation'a dönüşür (R-1).
|
|
53
|
-
const kind = options.kind;
|
|
54
|
-
if (kind !== undefined && isPresent(kind.value) && isPresent(match[kind.key]) && upper(match[kind.key]) !== upper(kind.value)) {
|
|
55
|
-
throw new PlatformApiError(`${code}: aynı ad ya da slug'daki mevcut kayıt ${describe(match)} ${kind.key}='${String(match[kind.key])}'; gönderilen gövde ${kind.key}='${String(kind.value)}'. ifExists:'update' kaydın türünü değiştirirdi — istek gönderilmedi. Farklı ad/slug seçin ya da bilerek ikinci kayıt istiyorsanız ifExists:'duplicate'.${copyNote}`, 409);
|
|
56
|
-
}
|
|
57
|
-
if (id !== undefined && id.toLowerCase() !== String(match.id).toLowerCase()) {
|
|
58
|
-
throw new PlatformApiError(`${code}: verilen ${idParam} (${id}) aynı adlı mevcut kayıtla (${describe(match)}) çelişiyor; istek gönderilmedi. Mevcut kaydı güncellemek için ${idParam}'yi vermeyin ya da ${String(match.id)} verin.`, 409);
|
|
59
|
-
}
|
|
60
|
-
return match;
|
|
61
|
-
}
|
|
62
|
-
const LIST_PAGE_LENGTH = 200;
|
|
63
|
-
const LIST_PAGE_LIMIT = 50;
|
|
64
|
-
/**
|
|
65
|
-
* Uygulama düzeyindeki liste uçlarını (`GET /microservices|workflows|pages/{app}`) sonuna kadar okur.
|
|
66
|
-
* Arama terimi kullanılmaz: platformun `searchTerm`'ü slug'ı kapsamayabilir ve eksik liste kopya açar.
|
|
67
|
-
*
|
|
68
|
-
* Platform sayfaları kararlı sırada vermiyor (R-3): bir kayıt iki sayfada gelip başka biri hiç
|
|
69
|
-
* gelmeyebilir. İlk yanıttaki `meta.totalData` okunan TEKİL id sayısıyla tutmazsa liste tutarsızdır ve
|
|
70
|
-
* hata atılır — çağıran yazmaz. `meta` taşımayan eski yanıtta denetim yapılamaz.
|
|
71
|
-
*/
|
|
72
|
-
export async function listAll(platform, project, environment, path) {
|
|
73
|
-
const records = [];
|
|
74
|
-
let expected;
|
|
75
|
-
for (let pageIndex = 0; pageIndex < LIST_PAGE_LIMIT; pageIndex++) {
|
|
76
|
-
const payload = await platform.tenant('GET', project, path, { environment, query: { pageIndex, pageLength: LIST_PAGE_LENGTH } });
|
|
77
|
-
if (!Array.isArray(payload?.data))
|
|
78
|
-
throw new PlatformApiError('liste yanıtında data dizisi yok');
|
|
79
|
-
if (pageIndex === 0 && typeof payload.meta?.totalData === 'number')
|
|
80
|
-
expected = payload.meta.totalData;
|
|
81
|
-
records.push(...payload.data);
|
|
82
|
-
if (payload.data.length < LIST_PAGE_LENGTH || (expected !== undefined && records.length >= expected)) {
|
|
83
|
-
const unique = new Set(records.map(record => String(record.id).toLowerCase())).size;
|
|
84
|
-
if (expected !== undefined && unique !== expected) {
|
|
85
|
-
throw new PlatformApiError(`liste tutarsız okundu: platform ${expected} kayıt dedi, sayfalardan ${unique} tekil kayıt geldi (${records.length - unique} tekrar) — sayfa sırası kararlı değil`);
|
|
86
|
-
}
|
|
87
|
-
return records;
|
|
88
|
-
}
|
|
89
|
-
}
|
|
90
|
-
throw new PlatformApiError(`liste ${LIST_PAGE_LENGTH * LIST_PAGE_LIMIT} kaydı aştı, tamamı okunamadı`);
|
|
91
|
-
}
|
|
92
|
-
/**
|
|
93
|
-
* `ifExists:'duplicate'` yazmasında platform ada ' (n)', slug'a '-n' (akışta ' (n)') ekler. Bu fark kayıp
|
|
94
|
-
* değildir (Gözlem 1): kalıba uyan alan karşılaştırmadan ÖNCE gönderilen gövdede kaydedilen değerle
|
|
95
|
-
* değiştirilir ve `renamedByPlatform`'a gider. Kalıba uymayan fark gövdede kalır, yani yine kayıptır.
|
|
96
|
-
*/
|
|
97
|
-
export function platformRename(sent, saved, slugSuffix) {
|
|
98
|
-
const record = saved && typeof saved === 'object' && !Array.isArray(saved) ? saved : {};
|
|
99
|
-
const escape = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
|
|
100
|
-
const renamed = {};
|
|
101
|
-
const adjusted = { ...sent };
|
|
102
|
-
for (const key of ['name', 'slug']) {
|
|
103
|
-
const given = sent[key];
|
|
104
|
-
const stored = record[key];
|
|
105
|
-
if (typeof given !== 'string' || typeof stored !== 'string' || given === stored)
|
|
106
|
-
continue;
|
|
107
|
-
const pattern = key === 'slug' && slugSuffix === 'dash'
|
|
108
|
-
? new RegExp(`^${escape(given)}-\\d+$`)
|
|
109
|
-
: new RegExp(`^${escape(given)} \\(\\d+\\)$`);
|
|
110
|
-
if (!pattern.test(stored))
|
|
111
|
-
continue;
|
|
112
|
-
renamed[key] = stored;
|
|
113
|
-
adjusted[key] = stored;
|
|
114
|
-
}
|
|
115
|
-
return Object.keys(renamed).length === 0 ? { sent: adjusted } : { sent: adjusted, renamed };
|
|
116
|
-
}
|
|
117
|
-
export function withRename(payload, renamed) {
|
|
118
|
-
if (renamed === undefined || !payload || typeof payload !== 'object' || Array.isArray(payload))
|
|
119
|
-
return payload;
|
|
120
|
-
return { ...payload, renamedByPlatform: renamed };
|
|
121
|
-
}
|
|
122
|
-
/**
|
|
123
|
-
* Yazma yanıtına `outcome` ekler; ajan kaydın yeni mi açıldığını yoksa güncellendiğini mi tek alandan okur.
|
|
124
|
-
*/
|
|
125
|
-
export function withOutcome(payload, existing) {
|
|
126
|
-
if (!payload || typeof payload !== 'object' || Array.isArray(payload))
|
|
127
|
-
return payload;
|
|
128
|
-
return { ...payload, outcome: existing === undefined ? 'created' : 'updated' };
|
|
129
|
-
}
|
|
@@ -1,17 +0,0 @@
|
|
|
1
|
-
import { z } from 'zod';
|
|
2
|
-
export const recordWriteViewParam = z.enum(['outline', 'full']).optional().describe("Yanıttaki kaydın biçimi. outline (VARSAYILAN): data yalnız kimlik alanlarını taşır (id, name, slug, version ve türüne göre url/httpMethod/source/type) — gönderdiğiniz gövdenin yankısı bağlama tekrar girmez; 'kaydedildi mi' kanıtı silentlyDropped/droppedCount'tadır. full: platformun döndürdüğü gövde aynen gelir.");
|
|
3
|
-
/**
|
|
4
|
-
* Create/update yanıtı platformun kaydettiği tanımın TAMAMINI döner; ajan aynı turda o gövdeyi
|
|
5
|
-
* kendisi göndermiştir. Kırpma yalnız bağımsız doğrulama yolu olan yerde yapılır: bu tool'larda
|
|
6
|
-
* `writeDiff` tam yanıt üzerinden ÖNCE hesaplanır, projeksiyon ondan sonra uygulanır.
|
|
7
|
-
*/
|
|
8
|
-
export function outlineWrite(payload, view, keys) {
|
|
9
|
-
if (view === 'full' || !payload || typeof payload !== 'object' || Array.isArray(payload))
|
|
10
|
-
return payload;
|
|
11
|
-
const record = payload;
|
|
12
|
-
const data = record.data;
|
|
13
|
-
if (!data || typeof data !== 'object' || Array.isArray(data))
|
|
14
|
-
return payload;
|
|
15
|
-
const source = data;
|
|
16
|
-
return { ...record, data: Object.fromEntries(['id', 'name', 'slug', 'version', ...keys].filter(key => Object.hasOwn(source, key)).map(key => [key, source[key]])) };
|
|
17
|
-
}
|