@appaflytech/zeyrek-ai-mcp 0.0.7 → 0.0.9

package/dist/tools/themes.js

@@ -0,0 +1,163 @@
+import { guid, projectParam, readOnly, updates } from './common.js';
+import { diffCssVars, mergeRadiusScale, mergeSpacingScale, mergeTypeScale, resolveTheme } from '../knowledge/themeResolve.js';
+import { diffThemePaths, mergeTheme, normalizeTheme, readProjectTheme, summarizeTheme, themeInput, unsetThemePaths } from '../knowledge/themeSchema.js';
+import { componentPresetTypeWarnings, themeInputWarnings, unsetWarnings } from '../knowledge/themeRules.js';
+import { attachFindings, enforcePolicy, evaluatePolicy, applyPolicyMode } from '../knowledge/policy.js';
+import { projectUpdateForm } from './projects.js';
+import { withNormalization } from '../knowledge/normalize.js';
+import { PlatformApiError } from '../platform/errors.js';
+import { policyRules } from '../knowledge/rules.js';
+import { handle } from '../platform/responses.js';
+import { z } from 'zod';
+const modeParam = z.enum(['light', 'dark']);
+/**
+ * Tema PROJE kaydıdır (`projects.theme` jsonb), ortam başına değil: okuma da yazma da
+ * Organization.API'ye gider ve `environment` parametresi YOKTUR. Kayıt her aktif ortamın tenant
+ * kopyasına platform tarafından yayılır (`UpdateProjectWhenOrganizationProjectUpdatedEventHandler`).
+ */
+async function loadProject(platform, project) {
+    const slug = platform.resolveProject(project);
+    const payload = await platform.org('GET', `/p/${slug}`);
+    const data = (payload?.data ?? {});
+    return {
+        payload,
+        project: { id: data.id, slug: data.slug, name: data.name },
+        theme: readProjectTheme(payload)
+    };
+}
+const EMPTY_THEME_NOTE = 'Proje TEMASIZ — runtime platformun kendi varsayılanını çizer (accent #0052CC, Inter 14px, '
+    + 'radius 4px, spacing 10px). Marka için theme_update; yalnız TEK bir sayfada sapma istiyorsanız '
+    + "page_container.style içinde --ng-* değişkenlerini ezin (platform_guide('page') Kural 1h).";
+export function registerThemeTools(server, platform) {
+    const config = platform.config;
+    server.registerTool('theme_get', {
+        title: 'Proje temasını getir',
+        description: "Projenin tema kaydını döner: hangi alanlara dokunulmuş (summary), kaydın kendisi (raw) ya da EKRANA İNEN hâli (resolved — tam palet + birleşik ölçekler + runtime'ın bastığı bütün --ng-* değişkenleri). 'Accent'i ezmedim, ekranda hangi mavi çiziliyor' sorusunun cevabı resolved kipidir. Tema PROJE kaydıdır: ortam parametresi yoktur, bütün ortamların runtime'ı aynı temayı çizer.",
+        inputSchema: {
+            project: projectParam,
+            view: z.enum(['summary', 'raw', 'resolved']).optional().describe("summary (varsayılan): dokunulmuş alanların dökümü + preset/bileşen preset listesi. raw: tema kaydı olduğu gibi. resolved: palet, token'lar, gölge kademeleri ve cssVars (--ng-* → değer)"),
+            mode: modeParam.optional().describe("Yalnız resolved: hangi mod çözülsün. Verilmezse kaydın kendi mode'u (yoksa light). Palet override'ları mod başına tutulur (palette / paletteDark), bu yüzden iki mod ayrı ayrı çözülür")
+        },
+        annotations: readOnly
+    }, handle(config, async ({ project, view, mode }) => {
+        const { project: projectInfo, theme } = await loadProject(platform, project);
+        const storedMode = theme?.mode === 'dark' ? 'dark' : 'light';
+        const head = { project: projectInfo, hasTheme: theme !== undefined, storedMode };
+        if (view === 'raw') {
+            return {
+                ...head,
+                theme: theme ?? {},
+                note: theme === undefined
+                    ? EMPTY_THEME_NOTE
+                    : "Kayıt olduğu gibi. Ekrana inen değerler için view:'resolved'; kısmi yazma için theme_update."
+            };
+        }
+        if (view === 'resolved') {
+            const resolved = resolveTheme(theme, mode);
+            return {
+                ...head,
+                mode: resolved.mode,
+                palette: resolved.palette,
+                // Alan adı 'tokens' OLAMAZ: `maskSecrets` anahtarında 'token' geçen her değeri '***' ile
+                // değiştiriyor (`secretKeyPattern`, platform/secrets.ts) ve yanıt sessizce boşalıyordu —
+                // ölçüldü 2026-09-15, tema token'ları tasarım değeri, gizli bilgi değil.
+                values: {
+                    fontFamily: resolved.tokens.fontFamily,
+                    fontHeading: resolved.tokens.headingFontFamily ?? resolved.tokens.fontFamily,
+                    fontSize: resolved.tokens.fontSize,
+                    fontWeight: resolved.tokens.fontWeight,
+                    spacing: resolved.tokens.spacing,
+                    borderRadius: resolved.tokens.borderRadius,
+                    defaultInputSize: resolved.tokens.defaultInputSize,
+                    typeScale: mergeTypeScale(resolved.tokens.typeScale),
+                    radiusScale: mergeRadiusScale(resolved.tokens.radiusScale),
+                    spacingScale: mergeSpacingScale(resolved.tokens.spacingScale),
+                    shadow: resolved.tokens.shadow
+                },
+                shadow: resolved.shadow,
+                cssVars: resolved.cssVars,
+                presets: Object.keys(theme?.presets ?? {}),
+                componentPresets: Object.keys(theme?.componentPresets ?? {}),
+                note: "cssVars, Theme.svelte'nin her sayfaya bastığı değişkenlerdir; bir sayfanın page_container.style'ı aynı adı yeniden tanımlarsa O SAYFADA o kazanır. Koyu mod için mode:'dark' — ziyaretçinin kendi tercihi (theme-toggle, localStorage) runtime'da projenin modunun önüne geçer."
+            };
+        }
+        if (theme === undefined)
+            return { ...head, note: EMPTY_THEME_NOTE };
+        const summary = summarizeTheme(theme);
+        return {
+            ...head,
+            ...summary,
+            note: "Değerlerin ekrana indiği hâl için view:'resolved'; yazmak için theme_update (kısmi günceller, lint'ten geçirir, hangi CSS değişkeninin değiştiğini söyler). Adlı bir preset'i düğüme bağlamak: style.$preset — platform_guide('theme')."
+        };
+    }));
+    server.registerTool('theme_update', {
+        title: 'Proje temasını güncelle',
+        description: "Temayı KISMİ günceller: kaydı okur, verdiğiniz alanları derin birleştirir, normalize eder, lint'ten geçirir ve yazar — bir rengi değiştirmek preset'leri ve bileşen preset'lerini düşürmez. Yanıt hangi yolların değiştiğini (changed) ve hangi CSS değişkeninin hangi değerden hangi değere gittiğini (cssVarsChanged) söyler; dryRun ile yazmadan aynı yanıtı alırsınız. DİKKAT: tema PROJE kaydıdır — değişiklik BÜTÜN ortamların runtime'ına iner (production dâhil) ve Studio tema paneli açık ve kaydedilmemişse panelin sonraki Save'i bu yazmayı ezer.",
+        inputSchema: {
+            project: projectParam,
+            theme: themeInput.optional().describe("Yazılacak alanlar — KISMİ. Nesneler derin birleşir, dizi/ilkel değer yerine geçer. Tanınmayan anahtar (ör. 'pallete') istek gitmeden reddedilir: platform temayı doğrulamayan bir jsonb blob'u olarak saklar ve yazım hatası kayıtta sessizce yaşardı"),
+            unset: z.array(z.string().min(1)).optional().describe("Silinecek nokta yolları: 'presets.kart', 'componentPresets.button.versions.V2', 'headingFontFamily', 'paletteDark.accent.primary'. Silmenin kanalı budur — null yazmak silmez"),
+            replace: z.boolean().optional().describe("true: 'theme' mevcut kaydın YERİNE geçer (birleştirme yok). Temayı sıfırlamak: replace: true, theme: {}"),
+            applicationId: guid.optional().describe('Verilirse componentPresets tipleri o uygulamanın kataloğuna göre denetlenir (THEME-011); verilmezse bu kontrol atlanır'),
+            dryRun: z.boolean().optional().describe('Yazmadan aynı yanıtı döner: changed + cssVarsChanged + lint bulguları. Yazmadan önce ekranda ne değişeceğini görmenin yolu budur'),
+            policyOverride: z.boolean().optional().describe('block bulgularını warn\'a indirir (bilinçli istisna)')
+        },
+        annotations: updates
+    }, handle(config, async ({ project, theme, unset, replace, applicationId, dryRun, policyOverride }) => {
+        if (theme === undefined && (unset === undefined || unset.length === 0)) {
+            throw new PlatformApiError("theme_update: 'theme' ya da 'unset' parametrelerinden en az biri dolu olmalı. Temayı sıfırlamak için replace: true, theme: {} verin.", 400);
+        }
+        const { project: projectInfo, payload, theme: base } = await loadProject(platform, project);
+        const data = (payload?.data ?? {});
+        const name = typeof data.name === 'string' ? data.name : undefined;
+        const slug = typeof data.slug === 'string' ? data.slug : undefined;
+        if (name === undefined || data.id === undefined) {
+            throw new PlatformApiError(`theme_update: '${platform.resolveProject(project)}' projesi okunamadı (ad ya da id yok); project_get ile kontrol edin.`, 400);
+        }
+        const patch = (theme ?? {});
+        const current = base ?? {};
+        const merged = replace === true ? patch : mergeTheme(current, patch);
+        const removal = unsetThemePaths(merged, unset ?? []);
+        const normalized = normalizeTheme(removal.theme);
+        const next = normalized.theme;
+        const findings = [...enforcePolicy(evaluatePolicy(config, policyRules, 'theme', next, { operation: 'update' }, policyOverride))];
+        // Uyarılar `policyRules` dışında üretiliyor (girdiye ve platform okumasına bakıyorlar), bu
+        // yüzden POLICY kipini ve policyOverride'ı kendileri uygulamak zorunda — WF-031 ile aynı yol.
+        if (config.policyMode !== 'off') {
+            const warnings = [
+                ...themeInputWarnings(patch, next),
+                ...unsetWarnings(current, unset ?? [])
+            ];
+            if (applicationId !== undefined && Object.keys(next.componentPresets ?? {}).length > 0) {
+                const catalog = await platform.tenant('GET', project, `/components/${applicationId}`, { query: { pageIndex: 0, pageLength: 999 } })
+                    .catch(() => undefined);
+                if (catalog?.data)
+                    warnings.push(...componentPresetTypeWarnings(next, catalog.data));
+            }
+            findings.push(...applyPolicyMode(config, warnings, policyOverride));
+        }
+        const before = resolveTheme(current).cssVars;
+        const after = resolveTheme(next).cssVars;
+        const changed = diffThemePaths(current, next);
+        const head = {
+            project: projectInfo,
+            changed: { ...changed, ...(removal.missing.length > 0 ? { missing: removal.missing } : {}) },
+            cssVarsChanged: diffCssVars(before, after),
+            theme: summarizeTheme(next)
+        };
+        const panelWarning = "Studio tema paneli AÇIK ve kaydedilmemişse panelin sonraki Save'i bu yazmayı ezer; panel kapalıyken yazın.";
+        const note = `Tema PROJE kaydıdır: bu değişiklik bütün ortamların runtime'ına indi (production dâhil). Kanıt: page_screenshot — ikinci mod için colorScheme:'dark'. ${panelWarning}`;
+        if (dryRun === true) {
+            return attachFindings(withNormalization({
+                ...head,
+                dryRun: true,
+                // Kuru koşunun notu GELECEK zaman kurar: yazma notunu "YAZILMADI" önekiyle sunmak
+                // aynı cümlede iki şey söylüyordu ("yazılmadı" + "indi") — ölçüldü 2026-09-15 canlı koşu.
+                note: `YAZILMADI (dryRun) — bu çağrı hiçbir şey değiştirmedi. Yazarsanız değişiklik bütün ortamların runtime'ına iner (production dâhil) ve ekranda page_screenshot ile doğrulanır (ikinci mod için colorScheme:'dark'). ${panelWarning}`
+            }, normalized.fixes), findings);
+        }
+        const form = projectUpdateForm({ name, slug, theme: JSON.stringify(next) });
+        const response = await platform.org('PUT', `/projects/${String(data.id)}`, { form });
+        return attachFindings(withNormalization({ ...head, updated: true, note, platform: response }, normalized.fixes), findings);
+    }));
+}

