@appaflytech/zeyrek-ai-mcp 0.0.30 → 0.0.32

package/dist/tools/modules.js

@@ -1,48 +0,0 @@
-import { guid, projectParam, environmentParam, readOnly, writes } from './common.js';
-import { PolicyBlockError } from '../knowledge/policy.js';
-import { handle } from '../platform/responses.js';
-import { z } from 'zod';
-export function registerModuleTools(server, platform) {
-    const config = platform.config;
-    server.registerTool('module_list', {
-        title: 'Sistem modüllerini listele',
-        description: "Kurulabilir sistem modülleri (catalog: slug, name, version, requires) ve bu ortamdaki kurulumlar (installations: module, version, catalogVersion, applicationId, receiveUpdates, isOutdated). Katalogda iki modül var: access (yetki modülü, kompleks proje ister) ve bpm-management (süreç yönetimi: süreç sayfaları ve iş takvimi). requires dolu bir modül, gerektirdiği modül aynı application'a kurulmadan kurulamaz.",
-        inputSchema: {
-            project: projectParam,
-            environment: environmentParam,
-            module: z.string().min(1).max(100).optional().describe('Yalnız bu modülün kurulumları')
-        },
-        annotations: readOnly
-    }, handle(config, async ({ project, environment, module }) => {
-        const [catalog, installations] = await Promise.all([
-            platform.tenant('GET', project, '/modules/catalog', { environment }),
-            platform.tenant('GET', project, '/modules', { environment, query: module ? { module } : undefined })
-        ]);
-        return {
-            catalog: catalog?.data ?? catalog,
-            installations: installations?.data ?? installations
-        };
-    }));
-    server.registerTool('module_update', {
-        title: 'Sistem modülünü kur, güncelle ya da ayır',
-        description: "operation install: modülü application'a kurar — süreç paketi tablolarını (yoksa), iş takvimlerini ve süreç tanımlarını getirir, süreçler o application'da aktif yayınlanır; gereken modül kurulu değilse 409 ModuleRequiresModule, ikinci kurulum 409 ModuleAlreadyInstalled. operation upgrade: katalog sürümü yeniyse içeriği yeniden kurar; değişen süreç yeni sürüm olarak yayınlanır ve müşterinin uyarlaması yeni sürüme taşınır (taşınamayan adım çakışma bildirimi olur). Var olan tablo ve verisine dokunulmaz — yeni paket sürümünün bir tabloya eklediği alan var olan tabloya eklenmez. operation detach: güncellemeleri keser, içerik ve çalışan örnekler yerinde kalır; ayırma geri alınmaz (ardından install 409 ModuleAlreadyInstalled, upgrade 400 döner). access modülünün kurulumu yalnız kaydı tutar, içerik getirmez (TB-92). production'a kurulum gateway'de durur (BPM-014): development'ta kurup deployment ile taşıyın.",
-        inputSchema: {
-            project: projectParam,
-            environment: environmentParam,
-            operation: z.enum(['install', 'upgrade', 'detach']),
-            module: z.string().min(1).max(100),
-            applicationId: guid
-        },
-        annotations: writes
-    }, handle(config, async ({ project, environment, operation, module, applicationId }) => {
-        if ((environment ?? config.defaultEnvironment) === 'production') {
-            throw new PolicyBlockError([{
-                    ruleId: 'BPM-014',
-                    severity: 'block',
-                    message: `module_update: modül ${operation} production'a gönderilmez. Modülü development'ta kurun; production'a taşıma insan onaylı deployment işidir (tanım ve takvim taşınır, uyarlama taşınmaz).`,
-                    guide: 'ngapps://guides/bpm'
-                }], false);
-        }
-        return platform.tenant('POST', project, `/modules/${encodeURIComponent(module)}/${operation}`, { environment, body: { applicationId } });
-    }));
-}

package/dist/tools/organizationStructure.js

