@appaflytech/zeyrek-ai-mcp 0.0.21 → 0.0.22

package/dist/knowledge/platform/mobileTabs.js

@@ -0,0 +1,108 @@
+export const MAX_MOBILE_TABS = 5;
+const STYLES = new Set(['default', 'floating', 'custom']);
+function record(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : undefined;
+}
+function text(value) {
+    return typeof value === 'string' && value.trim().length > 0 ? value.trim() : undefined;
+}
+/** Öğenin sayfa id'si: `{ page }` ya da düz metin (`items: ['id']`). */
+function entryPage(entry) {
+    const item = record(entry);
+    return item ? text(item.page) : text(entry);
+}
+/** `Application.properties.mobile.tabs` — ham değer, doğrulanmamış. */
+export function readMobileTabs(properties) {
+    return record(record(properties)?.mobile)?.tabs;
+}
+/**
+ * Ham sekme ayarını çizilebilir biçime getirir; çizilecek çubuk yoksa `null` (yığın).
+ *
+ * - Nesne değilse, `enabled !== true` ise ya da geçerli öğe kalmadıysa → `null`.
+ * - `style` bilinmiyorsa `default`; `showLabels` boolean değilse `true`.
+ * - Öğe `{ page }` ya da düz sayfa id'sidir; sayfası yoksa düşer; `pages` verildiyse orada olmayan
+ *   sayfa düşer; tekrar eden sayfa (ilki kalır) atılır; `MAX_MOBILE_TABS`'tan sonrası kırpılır.
+ *   `label`/`icon` boş metinse yazılmaz.
+ * - Görünüm alanı yoktur: çubuk temadan çizilir; eski kayıtların `appearance`'ı okunmaz.
+ * - `customWidgetId` yalnız `custom` türde ve metinse yazılır.
+ */
+export function normalizeMobileTabs(tabs, pages) {
+    const source = record(tabs);
+    if (!source || source.enabled !== true)
+        return null;
+    const known = pages ? new Set(pages.map(page => page.id)) : undefined;
+    const seen = new Set();
+    const items = [];
+    for (const entry of Array.isArray(source.items) ? source.items : []) {
+        const item = record(entry);
+        const page = entryPage(entry);
+        if (!page || seen.has(page) || (known && !known.has(page)))
+            continue;
+        seen.add(page);
+        const label = text(item?.label);
+        const icon = text(item?.icon);
+        items.push({ page, ...(label ? { label } : {}), ...(icon ? { icon } : {}) });
+        if (items.length === MAX_MOBILE_TABS)
+            break;
+    }
+    if (items.length === 0)
+        return null;
+    const style = (typeof source.style === 'string' && STYLES.has(source.style) ? source.style : 'default');
+    const customWidgetId = style === 'custom' ? text(source.customWidgetId) : undefined;
+    return {
+        enabled: true,
+        style,
+        items,
+        ...(customWidgetId ? { customWidgetId } : {}),
+        showLabels: typeof source.showLabels === 'boolean' ? source.showLabels : true
+    };
+}
+/**
+ * MOB-007 denetimi: ham ayarın normalizasyonda neyi kaybedeceğini ve tutarsızlıklarını söyler.
+ * Yazım yine platforma gider (D3); bulgular yalnız uyarıdır.
+ */
+export function mobileTabsProblems(tabs, context = {}) {
+    if (tabs === undefined || tabs === null)
+        return [];
+    const source = record(tabs);
+    if (!source)
+        return [`properties.mobile.tabs nesne olmalı (gelen: ${Array.isArray(tabs) ? 'dizi' : typeof tabs}) — sekme çubuğu çizilmez, uygulama yığınla açılır`];
+    const problems = [];
+    const rawItems = Array.isArray(source.items) ? source.items : undefined;
+    if (source.enabled !== undefined && typeof source.enabled !== 'boolean')
+        problems.push(`enabled boolean olmalı (gelen: ${JSON.stringify(source.enabled)}) — true olmayan her değer sekmeleri kapatır`);
+    if (source.style !== undefined && !(typeof source.style === 'string' && STYLES.has(source.style)))
+        problems.push(`style '${String(source.style)}' tanınmıyor (default | floating | custom) — 'default' çizilir`);
+    if (source.items !== undefined && !rawItems)
+        problems.push('items dizi olmalı — hiçbir sekme çizilmez');
+    const items = rawItems ?? [];
+    const pageIds = items.map(entryPage);
+    if (source.enabled === true && items.length === 0)
+        problems.push("enabled:true ama items boş — çubuk çizilmez; en az bir sayfa ekleyin ya da enabled:false yazın");
+    if (items.length > MAX_MOBILE_TABS)
+        problems.push(`${items.length} sekme var, en çok ${MAX_MOBILE_TABS} çizilir — fazlası kırpılır (${pageIds.slice(MAX_MOBILE_TABS).filter(Boolean).join(', ')})`);
+    const missingPage = pageIds.filter(id => !id).length;
+    if (missingPage > 0)
+        problems.push(`${missingPage} öğede page (sayfa id'si) yok — o öğeler düşer`);
+    const duplicates = pageIds.filter((id, index) => id && pageIds.indexOf(id) !== index);
+    if (duplicates.length > 0)
+        problems.push(`aynı sayfa birden çok sekmede: ${[...new Set(duplicates)].join(', ')} — tekrarlar atılır`);
+    if (context.pages) {
+        const known = new Set(context.pages.map(page => page.id));
+        const unknown = pageIds.filter((id) => Boolean(id) && !known.has(id));
+        if (unknown.length > 0)
+            problems.push(`var olmayan sayfa: ${[...new Set(unknown)].join(', ')} — page_list ile id'leri doğrulayın; bu öğeler düşer (item.page slug değil sayfa id'sidir)`);
+    }
+    const normalized = normalizeMobileTabs(tabs, context.pages ?? null);
+    if (normalized && context.homepageId && normalized.items[0]?.page !== context.homepageId) {
+        problems.push(`açılış sayfası (${context.homepageId}) ilk sekme değil — uygulama açılış sayfasıyla başlar ama çubukta başka sekme seçili görünür; açılış sayfasını items'ın başına alın`);
+    }
+    if (normalized?.style === 'custom') {
+        const widgetId = normalized.customWidgetId;
+        if (!widgetId)
+            problems.push("style:'custom' ama customWidgetId yok — özel sekme çubuğu widget'ı seçilmeli (component_list kind:'widget')");
+        else if (context.widgetIds && !context.widgetIds.has(widgetId))
+            problems.push(`customWidgetId '${widgetId}' bu mobil uygulamanın widget'ı değil — çubuk yerine uyarı çizilir`);
+    }
+    return problems;
+}

