@appaflytech/zeyrek-ai-mcp 0.0.5 → 0.0.7

package/dist/knowledge/languages.js

@@ -0,0 +1,105 @@
+/**
+ * Projenin dil durumunu `project_get` / `/p/{slug}` yanıtından okur.
+ *
+ * `ProjectDto.Languages` null alanları serileştirmede DÜŞÜYOR: dili kurulmamış projede yanıtta
+ * `languages` diye bir anahtar hiç yok — "boş liste" bile görünmüyor (canlı doğrulama 2026-09-09,
+ * `mcp-benchmark-2026-09-09`). Ajan bu yüzden eksikliği fark edemiyordu; yokluk ile boş dizi
+ * runtime açısından aynı şeydir ve burada aynı şekilde temsil edilir.
+ *
+ * Alan var ama beklenmedik şekildeyse (dizi değilse) `undefined` döner: gateway o durumda
+ * SUSAR, "dil yok" diye uydurmaz.
+ */
+export function readProjectLanguages(payload) {
+    const data = payload?.data;
+    if (!data || typeof data !== 'object')
+        return undefined;
+    const record = data;
+    const raw = record.languages;
+    if (raw !== undefined && raw !== null && !Array.isArray(raw))
+        return undefined;
+    const languages = Array.isArray(raw) ? raw.filter((entry) => typeof entry === 'string') : [];
+    const defaultLanguage = typeof record.defaultLanguage === 'string' && record.defaultLanguage !== ''
+        ? record.defaultLanguage
+        : undefined;
+    return { languages, defaultLanguage };
+}
+/**
+ * Dil verilmeden açılan projeye gateway'in tohumladığı ayar.
+ *
+ * Backend'in create ucu (`CreateOrganizationProjectCommand`) `Languages`/`DefaultLanguage` alanı
+ * TAŞIMAZ: proje ikisi de `null` doğar ve o hâlde yazılan her çeviri runtime'da ham anahtar olarak
+ * çizilir (`S-15`). Tohum bu durumu doğuştan imkânsız kılar.
+ *
+ * TEK DİL: ikinci bir dil tohumlamak `language-selector`'ı her yeni uygulamada iki seçenekle
+ * çizerdi ve ikincisi hep boş olurdu. Çok dilli uygulama kuran çağıran `languages`'ı açıkça verir.
+ *
+ * Backend de aynı tohumu kendi kurucusunda yazıyor (`ProjectConstants.DefaultLanguages`), ama o
+ * değişiklik dağıtılana kadar çalışan platform hâlâ dilsiz proje doğuruyor — gateway bu yüzden
+ * tohumu koşulsuz yazar. İki taraf aynı değeri tuttuğu için fazladan PUT zararsızdır; backend
+ * sürümü kesinleştiğinde bu adım yalnız `languages` açıkça verildiğinde koşacak şekilde daraltılır.
+ */
+export const SEED_LANGUAGES = ['en'];
+export const SEED_DEFAULT_LANGUAGE = 'en';
+/**
+ * Çağıranın verdiğini olduğu gibi kullanır, eksiği tamamlar, hiçbiri yoksa tohumu döndürür.
+ * `defaultLanguage` her zaman `languages` içindedir — PRJ-002 bunu 422 ile zorunlu tutuyor.
+ */
+export function resolveSeedLanguages(languages, defaultLanguage) {
+    if (!languages?.length && defaultLanguage === undefined) {
+        return { languages: SEED_LANGUAGES, defaultLanguage: SEED_DEFAULT_LANGUAGE, seeded: true };
+    }
+    const resolved = languages?.length ? languages : [defaultLanguage];
+    return { languages: resolved, defaultLanguage: defaultLanguage ?? resolved[0], seeded: false };
+}
+/** Runtime'ın çeviri çözümü kayıtlı bir aktif dil ya da varsayılan dil olmadan anahtara düşer. */
+export function runtimeResolvesTranslations(state) {
+    return state.languages.length > 0 && state.defaultLanguage !== undefined;
+}
+const CHAIN = "runtime aktif dil → varsayılan dil → ANAHTARIN KENDİSİ zincirini izler (zeyrek-frontend/packages/ng-apps-screen-builder/src/translation.functions.ts, resolveTranslation); ilk iki halka boşsa ekrana çeviri değil ham anahtar basılır";
+const WHY_SILENT = "Backend dil kodunu yalnız 184 kodluk ISO sözlüğüne göre doğruluyor (TR-001, ProjectConstants.SupportedLanguages), projenin kendi languages listesine göre DEĞİL — yazma bu yüzden 200 dönüyor ve hiçbir katman uyarmıyor.";
+function quoted(codes) {
+    return codes.map(code => `'${code}'`).join(', ');
+}
+/**
+ * TR-002 — çeviri yazmasını projenin dil listesine bağlar.
+ *
+ * Ölçüm: 2026-09-09 1. koşu `S-15`. 15 anahtar × 2 dil yazıldı (200), 15 prop `translation` tipine
+ * bağlandı (200), şema doğru kuruldu — ama proje `languages` taşımadığı için runtime her etiketi
+ * ham anahtar olarak çizdi. Koşunun en pahalı sessiz düşmesiydi: yalnız ekrana bakınca görülüyor,
+ * rubrikte yanlış "tam" puanına mal oldu. Kontrol yazmayı DURDURMAZ (satırlar geçerli ve sonradan
+ * çözülebilir hale gelir), yüksek sesle söyler.
+ */
+export function translationLanguageFindings(state, writtenCodes, projectSlug) {
+    const codes = [...new Set(writtenCodes)].sort();
+    // Proje okunamadıysa ya da çağrı yalnız silme yapıyorsa söylenecek bir şey yok.
+    if (!state || codes.length === 0)
+        return [];
+    const guide = 'ngapps://guides/translation';
+    if (state.languages.length === 0) {
+        return [{
+                ruleId: 'TR-002',
+                severity: 'warn',
+                message: `'${projectSlug}' projesinde 'languages' listesi TANIMLI DEĞİL: bu yazma platformda başarılı olacak ve satırlar veritabanına düşecek ama RUNTIME HİÇBİRİNİ ÇÖZEMEYECEK — ${CHAIN}. Yazılan kod: ${quoted(codes)}. Düzeltme (yazmadan önce ya da hemen sonra): project_update(id, languages: [${quoted(codes)}], defaultLanguage: '${codes[0]}'). ${WHY_SILENT}`,
+                guide
+            }];
+    }
+    const findings = [];
+    const undeclared = codes.filter(code => !state.languages.includes(code));
+    if (undeclared.length > 0) {
+        findings.push({
+            ruleId: 'TR-002',
+            severity: 'warn',
+            message: `${quoted(undeclared)} kodu '${projectSlug}' projesinin languages listesinde yok (tanımlı: ${quoted(state.languages)}): satırlar yazılır ama runtime o dile hiç geçemez, o dil seçiliyken ${CHAIN}. Düzeltme: project_update(id, languages: [${quoted([...state.languages, ...undeclared])}]). ${WHY_SILENT}`,
+            guide
+        });
+    }
+    if (state.defaultLanguage === undefined) {
+        findings.push({
+            ruleId: 'TR-002',
+            severity: 'warn',
+            message: `'${projectSlug}' projesinde languages kurulu (${quoted(state.languages)}) ama 'defaultLanguage' YOK: runtime kayıtlı bir dil seçimi bulamadığında varsayılana düşer, o da boş olduğu için aktif dil hiç seçilmez ve ilk açılışta her etiket ham anahtar olarak çizilir. Düzeltme: project_update(id, defaultLanguage: '${state.languages[0]}').`,
+            guide
+        });
+    }
+    return findings;
+}