package/dist/tools/workflows.js

@@ -4,7 +4,7 @@ import { evaluatePolicy, enforcePolicy, attachFindings } from '../knowledge/poli
 import { workflowOutline, resolvePart, resolvePatchOperations } from '../knowledge/outlines.js';
 import { patchResult, baseVersionOf } from '../platform/patch.js';
 import { writeDiff, withWriteDiff } from '../platform/writeDiff.js';
-import { policyRules, microfunctionStepFindings } from '../knowledge/rules.js';
+import { policyRules, microfunctionStepFindings, undefinedInputFieldFindings } from '../knowledge/rules.js';
 import { languageHeader } from '../knowledge/languageCodes.js';
 import { handle } from '../platform/responses.js';
 import fastJsonPatch from 'fast-json-patch';
@@ -118,7 +118,8 @@ export function registerWorkflowTools(server, platform) {
         const normalized = normalizeWorkflowDefinition(definition);
         const findings = enforcePolicy([
             ...evaluatePolicy(config, policyRules, 'workflow', definition, { operation: 'create', workflowKind: definition.type }, policyOverride),
-            ...await microfunctionStepFindings(platform, project, environment, definition, definition.type, policyOverride)
+            ...await microfunctionStepFindings(platform, project, environment, definition, definition.type, policyOverride),
+            ...await undefinedInputFieldFindings(platform, project, environment, definition, definition.type, policyOverride)
         ]);
         const drift = unmappedMembers('CreateWorkflowCommand', definition);
         const payload = await platform.tenant('POST', project, `/workflows/${applicationId}`, { environment, body: definition });
@@ -133,7 +134,8 @@ export function registerWorkflowTools(server, platform) {
         const normalized = normalizeWorkflowDefinition(definition);
         const findings = enforcePolicy([
             ...evaluatePolicy(config, policyRules, 'workflow', definition, { operation: 'update', workflowKind: definition.type }, policyOverride),
-            ...await microfunctionStepFindings(platform, project, environment, definition, definition.type, policyOverride)
+            ...await microfunctionStepFindings(platform, project, environment, definition, definition.type, policyOverride),
+            ...await undefinedInputFieldFindings(platform, project, environment, definition, definition.type, policyOverride)
         ]);
         const drift = unmappedMembers('UpdateWorkflowCommand', definition);
         const payload = await platform.tenant('PUT', project, `/workflows/${applicationId}/${id}`, { environment, body: definition });
@@ -153,7 +155,8 @@ export function registerWorkflowTools(server, platform) {
         const normalized = normalizeWorkflowDefinition(patched);
         const findings = enforcePolicy([
             ...evaluatePolicy(config, policyRules, 'workflow', patched, { operation: 'update', workflowKind: patched.type }, policyOverride),
-            ...await microfunctionStepFindings(platform, project, environment, patched, patched.type, policyOverride)
+            ...await microfunctionStepFindings(platform, project, environment, patched, patched.type, policyOverride),
+            ...await undefinedInputFieldFindings(platform, project, environment, patched, patched.type, policyOverride)
         ]);
         const drift = introducedUnmappedMembers('UpdateWorkflowCommand', (current?.data ?? current), patched);
         // Gövde değil FARK gönderilir: gateway normalizasyonları da op'a çevrilsin diye net diff
@@ -185,7 +188,7 @@ export function registerWorkflowTools(server, platform) {
     }, handle(config, ({ project, environment, id }) => platform.tenant('POST', project, `/workflows/clone/${id}`, { environment })));
     server.registerTool('workflow_preview', {
         title: 'Workflow önizle',
-        description: "Kaydedilmemiş workflow tanımını çalıştırır; kaydetmeden önce her akışı preview ile doğrulayın. definition = PreviewWorkflowCommand gövdesi. Test girdisi 'previewPayload' anahtarıyla verilir ('parameters'/'input' ÇALIŞMAZ), değişkenler 'previewVariables'. previewPayload STRING olmalıdır (JSON.stringify(...) ya da \"({ id: 1 })\") — nesne gönderilirse platform 'Unexpected end of input' ile 500 döner. Akışın parameterDtoId'si YOKSA previewPayload verilmez (platform 400 döner; gateway alanı düşürüp gatewayNormalized ile bildirir). Preview tek transaction'da koşar ve sonunda ROLLBACK edilir: table create/update step'leri kalıcı satır YAZMAZ (ölçüldü, İK koşusu W-1). Tek istisna code step içindeki dış HTTP çağrılarıdır — onlar geri alınamaz. Davranış kuralları: platform_guide('workflow'). " + constraintSummary('PreviewWorkflowCommand'),
+        description: "Kaydedilmemiş workflow tanımını çalıştırır; kaydetmeden önce her akışı preview ile doğrulayın. definition = PreviewWorkflowCommand gövdesi. Test girdisi 'previewPayload' anahtarıyla verilir ('parameters'/'input' ÇALIŞMAZ), değişkenler 'previewVariables'. previewPayload STRING olmalıdır (JSON.stringify(...) ya da \"({ id: 1 })\") — nesne gönderilirse platform 'Unexpected end of input' ile 500 döner. Akışın parameterDtoId'si YOKSA previewPayload verilmez (platform 400 döner; gateway alanı düşürüp gatewayNormalized ile bildirir). Preview tek transaction'da koşar ve sonunda ROLLBACK edilir: table create/update step'leri kalıcı satır YAZMAZ (ölçüldü, İK koşusu W-1). Tek istisna code step içindeki dış HTTP çağrılarıdır — onlar geri alınamaz. Yanıt WorkflowPreviewDto: steps[] (her adım: step{id,name,type}, input[] ifade→değer, output, hasError, errorType, errorMessage, errorDetail, elapsedMilliseconds, nextStep, children[] loop/alt akış, automations[]), input, output, executionSuccess. executionSuccess YALNIZ son adıma bakar; gateway tüm ağacı tarayıp hata bulursa yanıta 'runtimeErrors' ekler — HTTP 200 akışın geçtiği anlamına gelmez, ÖNCE bu alana bakın; 'input' boşsa girdi hiç bağlanmamıştır. Kayıtlı bir akışı çalıştırmadan sınamak için workflow_get gövdesini (steps + kayıtlı previewPayload/previewVariables) olduğu gibi verin — Studio'nun Önizleme düğmesi de bunu yapar. Zamanlanmış işin akışında previewPayload vermeyin (iş girdisiz koşar); job geçmişi hatayı mesaj olarak yazar, adım izini burada görün (platform_guide('microservice') §Zamanlanmış işin gerçek sonucunu görmek). Okuma rehberi: platform_guide('workflow') §Önizleme çıktısını okumak. " + constraintSummary('PreviewWorkflowCommand'),
         inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, definition: definitionParam, policyOverride: policyOverrideParam, language: languageParam },
         annotations: writes
     }, handle(config, async ({ project, environment, applicationId, definition, policyOverride, language }) => {
@@ -198,7 +201,8 @@ export function registerWorkflowTools(server, platform) {
         }
         const findings = enforcePolicy([
             ...evaluatePolicy(config, policyRules, 'workflow', definition, { operation: 'preview', workflowKind: definition.type }, policyOverride),
-            ...await microfunctionStepFindings(platform, project, environment, definition, definition.type, policyOverride)
+            ...await microfunctionStepFindings(platform, project, environment, definition, definition.type, policyOverride),
+            ...await undefinedInputFieldFindings(platform, project, environment, definition, definition.type, policyOverride)
         ]);
         const payload = await platform.tenant('POST', project, `/workflows/${applicationId}/preview`, { environment, body: definition, headers: languageHeader(language, normalized) });
         return attachFindings(withNormalization(payload, normalized), findings);

package/package.json

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