package/dist/knowledge/platform/profile.js

@@ -0,0 +1,20 @@
+/**
+ * Motorun kendi register ettiği adımlar (`@ng-apps/flow` `flow-engine.ts` initialize) — iki
+ * platformda da koşar. `end` ve `query` hiçbir barındırıcıda yoktur (normalizasyon `end`'i atar).
+ */
+export const ENGINE_STEP_TYPES = ['start', 'setter', 'code', 'condition', 'microservice', 'validation', 'flow-trigger', 'function'];
+/**
+ * Eski adım tipi → koşan karşılığı. `navigate` ile `redirect`'in argümanı aynıdır; web `navigate`'i
+ * register etmez, yeni mobil runtime onu `redirect` takma adı olarak kaydeder — iki platformda da
+ * `redirect` kesin üstündür.
+ */
+export const STEP_ALIASES = Object.freeze({ navigate: 'redirect' });
+/** Tipli stil grupları iki platformda da çizilir (web CSS'e, mobil RN stiline derler). */
+export const TYPED_STYLE_GROUPS = ['surfaceStyle', 'typographyStyle', 'sectionStyle', 'headerStyle', 'valueStyle'];
+/** Bulguyu mevcut `layoutWarnings[]` satır biçimine çevirir (`PAGE-010 (uyarı) — …` kalıbı). */
+export function findingLine(finding) {
+    const level = finding.severity === 'info' ? 'bilgi' : 'uyarı';
+    const target = finding.target ? ` [${finding.target}]` : '';
+    const guide = finding.guide ? ` (${finding.guide})` : '';
+    return `${finding.code} (${level})${target} — ${finding.message}${guide}`;
+}

