@appaflytech/zeyrek-ai-mcp 0.0.1

package/dist/knowledge/outlines.js

@@ -0,0 +1,167 @@
+function asArray(value) {
+    return Array.isArray(value) ? value.filter((entry) => Boolean(entry) && typeof entry === 'object') : [];
+}
+export function workflowOutline(definition) {
+    return {
+        id: definition.id,
+        slug: definition.slug,
+        name: definition.name,
+        type: definition.type,
+        parameterDtoId: definition.parameterDtoId ?? null,
+        returnDtoId: definition.returnDtoId ?? null,
+        stepCount: asArray(definition.steps).length,
+        steps: asArray(definition.steps).map(step => ({
+            id: step.id,
+            name: step.name,
+            type: step.type,
+            branches: asArray(step.branches).map(branch => ({
+                name: branch.name,
+                type: branch.type,
+                nextStepId: branch.nextStepId ?? null
+            }))
+        })),
+        view: 'outline',
+        hint: "Bir step'in tam gövdesi için view:'part', part:'steps[id=<stepId>]' kullanın; değişiklik için workflow_patch."
+    };
+}
+export function microserviceOutline(definition) {
+    const sourceParameters = (definition.sourceParameters ?? {});
+    return {
+        id: definition.id,
+        slug: definition.slug,
+        name: definition.name,
+        type: definition.type,
+        httpMethod: definition.httpMethod,
+        source: definition.source,
+        url: definition.url,
+        workflowId: definition.workflowId ?? null,
+        queryId: definition.queryId ?? null,
+        sourceParameters: {
+            operation: sourceParameters.operation,
+            entityId: sourceParameters.entityId,
+            isSingle: sourceParameters.isSingle,
+            selectFieldCount: asArray(sourceParameters.selectFields).length,
+            selectFieldSlugs: asArray(sourceParameters.selectFields).map(field => field.fieldSlug ?? field.fieldId),
+            joinCount: asArray(sourceParameters.joins).length,
+            joinPaths: asArray(sourceParameters.joins).map(join => join.path ?? join.alias),
+            filterCount: asArray(sourceParameters.filters).length
+        },
+        view: 'outline',
+        hint: "Parça için view:'part', part:'sourceParameters.joins' gibi; değişiklik için microservice_patch."
+    };
+}
+export function entityOutline(definition) {
+    return {
+        id: definition.id,
+        slug: definition.slug,
+        name: definition.name,
+        datasourceId: definition.datasourceId,
+        fieldCount: asArray(definition.fields).length,
+        fields: asArray(definition.fields).map(field => ({
+            id: field.id,
+            name: field.name,
+            slug: field.slug,
+            dbType: field.dbType,
+            nullable: field.nullable,
+            relationType: field.relationType ?? 'none',
+            relationId: field.relationId ?? null
+        })),
+        view: 'outline',
+        hint: "Bir alanın tam gövdesi için view:'part', part:'fields[slug=<slug>]'; değişiklik için entity_patch."
+    };
+}
+const segmentPattern = /^(\w+)(?:\[(?:(\d+)|(\w+)=([^\]]+))\])?$/;
+export function resolvePart(definition, part) {
+    let current = definition;
+    for (const segment of part.split('.')) {
+        const match = segmentPattern.exec(segment.trim());
+        if (!match || !current || typeof current !== 'object') {
+            throw new Error(`part yolu çözülemedi: '${segment}'. Desteklenen biçimler: alanAdi, dizi[3], dizi[id=abc], dizi[slug=email]; segmentler '.' ile bağlanır.`);
+        }
+        const [, key, index, matchField, matchValue] = match;
+        current = current[key];
+        if (index !== undefined) {
+            current = Array.isArray(current) ? current[Number(index)] : undefined;
+        }
+        else if (matchField !== undefined) {
+            current = Array.isArray(current)
+                ? current.find(entry => entry && typeof entry === 'object' && String(entry[matchField]) === matchValue)
+                : undefined;
+        }
+        if (current === undefined) {
+            throw new Error(`'${segment}' bulunamadı. Önce view:'outline' ile mevcut id/slug değerlerini görün.`);
+        }
+    }
+    return current;
+}
+const selectorSegment = /^([^/\[\]]+)\[(\w+)=([^\]]+)\]$/;
+function unescapePointer(segment) {
+    return segment.replace(/~1/g, '/').replace(/~0/g, '~');
+}
+/**
+ * SAKLANAN `steps` dizisinin sırası, create'e GÖNDERİLEN sıra değildir — `/steps/5/...` gibi
+ * indeks yolları bu yüzden başka adımı yazıp `applied: N` ile başarı raporlar (crm koşumu B-4).
+ * `*_get`'in `part` sözdizimindeki seçiciyi (`steps[id=…]`, `fields[slug=…]`) patch yollarında da
+ * kabul edip indekse çeviriyoruz; çözülemeyen seçici, gövde platforma GİTMEDEN hata verir.
+ */
+export function resolvePatchPointer(document, path) {
+    if (!path.startsWith('/'))
+        throw new Error(`JSON Patch yolu '/' ile başlamalı: '${path}'`);
+    const segments = path.split('/').slice(1);
+    const resolved = [];
+    let current = document;
+    let rewritten = false;
+    for (const segment of segments) {
+        const match = selectorSegment.exec(segment);
+        if (!match) {
+            const key = unescapePointer(segment);
+            resolved.push(segment);
+            current = key === '-' || !current || typeof current !== 'object'
+                ? undefined
+                : Array.isArray(current) ? current[Number(key)] : current[key];
+            continue;
+        }
+        const [, key, field, value] = match;
+        const collection = current && typeof current === 'object' ? current[key] : undefined;
+        if (!Array.isArray(collection)) {
+            throw new Error(`Patch yolu çözülemedi: '${path}' — '${key}' bir dizi değil. Mevcut yapıyı workflow_get view:'outline' ile okuyun.`);
+        }
+        const index = collection.findIndex(entry => entry && typeof entry === 'object' && String(entry[field]) === value);
+        if (index === -1) {
+            throw new Error(`Patch yolu çözülemedi: '${path}' — '${key}' dizisinde ${field}='${value}' yok. Mevcut id/ad değerlerini workflow_get view:'outline' ile okuyun.`);
+        }
+        resolved.push(key, String(index));
+        current = collection[index];
+        rewritten = true;
+    }
+    const resolvedPath = `/${resolved.join('/')}`;
+    return rewritten ? { path: resolvedPath, note: `${path} → ${resolvedPath}` } : { path: resolvedPath };
+}
+/**
+ * Yanıtın `applied: N` demekle yetinmemesi için: her op'un hangi step'e indiğini adıyla söyler.
+ */
+export function describePatchTarget(document, path) {
+    const match = /^\/steps\/(\d+)(\/.*)?$/.exec(path);
+    if (!match)
+        return path;
+    const step = asArray(document.steps)[Number(match[1])];
+    return step
+        ? `${path} → '${String(step.name ?? step.id ?? '?')}' (${String(step.type ?? '?')}, id ${String(step.id ?? '?')})`
+        : `${path} → (dizide ${match[1]}. eleman YOK)`;
+}
+export function resolvePatchOperations(document, operations) {
+    const notes = [];
+    const targets = [];
+    const resolved = operations.map(operation => {
+        const path = typeof operation.path === 'string' ? operation.path : '';
+        const outcome = resolvePatchPointer(document, path);
+        const from = typeof operation.from === 'string' ? resolvePatchPointer(document, operation.from) : undefined;
+        if (outcome.note)
+            notes.push(outcome.note);
+        if (from?.note)
+            notes.push(from.note);
+        targets.push(describePatchTarget(document, outcome.path));
+        return from ? { ...operation, path: outcome.path, from: from.path } : { ...operation, path: outcome.path };
+    });
+    return { operations: resolved, notes, targets };
+}