package/dist/knowledge/layoutSummary.js

@@ -0,0 +1,10 @@
+export function summarizeLayout(boxes, viewport) {
+    const outside = (box) => box.x + box.width <= 0 || box.y + box.height <= 0 || box.x >= viewport.width || box.y >= viewport.height;
+    return {
+        nodeCount: boxes.length,
+        overflowing: boxes.filter(box => box.overflowX || box.overflowY).map(box => box.elementId),
+        outsideViewport: boxes.filter(box => box.width > 0 && box.height > 0 && outside(box)).map(box => box.elementId),
+        zeroSized: boxes.filter(box => box.width === 0 || box.height === 0).map(box => box.elementId),
+        truncated: boxes.length >= 500
+    };
+}

package/dist/knowledge/localization.js

@@ -0,0 +1,51 @@
+import { RefResolveError } from '../platform/refs.js';
+/**
+ * FK slug'ı TAHMİN EDİLMEZ: rehber "satırı elle kurmadan önce mutlaka entity_get ile doğrula"
+ * diyor, gateway de aynısını yapar — companion'ın alanları arasında `relationId` ana entity'ye
+ * işaret edeni arar. Eşleşme yoksa uydurulmuş bir slug'la yanlış satır yazmaktansa hata verilir.
+ */
+export async function findLocalizationCompanion(resolver, main) {
+    const companionSlug = `${main.slug}_localization`;
+    // Bağ ÖNCE id'den okunur: ad kalıbı ('{slug}_localization') platformun ürettiği kolaylıktır,
+    // sözleşme değil — companion yeniden adlandırılırsa slug yolu "companion yok" der ve ajan var
+    // olan bir entity'yi yeniden kurmaya çalışır. `localizationEntityId` entity'nin kendi alanıdır
+    // (b-03) ve entity_get onu döndürür; eski platform sürümünde boş gelir, o zaman slug yoluna
+    // düşülür.
+    const linkedId = await resolver.entityRecord(main)
+        .then(record => {
+        const value = record.localizationEntityId;
+        return typeof value === 'string' && value.length > 0 ? value : undefined;
+    })
+        .catch(() => undefined);
+    const companion = await (linkedId ? resolver.entity(linkedId) : Promise.reject(new RefResolveError('link yok')))
+        .catch(() => resolver.entity(companionSlug))
+        .catch((error) => {
+        // YALNIZ "yok" hâli dostane mesaja çevrilir; belirsizlik / HTTP / yetki hataları olduğu gibi
+        // geçer — hepsini "companion yok" diye yutmak ajana var olan bir entity'yi kurdurur.
+        if (error instanceof RefResolveError && /diye bir entity yok/.test(error.message)) {
+            throw new RefResolveError(`'${main.slug}' için companion entity yok — entity'de isLocalized alan yok ya da companion henüz kurulmadı (ne 'localizationEntityId' bağı ne de '${companionSlug}' adı bulundu). platform_guide('entity') §'Çoklu dilli alan'.`);
+        }
+        throw error;
+    });
+    const fields = await resolver.entityFields(companion);
+    const candidates = fields.filter(field => field.relationType !== 'none' && field.relationId === main.entityId);
+    const [fk] = candidates;
+    if (!fk) {
+        throw new RefResolveError(`'${companionSlug}' içinde relationId '${main.entityId}' olan bir ilişki alanı yok; FK tahmin edilmez. Alanlar: ${fields.map(field => field.slug).join(', ')}`);
+    }
+    if (candidates.length > 1) {
+        throw new RefResolveError(`'${companionSlug}' içinde '${main.slug}'a işaret eden birden çok ilişki alanı var (${candidates.map(field => field.slug).join(', ')}); hangisinin FK olduğu tahmin edilmez — dil satırlarını row_create ile elle yazın.`);
+    }
+    return { entityId: companion.entityId, datasourceId: companion.datasourceId, slug: companion.slug, fkSlug: fk.slug, languageSlug: 'language' };
+}
+export function localizationRows(companion, mainRowId, localizations) {
+    return Object.entries(localizations).map(([language, values]) => ({ [companion.fkSlug]: mainRowId, [companion.languageSlug]: language, ...values }));
+}
+/**
+ * Platform tanımadığı gövde alanını SESSİZCE düşürür; `X-Unmapped-Members` üretim dışı ortamda
+ * ilk tanınmayan alanın JSON yolunu döner. `localizations` orada görünüyorsa platform b-07 öncesi
+ * sürümdedir ve dil satırları hiç yazılmamıştır — gateway o zaman companion'a kendisi yazar.
+ */
+export function platformIgnoredLocalizations(headers) {
+    return (headers['x-unmapped-members'] ?? '').split(/[.,\s]+/).some(segment => segment.toLowerCase() === 'localizations');
+}