@@ -1,137 +0,0 @@
-import { guid, projectParam, environmentParam, readOnly, writes, updates, destructive } from './common.js';
-import { evaluatePolicy, enforcePolicy } from '../knowledge/policy.js';
-import { handle } from '../platform/responses.js';
-import { policyRules } from '../knowledge/rules.js';
-import { z } from 'zod';
-const unitTypes = ['holding', 'company', 'branch', 'region', 'department', 'team', 'other'];
-const subscribedNote = "Bu proje organizasyon şemasına ABONEYSE (project_get organizationSchema.receiveUpdates) birim/pozisyon ağacı şemadan gelir ve buradan yazmak projeyi 'özelleştirilmiş' işaretler: sonraki yayın artık otomatik inmez, organization_schema_resubscribe gerekir. Şema kaynaklı bir düğümü düzenlemek yerine yönetim konsolundaki şemayı düzenleyin.";
-export function registerOrganizationStructureTools(server, platform) {
-    const config = platform.config;
-    server.registerTool('organization_tree_get', {
-        title: 'Organizasyon ağacını getir',
-        description: "Projenin KENDİ birim/pozisyon ağacını getirir (GET /{project}/organization/tree) — kompleks projede erişim kapsamlarının (unit · subtree · subordinates) dayandığı ağaç budur. Organizasyonun merkezi şeması organization_schema_get'tedir; bu uç projeye kopyalanmış ve projede yaşayan halini verir. Yanıttaki seats listesi pozisyonlarda BUGÜN oturanları (positionId · userId · fullName · assignmentType · isPrimary) verir — boş koltuk ve 'bu koltukta kim var' sorusu kullanıcı kullanıcı user_position_list çağırmadan buradan cevaplanır. Düz satırlar için row_list('organization_units' / 'organization_positions').",
-        inputSchema: { project: projectParam, environment: environmentParam, includeInactive: z.boolean().optional().describe('Pasifleştirilmiş birim/pozisyonlar da dönsün mü (varsayılan false)') },
-        annotations: readOnly
-    }, handle(config, ({ project, environment, includeInactive }) => platform.tenant('GET', project, '/organization/tree', { environment, query: includeInactive === undefined ? {} : { includeInactive } })));
-    server.registerTool('organization_unit_create', {
-        title: 'Organizasyon birimi oluştur',
-        description: `Projede birim açar (POST /{project}/organization/units). parentId verilmezse kök birim olur; unitType 'company' olan birim kapsam hesabında ŞİRKET sınırıdır (companyIds). functionCode bir işlev etiketi ('it', 'finance') ve grant koşullarında { subject: 'functionCodes' } ile eşleşir. managerPositionId birimin yöneticisini işaret eder — 'subordinates' kapsamı bu hattan yürür. ${subscribedNote}`,
-        inputSchema: {
-            project: projectParam,
-            environment: environmentParam,
-            name: z.string().min(1),
-            code: z.string().min(1).describe('Projede tekil kısa kod'),
-            unitType: z.enum(unitTypes),
-            parentId: guid.optional().describe("Üst birimin id'si; verilmezse kök"),
-            functionCode: z.string().optional().describe("İşlev etiketi; grant koşulunda { subject: 'functionCodes' } ile eşleşir"),
-            managerPositionId: guid.optional(),
-            sortOrder: z.number().int().optional()
-        },
-        annotations: writes
-    }, handle(config, ({ project, environment, ...body }) => platform.tenant('POST', project, '/organization/units', { environment, body })));
-    server.registerTool('organization_unit_update', {
-        title: 'Organizasyon birimini güncelle',
-        description: `Birimin alanlarını değiştirir (PUT /{project}/organization/units/{id}) — TAM gövde gönderilir, verilmeyen alan boşaltılır; önce organization_tree_get ile mevcut değerleri okuyun. Birimi BAŞKA BİR ÜST BİRİME TAŞIMAZ (parentId burada yoktur): taşıma ayrı bir uçtur. ${subscribedNote}`,
-        inputSchema: {
-            project: projectParam,
-            environment: environmentParam,
-            id: guid,
-            name: z.string().min(1),
-            code: z.string().min(1),
-            unitType: z.enum(unitTypes),
-            functionCode: z.string().optional(),
-            managerPositionId: guid.optional(),
-            sortOrder: z.number().int().optional()
-        },
-        annotations: updates
-    }, handle(config, ({ project, environment, id, ...body }) => platform.tenant('PUT', project, `/organization/units/${id}`, { environment, body })));
-    server.registerTool('organization_position_create', {
-        title: 'Organizasyon pozisyonu oluştur',
-        description: `Bir birime pozisyon açar (POST /{project}/organization/positions). Pozisyon ROLE bağlıdır (roleId — role_list) ve kullanıcının rolü pozisyonundan gelir. parentPositionId idari hattı, functionalParentPositionId işlevsel hattı kurar; 'subordinates' kapsamı grant'teki subordinatesLine ile bu iki hattan birini (ya da ikisini) yürür. ${subscribedNote}`,
-        inputSchema: {
-            project: projectParam,
-            environment: environmentParam,
-            unitId: guid.describe("Pozisyonun bağlı olduğu birim (organization_tree_get)"),
-            roleId: guid.describe("Rolün id'si (role_list)"),
-            name: z.string().min(1),
-            code: z.string().min(1).describe('Projede tekil kısa kod'),
-            parentPositionId: guid.optional().describe('İdari üst pozisyon'),
-            functionalParentPositionId: guid.optional().describe('İşlevsel üst pozisyon'),
-            isMultiSeat: z.boolean().optional().describe("Varsayılan false: koltukta aynı anda tek KALICI kişi oturur, ikinci kalıcı atama 409 OrganizationPositionSeatOccupied alır. true ise koltuk sınırı yok. Vekâlet için bayrağa gerek yok — assignmentType: 'acting' sınıra hiç girmez (TB-96)")
-        },
-        annotations: writes
-    }, handle(config, ({ project, environment, ...body }) => platform.tenant('POST', project, '/organization/positions', { environment, body })));
-    server.registerTool('organization_position_update', {
-        title: 'Organizasyon pozisyonunu güncelle',
-        description: `Pozisyonun alanlarını değiştirir (PUT /{project}/organization/positions/{id}) — TAM gövde gönderilir, verilmeyen alan boşaltılır: isMultiSeat verilmezse false gider ve açık bayrak kapanır. Rolü değiştirmek o pozisyondaki HER KULLANICININ yetkisini değiştirir. ${subscribedNote}`,
-        inputSchema: {
-            project: projectParam,
-            environment: environmentParam,
-            id: guid,
-            unitId: guid,
-            roleId: guid,
-            name: z.string().min(1),
-            code: z.string().min(1),
-            parentPositionId: guid.optional(),
-            functionalParentPositionId: guid.optional(),
-            isMultiSeat: z.boolean().optional().describe("Varsayılan false: koltukta aynı anda tek KALICI kişi oturur, ikinci kalıcı atama 409 OrganizationPositionSeatOccupied alır. true ise koltuk sınırı yok. Vekâlet için bayrağa gerek yok — assignmentType: 'acting' sınıra hiç girmez (TB-96)")
-        },
-        annotations: updates
-    }, handle(config, ({ project, environment, id, ...body }) => platform.tenant('PUT', project, `/organization/positions/${id}`, { environment, body })));
-    server.registerTool('organization_unit_deactivate', {
-        title: 'Organizasyon birimini pasifleştir',
-        description: `Birimi pasifleştirir (POST /{project}/organization/units/{id}/deactivate) — SİLMEZ: düğüm ağaçta kalır, isActive false olur ve organization_tree_get onu ancak includeInactive: true ile gösterir. Kapanan şube / kapatılan departman bu uçla kapatılır. DOLU bir düğüm kapanmaz: altında aktif birim, aktif pozisyon ya da o pozisyonda oturan kullanıcı varsa 400 OrganizationStructureNodeInUse döner — önce koltukları boşaltın (user_position_replace) ve alt birimleri kapatın. Pasifleştirme satırlara DOKUNMAZ: kayıtların sys_owner_unit_id'si o birimi göstermeye devam eder ve kapanış tablosu da değişmez, yani ata birimi kapsayan (unit-tree · company-tree) çağıranlar onları görmeye devam eder; yalnız kapsamı tam o birim (unit) olanlar kaybeder. Kayıtları gerçekten taşımak için row_reassign. Geri almak için organization_unit_activate. ${subscribedNote}`,
-        inputSchema: { project: projectParam, environment: environmentParam, id: guid.describe("Birimin id'si (organization_tree_get)") },
-        annotations: destructive
-    }, handle(config, ({ project, environment, id }) => platform.tenant('POST', project, `/organization/units/${id}/deactivate`, { environment })));
-    server.registerTool('organization_position_deactivate', {
-        title: 'Organizasyon pozisyonunu pasifleştir',
-        description: `Pozisyonu (koltuğu) pasifleştirir (POST /{project}/organization/positions/{id}/deactivate) — SİLMEZ: isActive false olur ve organization_tree_get onu ancak includeInactive: true ile gösterir. Fesih adımının doğru ucu budur. DOLU koltuk kapanmaz: 400 OrganizationStructureNodeInUse ÜÇ sebepten gelebilir — koltukta oturan kullanıcı, bu pozisyona bağlı (idari ya da işlevsel) başka bir aktif pozisyon, ya da pozisyonu managerPositionId olarak gösteren bir birim. Sırayla: user_position_replace ile atamayı kaldırın, ast pozisyonları kapatın, yöneticiyi gösteren birimi organization_unit_update ile managerPositionId'siz yazın. Pasif pozisyon kapsam hesabına girmez: o koltuktan gelen birim/şirket bağı biter, kullanıcının başka pozisyonu yoksa hiçbir kapsamlı grant'e uymaz. Geri almak için organization_position_activate. ${subscribedNote}`,
-        inputSchema: { project: projectParam, environment: environmentParam, id: guid.describe("Pozisyonun id'si (organization_tree_get)") },
-        annotations: destructive
-    }, handle(config, ({ project, environment, id }) => platform.tenant('POST', project, `/organization/positions/${id}/deactivate`, { environment })));
-    server.registerTool('organization_unit_activate', {
-        title: 'Organizasyon birimini etkinleştir',
-        description: `Pasifleştirilmiş birimi geri açar (POST /{project}/organization/units/{id}/activate) — organization_unit_deactivate'in tersidir ve arşivlemeyi TEK YÖNLÜ olmaktan çıkarır (TB-112). Düğüm hiç silinmediği için id, kod ve alt ağaç korunur; isActive true olur ve birim organization_tree_get'te includeInactive olmadan da görünür. ÜST BİRİM PASİFSE açılmaz: 400 OrganizationStructureParentInactive döner — kökten yaprağa doğru ilerleyin, önce üst birimi etkinleştirin. Pasifleştirme satırlara dokunmadığı için geri açmak da dokunmaz: kapsam hesabı birim yeniden aktifleştiği anda o birimi gören çağıranlara geri döner. ${subscribedNote}`,
-        inputSchema: { project: projectParam, environment: environmentParam, id: guid.describe("Birimin id'si (organization_tree_get includeInactive: true)") },
-        annotations: updates
-    }, handle(config, ({ project, environment, id }) => platform.tenant('POST', project, `/organization/units/${id}/activate`, { environment })));
-    server.registerTool('organization_position_activate', {
-        title: 'Organizasyon pozisyonunu etkinleştir',
-        description: `Pasifleştirilmiş pozisyonu (koltuğu) geri açar (POST /{project}/organization/positions/{id}/activate) — organization_position_deactivate'in tersidir (TB-112). isActive true olur; koltuk BOŞ açılır, eski atama geri gelmez — kullanıcıyı user_position_replace ile yeniden oturtun. ÜST DÜĞÜM PASİFSE açılmaz: 400 OrganizationStructureParentInactive üç sebepten gelebilir — pozisyonun birimi pasif, idari üst pozisyonu pasif, ya da işlevsel üst pozisyonu pasif. Sırayla: önce birimi (organization_unit_activate), sonra üst pozisyonu açın. ${subscribedNote}`,
-        inputSchema: { project: projectParam, environment: environmentParam, id: guid.describe("Pozisyonun id'si (organization_tree_get includeInactive: true)") },
-        annotations: updates
-    }, handle(config, ({ project, environment, id }) => platform.tenant('POST', project, `/organization/positions/${id}/activate`, { environment })));
-    server.registerTool('user_position_list', {
-        title: 'Kullanıcının pozisyonlarını listele',
-        description: "Bir uygulama kullanıcısının pozisyonlarını listeler (GET /{project}/organization/users/{userId}/positions). Kompleks projede kullanıcının rolü, birimi ve şirketi BURADAN gelir: pozisyonu olmayan kullanıcı hiçbir kapsamlı grant'e uymaz ve her şeyden reddedilir — 'neden göremiyor?' sorusunda bakılacak ilk yer burasıdır (access_preview'dan önce).",
-        inputSchema: { project: projectParam, environment: environmentParam, userId: guid.describe("Kullanıcı id'si (user_list)") },
-        annotations: readOnly
-    }, handle(config, async ({ project, environment, userId }) => {
-        const payload = await platform.tenant('GET', project, `/organization/users/${userId}/positions`, { environment });
-        const count = Array.isArray(payload?.data) ? payload.data.length : 0;
-        return count > 0
-            ? payload
-            : { ...payload, note: "Kullanıcının hiç pozisyonu yok: kompleks projede bu kullanıcı rolsüz/birimsizdir ve kapsamlı hiçbir grant'e uymaz. user_position_replace ile pozisyon verin." };
-    }));
-    server.registerTool('user_position_replace', {
-        title: "Kullanıcının pozisyonlarını değiştir",
-        description: "Bir kullanıcının pozisyon atamalarının TAMAMINI verilen listeyle değiştirir (PUT /{project}/organization/users/{userId}/positions): listede olmayan mevcut atama SİLİNİR, boş liste kullanıcıyı pozisyonsuz bırakır. Eklemek için önce user_position_list ile mevcut listeyi okuyup üzerine ekleyin. Değişiklik kullanıcının erişim sürümünü artırır: açık oturumların yetkisi bir sonraki kararda yeniden hesaplanır.",
-        inputSchema: {
-            project: projectParam,
-            environment: environmentParam,
-            userId: guid,
-            positions: z.array(z.object({
-                positionId: guid,
-                isPrimary: z.boolean().optional().describe('Birincil atama (varsayılan false)'),
-                assignmentType: z.enum(['permanent', 'acting']).optional().describe("'acting' vekâleten; varsayılan 'permanent'"),
-                startsAt: z.string().optional().describe('ISO tarih'),
-                endsAt: z.string().optional().describe('ISO tarih')
-            })).describe('Atama listesinin TAMAMI; boş dizi bütün atamaları siler')
-        },
-        annotations: updates
-    }, handle(config, ({ project, environment, userId, positions }) => {
-        enforcePolicy(evaluatePolicy(config, policyRules, 'userPosition', { positions }, { operation: 'update' }), false);
-        return platform.tenant('PUT', project, `/organization/users/${userId}/positions`, { environment, body: { positions } });
-    }));
-}

