@appaflytech/zeyrek-ai-mcp 0.0.35 → 0.0.37

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/nativeBoxModel.js

@@ -0,0 +1,44 @@
+import { MOBILE_DROPPABLE_TYPES } from '../mobileComponentCatalog.js';
+/**
+ * Mobil runtime'ın kutu modelinin aynası (MOB-019): bir düğümün sol dış boşluğu ve çocuklarını içeri iten sol
+ * iç boşluğu. Kaynak `@ng-apps/screen-builder` `spacing.ts` (`resolveSpacing`, sabitler, `HIDE_SPACING_TYPES`),
+ * `constants.ts` (`NO_PADDING_TYPES`) ve `ng-apps-ui-native` `renderer.functions.ts` (`nodeSpacingStyle`,
+ * `FLUSH_SPACING_TYPES`). Ayna bayatlarsa `test/native-inset-parity.test.ts` kırmızıya düşer.
+ */
+export const RUNTIME_NORMAL_MARGIN = 4;
+export const RUNTIME_NORMAL_PADDING = 10;
+export const FLUSH_SPACING_TYPES = ['safe-area', 'scroll-view', 'app-bar', 'tooltip', 'view'];
+export const HIDE_SPACING_TYPES = ['auth-layout', 'modal', 'drawer'];
+export const NO_PADDING_TYPES = ['auth-layout', 'modal', 'drawer'];
+export const SHELL_ROOT_TYPES = ['layout', 'layout-shell'];
+/** `widthType` yazılmasa da tam genişlik çizilen tipler (`renderer.functions.ts` `FULL_WIDTH_TYPES`, MOB-020). */
+export const FULL_WIDTH_TYPES = ['app-bar'];
+/** Düğümün sol dış boşluğu (dp). `isWrapper`, katmanlar ve kabuk kökü dış boşluk almaz. */
+export function nativeMarginLeft(node) {
+    const states = (node.states ?? {});
+    const type = String(node.type ?? '');
+    if (states.isWrapper || HIDE_SPACING_TYPES.includes(type) || states.isShell || SHELL_ROOT_TYPES.includes(type))
+        return 0;
+    return sideValue(node.appearance, 'margin', FLUSH_SPACING_TYPES.includes(type), RUNTIME_NORMAL_MARGIN);
+}
+/** Bırakılabilir düğümün çocuklarına verdiği sol iç boşluk (dp); `isWrapper` bunu SIFIRLAMAZ (01'de ölçüldü). */
+export function nativePaddingLeft(node) {
+    const states = (node.states ?? {});
+    const type = String(node.type ?? '');
+    const droppable = states.isDroppable ?? MOBILE_DROPPABLE_TYPES.includes(type);
+    if (!droppable || NO_PADDING_TYPES.includes(type) || states.isShell || SHELL_ROOT_TYPES.includes(type))
+        return 0;
+    return sideValue(node.appearance, 'padding', FLUSH_SPACING_TYPES.includes(type), RUNTIME_NORMAL_PADDING);
+}
+/** `resolveSpacing`: tip yoksa (ya da boşsa) `normal`; `custom` kenar değerini, yoksa tek değeri okur. */
+function sideValue(appearance, layer, flush, normal) {
+    const written = appearance?.[`${layer}Type`];
+    const type = typeof written === 'string' && written !== '' ? written : flush ? 'none' : 'normal';
+    if (type === 'normal')
+        return normal;
+    if (type !== 'custom')
+        return 0;
+    const values = appearance?.[`${layer}Values`];
+    const left = Number(values?.left ?? appearance?.[`${layer}Value`] ?? 0);
+    return Number.isFinite(left) ? left : 0;
+}

package/dist/knowledge/platform/profile.js