package/dist/knowledge/policy.js

@@ -0,0 +1,44 @@
+import { logStep } from '../observability/trace.js';
+export class PolicyBlockError extends Error {
+    findings;
+    constructor(findings) {
+        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."
+        ].join('\n'));
+        this.findings = findings;
+        this.name = 'PolicyBlockError';
+    }
+}
+export function evaluatePolicy(config, rules, module, definition, context, policyOverride = false) {
+    if (config.policyMode === 'off') {
+        logStep('politika', `${module}/${context.operation} · POLICY=off — lint çalıştırılmadı`);
+        return [];
+    }
+    const applicable = rules.filter(rule => rule.module === module && rule.appliesTo.includes(context.operation));
+    const raw = applicable.flatMap(rule => rule.check(definition, context));
+    const findings = config.policyMode === 'warn' || policyOverride
+        ? raw.map(finding => finding.severity === 'block'
+            ? { ...finding, severity: 'warn', message: `${finding.message} [block → warn: ${policyOverride ? 'policyOverride' : 'POLICY=warn'}]` }
+            : finding)
+        : raw;
+    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) {
+    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);
+    }
+    return findings;
+}
+export function attachFindings(payload, findings) {
+    if (findings.length === 0)
+        return payload;
+    if (payload && typeof payload === 'object' && !Array.isArray(payload)) {
+        return { ...payload, policyFindings: findings };
+    }
+    return { data: payload, policyFindings: findings };
+}

package/dist/knowledge/reservedTables.js

@@ -0,0 +1,75 @@
+export const reservedTenantTables = [
+    'applications',
+    'audit_trail_values',
+    'audit_trails',
+    'branches',
+    'caches',
+    'component_definition_blocks',
+    'component_definition_events',
+    'component_definition_properties',
+    'component_definition_property_options',
+    'component_definition_validations',
+    'components',
+    'data_transfer_objects',
+    'datasources',
+    'design_component_blocks',
+    'design_component_events',
+    'design_component_properties',
+    'design_component_state_binding_targets',
+    'design_component_state_bindings',
+    'design_component_validations',
+    'design_components',
+    'entities',
+    'entity_applications',
+    'entity_increment_sequences',
+    'entity_index_fields',
+    'entity_indexes',
+    'entity_page_setting_fields',
+    'entity_page_setting_items',
+    'entity_page_settings',
+    'entity_transfer_rows',
+    'fields',
+    'files',
+    'flows',
+    'folder_middlewares',
+    'folder_roles',
+    'folders',
+    'layout_events',
+    'layouts',
+    'microservice_middlewares',
+    'microservice_roles',
+    'microservices',
+    'ms_source_entities',
+    'ms_source_entity_fields',
+    'ms_source_entity_filters',
+    'ms_source_entity_joins',
+    'ms_source_entity_limits',
+    'ms_source_entity_sorts',
+    'ms_type_options',
+    'page_events',
+    'page_middlewares',
+    'page_roles',
+    'pages',
+    'permissions',
+    'projects',
+    'queries',
+    'queued_events',
+    'role_permissions',
+    'roles',
+    'step_rule_condition_rules',
+    'step_rules',
+    'steps',
+    'ui_flow_step_argument_iterates',
+    'ui_flow_step_argument_parameters',
+    'ui_flow_step_argument_rules',
+    'ui_flow_step_arguments',
+    'ui_flow_step_branches',
+    'ui_flow_steps',
+    'user_roles',
+    'users',
+    'variables',
+    'view_fields',
+    'view_tables',
+    'views',
+    'workflows',
+];