package/dist/tools/profileWrite.js

@@ -1,92 +0,0 @@
-import { findingLines, profileFindings, stateStorageFindings } from '../knowledge/platform/lint.js';
-import { describeShell, mobileLayoutFindings, newFindings } from '../knowledge/platform/mobileLayoutLint.js';
-import { resolveProfile } from '../knowledge/platform/resolve.js';
-import { fetchCatalogSlugs } from './components.js';
-import { flowPath } from './screens.js';
-/**
- * Sayfa/layout/widget yazma yollarının profil kapısı: mobil profilde `MOB-*` bulgularını
- * `layoutWarnings[]` satırı olarak döner. Web profilinde HİÇBİR istek atmaz ve boş dizi döner —
- * web yanıtı profil öncesiyle aynı kalır (G1 golden).
- */
-export async function screenProfileWarnings(platform, resolved, project, environment, applicationId, input) {
-    if (resolved.profile.platform === 'web')
-        return [];
-    const catalog = await fetchCatalogSlugs(platform, project, environment, applicationId).catch(() => undefined);
-    // Tam kabuk ağacı yazan layout yolları (create/update/patch) mizanpaj iskeletini de denetler (MOB-015…018).
-    const layoutTree = resolved.profile.platform === 'mobile' && input.kind === 'layout' && input.nodes !== undefined
-        ? mobileLayoutFindings({ kind: 'layout', tree: input.nodes })
-        : [];
-    return findingLines([...profileFindings(resolved.profile, { ...input, ...(catalog ? { catalog } : {}) }), ...layoutTree]);
-}
-/**
- * Sayfa yazımının mizanpaj iskeleti (MOB-015…018): sayfanın kabuğu okunur, çünkü üst pay ve app-bar kabukla
- * birlikte karar verilir. `before` verilirse (yama) yalnız yazımın getirdiği bulgular döner. Web profilinde
- * istek atmaz; kabuk okunamazsa kabuğa bağlı kurallar koşmaz ve bilgi satırı döner.
- */
-export async function pageLayoutWarnings(platform, resolved, project, environment, applicationId, input) {
-    if (resolved.profile.platform !== 'mobile')
-        return [];
-    const shell = await pageShell(platform, project, environment, applicationId, input.layoutId);
-    const after = mobileLayoutFindings({ kind: 'page', tree: input.tree, shell });
-    return findingLines(input.before === undefined ? after : newFindings(mobileLayoutFindings({ kind: 'page', tree: input.before, shell }), after));
-}
-/** Kabuk yamasının getirdiği iskelet bulguları (`layout_schema_patch`); web profilinde boş. */
-export function layoutPatchWarnings(resolved, before, after) {
-    if (resolved.profile.platform !== 'mobile')
-        return [];
-    return findingLines(newFindings(mobileLayoutFindings({ kind: 'layout', tree: before }), mobileLayoutFindings({ kind: 'layout', tree: after })));
-}
-async function pageShell(platform, project, environment, applicationId, layoutId) {
-    if (typeof layoutId !== 'string' || layoutId === '')
-        return { kind: 'none' };
-    try {
-        const response = await platform.tenant('GET', project, `/layouts/${applicationId}/${layoutId}`, { environment });
-        return Array.isArray(response?.data?.views) ? describeShell(response.data.views) : { kind: 'unknown' };
-    }
-    catch {
-        return { kind: 'unknown' };
-    }
-}
-/**
- * `set_event` ile bağlanan akışların adımları (MOB-005). Akış gövdeleri şemada değil ayrı uçtadır;
- * okunamazsa bulgu üretilmez, yazım yine geçer.
- */
-export async function boundFlowSteps(platform, resolved, project, environment, host, applicationId, hostId, ops) {
-    if (resolved.profile.platform === 'web')
-        return [];
-    const flowIds = new Set(ops.filter(entry => entry.op === 'set_event').map(entry => String(entry.eventValue ?? '')).filter(id => id.length > 0));
-    if (flowIds.size === 0)
-        return [];
-    try {
-        const hosted = await platform.tenant('GET', project, flowPath(host, applicationId, hostId), { environment });
-        return (hosted?.data ?? [])
-            .filter(flow => flowIds.has(String(flow.id ?? '')))
-            .flatMap(flow => [...(Array.isArray(flow.steps) ? flow.steps : []), ...(Array.isArray(flow.errorSteps) ? flow.errorSteps : [])]);
-    }
-    catch {
-        return [];
-    }
-}
-/**
- * Akış yazma yollarının profil kapısı (MOB-005): mobil uygulamada `download`/`setcookie` adımının
- * davranış farkını `platformWarnings`'e yazar. Web profilinde istek atmaz, boş döner.
- */
-/**
- * Değişken yazma yollarının profil kapısı (MOB-014). Yazılan set saklama türü taşımıyorsa uygulama
- * tipi ÇÖZÜLMEZ — ek istek atılmaz, yanıt profil öncesiyle aynı kalır. Tip çözülemediyse (uygulama
- * okunamadı) bulgu üretilmez: gateway bilmediği platform için "uygulanmıyor" demez.
- */
-export async function variableProfileWarnings(platform, applicationId, entries) {
-    if (!entries.some(entry => entry.storage !== undefined))
-        return [];
-    const resolved = await resolveProfile(platform, applicationId);
-    if (!resolved.known)
-        return [];
-    return findingLines(stateStorageFindings(resolved.profile, entries));
-}
-export async function flowProfileWarnings(platform, applicationId, steps) {
-    const resolved = await resolveProfile(platform, applicationId);
-    if (resolved.profile.platform === 'web')
-        return [];
-    return findingLines(profileFindings(resolved.profile, { kind: 'page', steps }));
-}