package/dist/knowledge/platform/resolve.js

@@ -0,0 +1,122 @@
+import { mobileProfile } from './mobile.js';
+import { webProfile } from './web.js';
+export const APPLICATION_TYPE_TTL_MS = 10 * 60_000;
+const caches = new WeakMap();
+function cacheOf(platform) {
+    let cache = caches.get(platform);
+    if (!cache) {
+        cache = new Map();
+        caches.set(platform, cache);
+    }
+    return cache;
+}
+/** Backend `ApplicationType` JSON'da açıklama metniyle ('web' | 'mobile') döner; eski sayısal biçim de okunur. */
+export function readApplicationPlatform(value) {
+    if (value === 1 || (typeof value === 'string' && value.toLowerCase() === 'mobile'))
+        return 'mobile';
+    if (value === 0 || (typeof value === 'string' && value.toLowerCase() === 'web'))
+        return 'web';
+    return undefined;
+}
+export function profileFor(platform) {
+    return platform === 'mobile' ? mobileProfile : webProfile;
+}
+function factsOf(record) {
+    const platform = readApplicationPlatform(record.type);
+    const id = typeof record.id === 'string' ? record.id : undefined;
+    if (!platform || !id)
+        return undefined;
+    const homepage = record.homepage && typeof record.homepage === 'object' ? record.homepage.id : undefined;
+    const homepageId = typeof record.homepageId === 'string' ? record.homepageId : typeof homepage === 'string' ? homepage : undefined;
+    const properties = record.properties && typeof record.properties === 'object' && !Array.isArray(record.properties)
+        ? record.properties
+        : undefined;
+    return {
+        id,
+        platform,
+        ...(typeof record.slug === 'string' ? { slug: record.slug } : {}),
+        ...(typeof record.name === 'string' ? { name: record.name } : {}),
+        ...(typeof record.projectSlug === 'string' ? { projectSlug: record.projectSlug } : {}),
+        ...(homepageId ? { homepageId } : {}),
+        ...(properties ? { properties } : {})
+    };
+}
+function fresh(entry) {
+    return entry !== undefined && Date.now() - entry.at < APPLICATION_TYPE_TTL_MS;
+}
+export async function resolveApplication(platform, applicationId) {
+    const cache = cacheOf(platform);
+    const cached = cache.get(applicationId);
+    if (fresh(cached))
+        return cached.facts;
+    try {
+        const payload = await platform.org('GET', `/applications/${applicationId}`);
+        const facts = factsOf(((payload?.data ?? payload) ?? {}));
+        if (facts)
+            cache.set(applicationId, { facts, at: Date.now() });
+        return facts;
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function resolveProfile(platform, applicationId) {
+    const application = await resolveApplication(platform, applicationId);
+    return application
+        ? { profile: profileFor(application.platform), known: true, application }
+        : { profile: webProfile, known: false };
+}
+const SLUG_LOOKUP_PAGE = 50;
+/**
+ * `page_screenshot` ve `page_runtime_get` uygulamayı slug ile tanır. Org listesi `searchTerm` ile
+ * daraltılır ve slug + proje slug'ı BİREBİR eşleşen kayıt alınır (arama ILIKE'tır, `shop` `shop-2`'yi
+ * de getirir). B1'den beri liste tip filtresi verilmeyince iki tipi de döner. Aynı slug'ı çok proje
+ * kullanıyorsa (`mobile`, `admin`) aranan kayıt ilk sayfanın dışında kalabilir: sayfa doluysa ve
+ * eşleşme yoksa arama proje kimliğiyle tekrarlanır — (proje, slug) tekildir.
+ */
+export async function resolveProfileBySlug(platform, projectSlug, applicationSlug) {
+    const cache = cacheOf(platform);
+    const key = `slug:${projectSlug}/${applicationSlug}`;
+    const cached = cache.get(key);
+    if (fresh(cached))
+        return { profile: profileFor(cached.facts.platform), known: true, application: cached.facts };
+    try {
+        const search = async (query) => {
+            const payload = await platform.org('GET', '/applications', { query: { searchTerm: applicationSlug, pageLength: SLUG_LOOKUP_PAGE, ...query } });
+            return Array.isArray(payload?.data) ? payload.data : [];
+        };
+        const matchIn = (rows) => rows.find(row => row.slug === applicationSlug && (row.projectSlug === undefined || row.projectSlug === projectSlug));
+        const rows = await search({});
+        let match = matchIn(rows);
+        if (!match && rows.length >= SLUG_LOOKUP_PAGE) {
+            const project = await platform.org('GET', `/p/${projectSlug}`);
+            const projectId = (project?.data ?? project)?.id;
+            if (typeof projectId === 'string')
+                match = matchIn(await search({ projectId }));
+        }
+        const facts = match ? factsOf(match) : undefined;
+        if (!facts)
+            return { profile: webProfile, known: false };
+        cache.set(key, { facts, at: Date.now() });
+        return { profile: profileFor(facts.platform), known: true, application: facts };
+    }
+    catch {
+        return { profile: webProfile, known: false };
+    }
+}
+/** Yazma araçları uygulamayı değiştirdiğinde (tip, slug, properties) kaydı düşürür. */
+export function forgetApplication(platform, applicationId) {
+    const cache = cacheOf(platform);
+    if (applicationId === undefined) {
+        cache.clear();
+        return;
+    }
+    for (const [key, entry] of cache) {
+        if (key === applicationId || entry.facts.id === applicationId)
+            cache.delete(key);
+    }
+}
+/** Yanıta eklenen alan: tip biliniyorsa `applicationType`, bilinmiyorsa hiçbir şey. */
+export function applicationTypeField(resolved) {
+    return resolved.known ? { applicationType: resolved.profile.platform } : {};
+}

package/dist/knowledge/platform/web.js

@@ -0,0 +1,38 @@
+import { ENGINE_STEP_TYPES, STEP_ALIASES } from './profile.js';
+import { pageContainerNode } from '../normalize.js';
+/**
+ * Web profili = gateway'in profil öncesi davranışı. Buradaki her değer bugün kodda bir yerde
+ * örtük olarak vardı; `test/platform-profile.test.ts` golden'ı bu profilin çıktıyı değiştirmediğini
+ * kilitler. Değer değiştirmek web davranışını değiştirir — golden kırmızıya döner.
+ */
+export const webProfile = Object.freeze({
+    platform: 'web',
+    catalogType: 'web',
+    layout: {
+        modes: new Set(['grid', 'flex', 'cssgrid']),
+        blocksMeaningful: true,
+        rootContainer: pageContainerNode,
+        orderBy: 'block-position'
+    },
+    appearance: {
+        ignoredKeys: new Set(),
+        sizeUnits: new Set(['px', '%', 'em', 'rem', 'calc'])
+    },
+    style: { freeStyle: true, hoverStyle: true, resolver: 'css' },
+    steps: {
+        registered: new Set([...ENGINE_STEP_TYPES, 'alert', 'confirm', 'redirect', 'download', 'storage', 'setcookie']),
+        aliases: STEP_ALIASES,
+        infoOnly: new Set()
+    },
+    shell: {
+        components: new Set(['navigations', 'sidebar', 'header']),
+        suggestions: {},
+        legacyShellNodes: new Set()
+    },
+    externalComponents: true,
+    capture: {
+        target: 'studio-web',
+        devices: { desktop: { width: 1280, height: 800, dpr: 1 } },
+        defaultDevice: 'desktop'
+    }
+});

package/dist/knowledge/rules.js

@@ -170,13 +170,11 @@ const flowLiteralTextFields = new Map([
     ['confirm', ['message', 'title', 'confirmText', 'cancelText']]
 ]);
 const flowExpressionLooking = /\$\{|\b(?:Steps|Page|Row|Widget|LocalStorage|state|self|item|event|error|cookie)\s*(?:\?\.|\.|\[)/;
-// Barındırıcıya özel tipler (`navigate` web'de, `confirm`/`download` mobilde register edilmez)
-// BURADA kural üretmez. `navigate`i gateway normalizasyonu zaten `redirect`e çeviriyor
-// (normalize.ts `normalizeFlowHostGaps`) — `redirect` iki barındırıcıda da koşar, yani vaka
-// uyarılmaz, ORTADAN KALKAR. Geriye kalan `confirm`/`download` tek başına kusur değildir: sayfa
-// tek bir uygulamaya aittir (`Page.ApplicationId`), uygulamanın tipi web ya da mobile'dır
-// (`ApplicationType.cs`) ve gateway hangisi olduğunu bilmez. Mobil ayağı uygulama tarafında
-// kapanır (`ScreenRuntime.tsx`), lint'te değil.
+// Barındırıcıya özel tipler BURADA kural üretmez. `navigate`i gateway normalizasyonu zaten
+// `redirect`e çeviriyor (normalize.ts `normalizeFlowHostGaps`) — `redirect` iki barındırıcıda da
+// koşar, yani vaka uyarılmaz, ORTADAN KALKAR. Gateway uygulamanın tipini platform profilinden bilir
+// ve barındırıcı sözlüğü `platform/*.ts`'tedir (`profile.steps`); mobil farkları orada `MOB-005`
+// olarak konuşulur (`platform/lint.ts`). Yeni mobil runtime `confirm`/`download`'ı kaydeder.
 const flowUnregisteredStepTypes = new Set(['end', 'query']);
 const flowSetterIterateeTypes = new Set(['change', 'fill']);
 function flowStepList(value) {
@@ -2389,7 +2387,7 @@ export const policyRules = [
         id: 'FLOW-023',
         module: 'flow',
         appliesTo: ['create', 'update'],
-        sourceRef: "Adım tipi sözlüğü backend'indir (StepType.cs) ama koşan tipler barındırıcıdan gelir: flow-engine.ts start·setter·code·condition·microservice·validation·flow-trigger register eder, web Runtime.svelte alert·confirm·redirect·download·storage·setcookie ekler, mobil ScreenRuntime.tsx alert·redirect·navigate·storage·setcookie ekler. navigate web'de, confirm/download mobilde YOKTUR; end ve query hiçbir barındırıcıda yoktur (Studio kataloğu da bunu visibility ile söyler: navigate 'mobile', confirm/download 'web'; End eklenebilir adımlar arasında değil — EventActionsAdd.svelte). Register edilmemiş tipe gelen akış SESSİZCE durur: flow-engine.ts process() callback bulamazsa hiçbir şey yapmaz (next yok, completed/stopped yok, hata yok, log yok), run() Promise'i çözülmez ve flowRunFinished() hiç koşmaz — __ngAppsFlowActivity.running sıfıra inmez, page_screenshot'ın hazır bekleyişi her eylemde bütçesini sonuna kadar yakar",
+        sourceRef: "Adım tipi sözlüğü backend'indir (StepType.cs) ama koşan tipler barındırıcıdan gelir: flow-engine.ts start·setter·code·condition·microservice·validation·flow-trigger register eder, web Runtime.svelte alert·confirm·redirect·download·storage·setcookie ekler, mobil @ng-apps/ui-native runtime-tasks.ts alert·confirm·redirect·navigate·storage·setcookie·download ekler. navigate web'de YOKTUR; end ve query hiçbir barındırıcıda yoktur (Studio kataloğu da bunu visibility ile söyler: navigate 'mobile', End eklenebilir adımlar arasında değil — EventActionsAdd.svelte). Register edilmemiş tipe gelen akış SESSİZCE durur: flow-engine.ts process() callback bulamazsa hiçbir şey yapmaz (next yok, completed/stopped yok, hata yok, log yok), run() Promise'i çözülmez ve flowRunFinished() hiç koşmaz — __ngAppsFlowActivity.running sıfıra inmez, page_screenshot'ın hazır bekleyişi her eylemde bütçesini sonuna kadar yakar",
         check: definition => {
             const steps = flowAllSteps(definition);
             // Studio her akış tuvaline dekoratif bir End düğümü koyar ve onu sildirmez; zararlı olan

package/dist/knowledge/styleResolve.js

@@ -539,7 +539,7 @@ const unwrapProp = (value) => {
         result[key] = unwrapProp(item);
     return result;
 };
-const rawProp = (props, name) => {
+export const rawProp = (props, name) => {
     const prop = props?.[name];
     // İfadeye bağlı prop'un değeri çalışma anında oluşur, burada çözülemez.
     return prop && typeof prop === 'object' && 'data' in prop ? unwrapProp(prop.data) : undefined;