@@ -0,0 +1,25 @@
+/**
+ * Değişken kaydının `storage` alanının alabildiği değerler (`docs/adr/0004-state-saklama-turu.md`):
+ * `device` cihaz deposu, `secure` güvenli depo. Alanın yokluğu bellektir — `memory` kayda yazılmaz.
+ */
+export const STATE_STORAGE_KINDS = ['device', 'secure'];
+/**
+ * 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,39 @@
+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', 'share', 'haptic', 'location', 'notification-permission', 'notification-schedule', 'notification-cancel', 'permission', 'open-settings']),
+        aliases: STEP_ALIASES,
+        infoOnly: new Set()
+    },
+    shell: {
+        components: new Set(['navigations', 'sidebar', 'header']),
+        suggestions: {},
+        legacyShellNodes: new Set()
+    },
+    externalComponents: true,
+    state: { storageKinds: new Set() },
+    capture: {
+        target: 'studio-web',
+        devices: { desktop: { width: 1280, height: 800, dpr: 1 } },
+        defaultDevice: 'desktop'
+    }
+});

package/dist/knowledge/policy.js

@@ -1,13 +1,27 @@
 import { logStep } from '../observability/trace.js';
 export class PolicyBlockError extends Error {
     findings;
-    constructor(findings) {
+    canOverride;
+    /**
+     * `canOverride` kaçış cümlesini seçer. Her tool `policyOverride` girdisini
+     * TAŞIMAZ (row_*, datasource_*, folder_*, project_*, translation_*,
+     * external_component_*): oralarda "aynı çağrıyı policyOverride ile
+     * tekrarlayın" demek olmayan bir alana yönlendirmekti ve çağıran aynı
+     * isteği ikinci kez gönderip aynı duvara çarpıyordu (S-12, 2026-09-19).
+     * Girdiyi taşıyan tool'larda da mutlak kapılar vardır (BPM-001/014/018
+     * ortam ve imza kapıları): orada da bu dal seçilir, o yüzden cümle "bu
+     * çağrı" der.
+     */
+    constructor(findings, canOverride = true) {
         super([
             'Politika kontrolü isteği durdurdu (istek platforma gönderilmedi):',
             ...findings.map(finding => `- [${finding.ruleId}] ${finding.message}${finding.guide ? ` (rehber: ${finding.guide})` : ''}`),
-            "Bilinçli bir istisnaysa aynı çağrıyı policyOverride: true ile tekrarlayın; kural yanlışsa zeyrek-mcp/docs/08-kural-envanteri.md'ye işleyin."
+            canOverride
+                ? "Bilinçli bir istisnaysa aynı çağrıyı policyOverride: true ile tekrarlayın; kural yanlışsa zeyrek-mcp/docs/08-kural-envanteri.md'ye işleyin."
+                : "Bu çağrı policyOverride kabul etmez: çağrıyı kuralı sağlayacak biçimde değiştirin; kural yanlışsa zeyrek-mcp/docs/08-kural-envanteri.md'ye işleyin."
         ].join('\n'));
         this.findings = findings;
+        this.canOverride = canOverride;
         this.name = 'PolicyBlockError';
     }
 }
@@ -35,11 +49,11 @@ export function evaluatePolicy(config, rules, module, definition, context, polic
     logStep('politika', `${module}/${context.operation}${context.workflowKind ? ` (${context.workflowKind})` : ''} · ${applicable.length} kural denendi · ${findings.length === 0 ? 'bulgu yok' : `${findings.length} bulgu`}${policyOverride ? ' · policyOverride açık' : ''}`, findings.map(finding => `[${finding.ruleId}] ${finding.severity}: ${finding.message}`));
     return findings;
 }
-export function enforcePolicy(findings) {
+export function enforcePolicy(findings, canOverride = true) {
     const blocking = findings.filter(finding => finding.severity === 'block');
     if (blocking.length > 0) {
         logStep('politika ✕', `${blocking.length} block bulgusu isteği durdurdu — platforma HİÇBİR istek gitmedi`, blocking.map(finding => `[${finding.ruleId}] ${finding.message}`));
-        throw new PolicyBlockError(blocking);
+        throw new PolicyBlockError(blocking, canOverride);
     }
     return findings;
 }