@appaflytech/zeyrek-ai-mcp 0.0.23 → 0.0.24

package/dist/knowledge/styleResolve.js

@@ -154,6 +154,24 @@ const resolveShadow = (shadow) => {
         return undefined;
     return SHADOW_VALUES[shadow] ?? String(shadow);
 };
+/**
+ * Döndür / ölçekle / kaydır alanlarının kabul aralığı — frontend `style-groups/transform-fields.ts`
+ * `TRANSFORM_RANGES`'in kopyası (altın vakalar kilitler). Aralık dışı ve birimli değer yazılmaz.
+ */
+export const TRANSFORM_RANGES = {
+    rotate: [-360, 360],
+    scale: [10, 500],
+    translateX: [-1000, 1000],
+    translateY: [-1000, 1000]
+};
+/** Sayı ya da sayısal metin, aralığın içinde; aksi `undefined` — frontend `transformValue`. */
+export const transformValue = (value, field) => {
+    if (typeof value !== 'number' && (typeof value !== 'string' || value.trim() === ''))
+        return undefined;
+    const parsed = Number(value);
+    const [min, max] = TRANSFORM_RANGES[field];
+    return Number.isFinite(parsed) && parsed >= min && parsed <= max ? parsed : undefined;
+};
 /**
  * Grupların alan listeleri — frontend `style-groups/style-group-schemas.ts`
  * `STYLE_GROUP_FIELDS`'in kopyası. Parite testi `components.json`'daki gerçek
@@ -170,7 +188,11 @@ export const STYLE_GROUP_FIELDS = {
         'borderLeft',
         'shadow',
         'contentOverflow',
-        'opacity'
+        'opacity',
+        'rotate',
+        'scale',
+        'translateX',
+        'translateY'
     ],
     typographyStyle: [
         'textColor',
@@ -220,6 +242,21 @@ export function composeTypedStyle(input, ext) {
         if (opacity !== undefined && opacity >= 0 && opacity < 100) {
             groups.opacity = String(opacity / 100);
         }
+        // Döndür / ölçekle / kaydır (ADR 0005): kaydır → döndür → ölçekle, köken merkez;
+        // ölçek yüzdedir, nötr değer ve aralık dışı yazılmaz — frontend `composeSurfaceTransform`.
+        const transform = [];
+        const x = transformValue(surface.translateX, 'translateX') ?? 0;
+        const y = transformValue(surface.translateY, 'translateY') ?? 0;
+        if (x !== 0 || y !== 0)
+            transform.push(`translate(${x}px, ${y}px)`);
+        const rotate = transformValue(surface.rotate, 'rotate');
+        if (rotate !== undefined && rotate !== 0)
+            transform.push(`rotate(${rotate}deg)`);
+        const scale = transformValue(surface.scale, 'scale');
+        if (scale !== undefined && scale !== 100)
+            transform.push(`scale(${scale / 100})`);
+        if (transform.length)
+            groups.transform = transform.join(' ');
         // `ROOT_TARGET` (`&`) kökün kendisidir: kendi derleyicisi olmayan kaplarda
         // yüzey düğüm kutusuna yazılır ve kaydırılan da odur.
         if (isSet(surface.contentOverflow) && ext?.overflowTarget) {
@@ -251,8 +288,10 @@ export function composeTypedStyle(input, ext) {
         assign(rules, 'borderColor', hover.borderColor);
         assign(rules, 'boxShadow', resolveShadow(hover.shadow));
         const lift = asDimension(hover.lift);
-        if (lift !== undefined)
-            rules.transform = `translateY(calc(-1 * ${lift}))`;
+        // Kaldırma düğümün kendi transform'unu ezmez, önüne eklenir.
+        if (lift !== undefined) {
+            rules.transform = `translateY(calc(-1 * ${lift}))${typeof groups.transform === 'string' ? ` ${groups.transform}` : ''}`;
+        }
         if (Object.keys(rules).length) {
             const duration = asNumber(hover.transitionMs) ?? 160;
             groups.transition = `background-color ${duration}ms ease, border-color ${duration}ms ease, box-shadow ${duration}ms ease, transform ${duration}ms ease`;
@@ -500,6 +539,13 @@ export const NODE_SURFACE_TYPES = new Set([
     'qm-sidebar',
     'auth-layout'
 ]);
+/**
+ * `style`'ı kendi içeriğinin CSS'i olarak alan tipler: `html`in `style`'ı uzun metindir ve yazarın
+ * işaretlemesine kapsamlı girer — web'de emotion sınıfı (`html.functions.ts` `resolveHtmlStyleClass`),
+ * mobilde korumalı belgenin stil bloğu (plans/mobil-plantcare-acigi f-20). "Düz CSS string style"
+ * (PAGE-014) ve "ham CSS çizilmez" (MOB-002) uyarıları bu tiplerde yanlıştır.
+ */
+export const DOCUMENT_STYLE_TYPES = new Set(['html']);
 const NODE_SURFACE_EXTENSION = { overflowTarget: ROOT_TARGET };
 /** Düğüm kutusuna inen yüzey; kap tipi değilse ya da grup boşsa yok. */
 export function composeNodeSurfaceStyle(type, surfaceStyle) {

package/dist/knowledge/styleResolveNative.js

@@ -1,4 +1,4 @@
-import { rawProp } from './styleResolve.js';
+import { TRANSFORM_RANGES, rawProp, transformValue } from './styleResolve.js';
 import { mergeTypeScale, resolveTheme } from './themeResolve.js';
 /* ---- css-value.ts ---- */
 const warn = (context, message) => {
@@ -45,6 +45,46 @@ export function parseFontFamily(value) {
     const first = String(value).split(',')[0].trim().replace(/^["']|["']$/g, '');
     return first || null;
 }
+const GENERIC_FONT_FAMILIES = new Set([
+    'serif', 'sans-serif', 'monospace', 'cursive', 'fantasy', 'system-ui',
+    'ui-serif', 'ui-sans-serif', 'ui-monospace', 'ui-rounded', 'emoji', 'math', 'fangsong'
+]);
+/** CSS generik ailesi mi (`sans-serif`, `monospace`…) — tırnaklanırsa aile adı sanılır. */
+export function isGenericFontFamily(name) {
+    return GENERIC_FONT_FAMILIES.has(name.trim().toLowerCase());
+}
+/**
+ * Yığının yedek generiği: son generik ad, yoksa `sans-serif`. Temanın yığını `"Figtree",
+ * sans-serif` biçimindedir; tek ad yazılan `typographyStyle` yedeğini buradan miras alır (ZM-10).
+ */
+export function fontFallback(stack) {
+    const generic = String(stack ?? '').split(',').map(part => part.trim().replace(/^["']|["']$/g, '')).filter(isGenericFontFamily).pop();
+    return generic ?? 'sans-serif';
+}
+/** Yığının yalın ilk adı (tırnaksız); yükleyicinin istediği ad budur (ZM-10, f-05). */
+export function firstFontFamily(value) {
+    return parseFontFamily(value) ?? '';
+}
+/**
+ * Font adı platforma göre çözülür (ZM-10, K3). Frontend'de bu WEB/cihaz diye ikiye ayrılır
+ * (`font-family.ts` / `font-family.native.ts`, Metro `.native`'i seçer) ama bu ayna TEK koldur:
+ * `test/style-resolve-native.test.ts` frontend'in `theme-native.ts`'ini düz Node `import()` ile
+ * okur ve Node/Vite çözümü platform uzantısını (`.native.ts`) hiç görmez — parite testinin
+ * kıyasladığı gerçek davranış bu yüzden HER ZAMAN web kolu (`font-family.ts`); cihazdaki yalın-ad
+ * davranışı yalnız Metro bundle'ında oluşur ve bu aynanın kapsamı dışındadır (g-02 parity fix).
+ * Tek ad generik yedeksiz kalırsa RN web'de font yüklenemediğinde tarayıcı varsayılanı (Times)
+ * çizilir; bu yüzden tek ad tırnaklanıp temanın generiğiyle yığına çevrilir, yazarın kendi yığını
+ * (virgüllü) aynen geçer.
+ */
+export function resolveFontFamily(value, fallback) {
+    const text = value.trim();
+    if (text === '' || text.includes(','))
+        return text;
+    const name = firstFontFamily(text);
+    if (isGenericFontFamily(name))
+        return name;
+    return `"${name}", ${fallback}`;
+}
 export function parseLineHeight(value, fontSize, context) {
     if (value === undefined || value === null || value === '')
         return null;
@@ -202,6 +242,9 @@ export function resolveThemeNative(theme, mode = 'light') {
         if (narrow)
             scale[`${level}Mobile`] = px(narrow, fontSize);
     }
+    const bodyStack = vars['--ng-font'] ?? tokens.fontFamily;
+    const headingStack = vars['--ng-font-heading'] ?? bodyStack;
+    const fallback = fontFallback(bodyStack);
     return {
         mode,
         vars,
@@ -214,8 +257,11 @@ export function resolveThemeNative(theme, mode = 'light') {
             pill: px(vars['--ng-radius-pill'], 999)
         },
         font: {
-            family: vars['--ng-font'] ?? tokens.fontFamily,
-            headingFamily: vars['--ng-font-heading'] ?? tokens.fontFamily,
+            family: resolveFontFamily(bodyStack, fallback),
+            headingFamily: resolveFontFamily(headingStack, fallback),
+            source: firstFontFamily(bodyStack),
+            headingSource: firstFontFamily(headingStack),
+            fallback,
             size: fontSize,
             weight: vars['--ng-font-weight'] ?? tokens.fontWeight,
             scale
@@ -302,6 +348,55 @@ const composeBorders = (surface, shell, theme, context) => {
             shell.borderStyle = style;
     }
 };
+/** Yüzey grubunun bilinen alanları; kalanı uyarıya yazılır (frontend `SURFACE_KEYS`). MOB-002 de buradan okur. */
+export const SURFACE_KEYS = new Set([
+    'background',
+    'radius',
+    'borderTop',
+    'borderRight',
+    'borderBottom',
+    'borderLeft',
+    'shadow',
+    'contentOverflow',
+    'opacity',
+    'rotate',
+    'scale',
+    'translateX',
+    'translateY',
+    'borderWidth',
+    'borderStyle',
+    'borderColor'
+]);
+/**
+ * Döndür / ölçekle / kaydır (ADR 0005): web ile aynı sıra ve aralık, RN dizisi. Dolu ama geçersiz
+ * değer (birimli metin, aralık dışı) uyarıya yazılır — frontend `composeTransform`.
+ */
+const composeTransform = (surface, shell, warnings) => {
+    const read = (field) => {
+        const raw = surface[field];
+        if (!isSet(raw))
+            return undefined;
+        const value = transformValue(raw, field);
+        if (value === undefined) {
+            const [min, max] = TRANSFORM_RANGES[field];
+            warnings?.push(`surfaceStyle.${field}: ${String(raw)} geçersiz — ${min}…${max} arası sayı, atlandı`);
+        }
+        return value;
+    };
+    const transform = [];
+    const x = read('translateX') ?? 0;
+    const y = read('translateY') ?? 0;
+    if (x !== 0 || y !== 0)
+        transform.push({ translateX: x }, { translateY: y });
+    const rotate = read('rotate');
+    if (rotate !== undefined && rotate !== 0)
+        transform.push({ rotate: `${rotate}deg` });
+    const scale = read('scale');
+    if (scale !== undefined && scale !== 100)
+        transform.push({ scale: scale / 100 });
+    if (transform.length)
+        shell.transform = transform;
+};
 const composeSurface = (surface, shell, theme, context) => {
     const background = asText(surface.background, theme);
     if (background)
@@ -325,12 +420,17 @@ const composeSurface = (surface, shell, theme, context) => {
         if (overflow === 'auto')
             context.warnings?.push('contentOverflow: auto — RN kaydırmayı bileşenin kendisi açar, kutu hidden yapıldı');
     }
+    composeTransform(surface, shell, context.warnings);
+    for (const [key, value] of Object.entries(surface)) {
+        if (!SURFACE_KEYS.has(key) && isSet(value))
+            context.warnings?.push(`surfaceStyle.${key}: mobilde karşılığı yok, atlandı`);
+    }
 };
 const composeTypography = (typography, text, theme, context) => {
     const color = asText(typography.textColor, theme);
     if (color)
         text.color = color;
-    const family = parseFontFamily(asText(typography.fontFamily, theme));
+    const family = resolveFontFamily(asText(typography.fontFamily, theme) ?? '', theme.font.fallback);
     if (family)
         text.fontFamily = family;
     const fontSize = parsePanelLength(typeof typography.fontSize === 'string' ? resolveThemeToken(typography.fontSize, theme) : typography.fontSize, context);

package/dist/observability/trace.js

@@ -351,7 +351,7 @@ export function logGatewayEvent(message) {
  */
 export function logCapabilityGap(gap) {
     const lines = [
-        `┌─ ${clockOf(new Date())} · KABİLİYET BOŞLUĞU · ${gap.severity}${gap.module ? ` · ${gap.module}` : ''}`,
+        `┌─ ${clockOf(new Date())} · KABİLİYET BOŞLUĞU · ${gap.severity}${gap.module ? ` · ${gap.module}` : ''}${gap.project ? ` · proje ${gap.project}` : ''}`,
         `│  hedef  : ${condense(gap.goal, maxBodyChars)}`,
         `│  engel  : ${condense(gap.blocker, maxBodyChars)}`
     ];

package/dist/platform/argumentAliases.js

@@ -0,0 +1,128 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { PlatformApiError } from './errors.js';
+import { RefResolver, isGuid } from './refs.js';
+const text = (value) => typeof value === 'string' ? value : String(value ?? '');
+const hostAlias = (from, host) => ({
+    tool: '*',
+    from,
+    when: (shape, args) => 'host' in shape && 'hostId' in shape && !(from in shape) && args.host === undefined && args.hostId === undefined,
+    apply: async (value) => ({ set: { host, hostId: value }, note: `${from} → host: '${host}', hostId: ${text(value)}` })
+});
+export const ARGUMENT_ALIASES = [
+    hostAlias('pageId', 'page'),
+    hostAlias('layoutId', 'layout'),
+    hostAlias('componentId', 'component'),
+    {
+        tool: '*',
+        from: 'project',
+        when: (shape, args) => 'projectId' in shape && !('project' in shape) && args.projectId === undefined,
+        apply: async (value, _args, { platform }) => {
+            if (isGuid(text(value)))
+                return { set: { projectId: text(value) }, note: `project → projectId: ${text(value)}` };
+            // Önce slug (`/p/{slug}`), sonra ad: liste arama sonucunda slug ya da ad birebir (büyük/küçük harf duyarsız).
+            const bySlug = await platform.org('GET', `/p/${encodeURIComponent(text(value))}`).catch(() => undefined);
+            const wanted = text(value).toLocaleLowerCase('tr');
+            const listed = bySlug?.data?.id
+                ? undefined
+                : await platform.org('GET', '/projects', { query: { searchTerm: text(value), pageLength: 50 } }).catch(() => undefined);
+            const projectId = bySlug?.data?.id ?? listed?.data?.find(project => [project.slug, project.name].some(candidate => candidate?.toLocaleLowerCase('tr') === wanted))?.id;
+            if (!projectId)
+                throw new PlatformApiError(`'${text(value)}' diye bir proje yok (slug ya da ad); projectId'yi project_list ile bulun.`, 400);
+            return { set: { projectId }, note: `project '${text(value)}' → projectId: ${projectId}` };
+        }
+    },
+    {
+        tool: '*',
+        from: 'id',
+        when: (shape, args) => 'microservice' in shape && 'application' in shape && !('id' in shape) && args.microservice === undefined,
+        apply: async (value, args, { platform }) => {
+            if (!isGuid(text(value)))
+                return { set: { microservice: text(value) }, note: `id → microservice: '${text(value)}'` };
+            if (typeof args.application !== 'string')
+                throw new PlatformApiError("id bir microservice GUID'i; slug'ını çözmek için 'application' (uygulama slug'ı) da verin.", 400);
+            const resolver = new RefResolver(platform, args.project, args.environment);
+            const applicationId = await resolver.applicationId(args.application);
+            const payload = await platform.tenant('GET', args.project, `/microservices/${applicationId}/${text(value)}`, { environment: args.environment });
+            const slug = payload?.data?.slug;
+            if (!slug)
+                throw new PlatformApiError(`'${args.application}' uygulamasında ${text(value)} id'li microservice yok; microservice_list ile slug'ı bulun.`, 400);
+            return { set: { microservice: slug }, note: `id ${text(value)} → microservice: '${slug}'` };
+        }
+    },
+    {
+        tool: 'entity_get',
+        from: 'applicationId',
+        apply: async (value, args, { platform }) => {
+            const project = args.project;
+            const environment = args.environment;
+            const resolver = new RefResolver(platform, project, environment);
+            const applicationId = await resolver.applicationId(text(value));
+            const entity = await resolver.entity(text(args.id));
+            const payload = await platform.tenant('GET', project, `/entities/${entity.datasourceId}/${entity.entityId}`, { environment });
+            const linked = (payload?.data?.applications ?? []).some(link => [link.id, link.applicationId].some(id => id?.toLowerCase() === applicationId.toLowerCase()));
+            if (!linked) {
+                throw new PlatformApiError(`'${text(args.id)}' entity'si '${text(value)}' uygulamasına bağlı değil; entity_get uygulamaya göre değil entity'ye göre çalışır — applicationId'yi kaldırın ya da uygulamanın entity'lerini entity_list {applicationId} ile listeleyin.`, 400);
+            }
+            return { set: { datasourceId: entity.datasourceId }, note: `applicationId '${text(value)}' → datasourceId: ${entity.datasourceId} (entity '${text(args.id)}' bu uygulamaya bağlı)` };
+        }
+    },
+    {
+        tool: '*',
+        from: 'applicationId',
+        when: (shape, args) => shape.applicationId !== undefined && typeof args.applicationId === 'string' && !shape.applicationId.safeParse(args.applicationId).success,
+        apply: async (value, args, { platform }) => {
+            const applicationId = await new RefResolver(platform, args.project, args.environment).applicationId(text(value));
+            return { set: { applicationId }, note: `applicationId '${text(value)}' → ${applicationId}` };
+        }
+    }
+];
+export async function applyArgumentAliases(tool, args, context) {
+    if (!args || typeof args !== 'object' || Array.isArray(args))
+        return { args, applied: [] };
+    let current = { ...args };
+    const applied = [];
+    for (const alias of ARGUMENT_ALIASES) {
+        if (alias.tool !== '*' && alias.tool !== tool)
+            continue;
+        if (!(alias.from in current))
+            continue;
+        if (!(alias.when ? alias.when(context.shape, current) : !(alias.from in context.shape)))
+            continue;
+        const outcome = await alias.apply(current[alias.from], current, context);
+        const { [alias.from]: _replaced, ...rest } = current;
+        current = { ...rest, ...outcome.set };
+        applied.push(outcome.note);
+    }
+    return { args: current, applied };
+}
+/**
+ * Takma adı olmayan bilinmeyen argüman için "bunu mu demek istedin": okunan alanlar arasından büyük/küçük
+ * harf duyarsız düzenleme uzaklığı 2'yi geçmeyen en yakın ad (`hostID` → `hostId`, `views` → `view`).
+ */
+export function closestArgument(key, accepted) {
+    const distance = (left, right) => {
+        const row = Array.from({ length: right.length + 1 }, (_, index) => index);
+        for (let i = 1; i <= left.length; i++) {
+            let diagonal = row[0] ?? 0;
+            row[0] = i;
+            for (let j = 1; j <= right.length; j++) {
+                const above = row[j] ?? 0;
+                row[j] = Math.min(above + 1, (row[j - 1] ?? 0) + 1, diagonal + (left[i - 1] === right[j - 1] ? 0 : 1));
+                diagonal = above;
+            }
+        }
+        return row[right.length] ?? 0;
+    };
+    const ranked = accepted
+        .map(name => ({ name, score: distance(key.toLowerCase(), name.toLowerCase()) }))
+        .filter(entry => entry.score <= 2)
+        .sort((left, right) => left.score - right.score);
+    return ranked[0]?.name;
+}
+const activeNotes = new AsyncLocalStorage();
+export function runWithArgumentNotes(notes, run) {
+    return activeNotes.run(notes, run);
+}
+export function argumentNotes() {
+    return activeNotes.getStore() ?? { aliasesApplied: [] };
+}

package/dist/platform/bodyFile.js

@@ -0,0 +1,103 @@
+import { open, realpath } from 'node:fs/promises';
+import { constants } from 'node:fs';
+import { extname, resolve, sep } from 'node:path';
+import { z } from 'zod';
+import { PlatformApiError } from './errors.js';
+/**
+ * g-08 (`plans/mobil-plantcare-acigi`): tanım yazan araçlar gövdeyi dosyadan alabilir. Koşuda en
+ * büyük bağlam tasarrufu, ajanın kendi yazdığı "dosyadan MCP'ye" betiğinden geldi; o iş buraya
+ * taşındı. Her aracın TEK gövde argümanı vardır ve dosyanın JSON'u o argümanın değeri olur. Dosya
+ * SDK doğrulamasından ÖNCE okunur (`strictArguments.ts`), yani satır içi gövdeyle aynı şema ve aynı
+ * yol — dosyadan gelen gövde hiçbir kontrolü atlamaz.
+ */
+export const BODY_FILE_ARGUMENTS = {
+    page_create: 'schema',
+    page_update: 'schema',
+    page_schema_patch: 'ops',
+    flow_create: 'steps',
+    flow_update: 'steps',
+    flow_patch: 'operations',
+    microservice_create: 'definition',
+    microservice_update: 'definition',
+    microservice_patch: 'operations',
+    workflow_create: 'definition',
+    workflow_update: 'definition',
+    workflow_patch: 'operations'
+};
+/** `ops`/`operations` eşanlamlıdır (`microOps`); ikisinden biri satır içinde varsa gövde verilmiştir. */
+const synonyms = { ops: ['ops', 'operations'], operations: ['ops', 'operations'] };
+const maxBodyFileBytes = 5 * 1024 * 1024;
+export function bodyFileParam(argument) {
+    return z.string().min(1).optional().describe(`'${argument}' yerine okunacak yerel .json dosyası (en çok 5 MB): gövde ajan bağlamından geçmez, gateway dosyayı okuyup '${argument}' olarak aynı doğrulamadan geçirir. '${argument}' ile birlikte verilemez. Yol gateway sürecinin çalışma dizininin ya da MCP_INPUT_DIR'in altında olmalı (sembolik bağ çözülür). Yanıtın bodyFile alanı hangi dosyanın okunduğunu söyler.`);
+}
+export async function loadBodyFile(tool, args, config) {
+    const argument = BODY_FILE_ARGUMENTS[tool];
+    if (!argument || !args || typeof args !== 'object' || Array.isArray(args))
+        return { args };
+    const { bodyFile, ...rest } = args;
+    if (bodyFile === undefined)
+        return { args };
+    if (typeof bodyFile !== 'string' || bodyFile.length === 0)
+        return { args };
+    const inline = (synonyms[argument] ?? [argument]).filter(name => rest[name] !== undefined);
+    if (inline.length > 0) {
+        throw new PlatformApiError(`${tool}: bodyFile ile '${inline.join("', '")}' birlikte verilemez — gövde ya dosyadan ya satır içinden gelir. Birini kaldırın. İstek gönderilmedi.`, 400);
+    }
+    const absolute = resolve(bodyFile);
+    if (extname(absolute).toLowerCase() !== '.json') {
+        throw new PlatformApiError(`${tool}: bodyFile yalnız .json okur — verilen: ${absolute}. İstek gönderilmedi.`, 400);
+    }
+    let real;
+    try {
+        real = await realpath(absolute);
+    }
+    catch (error) {
+        throw new PlatformApiError(`${tool}: bodyFile okunamadı — ${absolute} (${error instanceof Error ? error.message : String(error)}). Yol gateway sürecinin çalıştığı makineye göre çözülür.`, 400);
+    }
+    if (extname(real).toLowerCase() !== '.json') {
+        throw new PlatformApiError(`${tool}: bodyFile'ın hedefi .json değil — ${real} (${absolute} bağının hedefi). İstek gönderilmedi.`, 400);
+    }
+    const roots = await Promise.all([process.cwd(), config.inputDirectory]
+        .filter((root) => typeof root === 'string' && root.length > 0)
+        .map(root => realpath(resolve(root)).catch(() => undefined)));
+    const allowed = roots.some(root => root !== undefined && (real === root || real.startsWith(`${root}${sep}`)));
+    if (!allowed) {
+        throw new PlatformApiError(`${tool}: bodyFile izinli dizinlerin dışında — ${real}${real !== absolute ? ` (${absolute} bağının hedefi)` : ''}. Gateway yalnız çalışma dizininin (${process.cwd()}) ve .env'deki MCP_INPUT_DIR'in (${config.inputDirectory ?? 'tanımsız'}) altındaki dosyaları okur. İstek gönderilmedi.`, 400);
+    }
+    // Denetim ve okuma AYNI tutamaçtan: yol denetimden sonra değişse de okunan, denetlenen dosyadır.
+    // O_NOFOLLOW son bileşenin sonradan bağa çevrilmesini, O_NONBLOCK `.json` adlı FIFO'nun çağrıyı
+    // bekletmesini önler; boyut dosyanın büyüklüğüne değil okunan bayta bakar.
+    let handle;
+    try {
+        handle = await open(real, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
+    }
+    catch (error) {
+        throw new PlatformApiError(`${tool}: bodyFile açılamadı — ${real} (${error instanceof Error ? error.message : String(error)}). İstek gönderilmedi.`, 400);
+    }
+    let bytes;
+    let text;
+    try {
+        const info = await handle.stat();
+        if (!info.isFile()) {
+            throw new PlatformApiError(`${tool}: bodyFile düzenli dosya değil — ${real}. İstek gönderilmedi.`, 400);
+        }
+        const buffer = Buffer.alloc(maxBodyFileBytes + 1);
+        const { bytesRead } = await handle.read(buffer, 0, buffer.length, 0);
+        bytes = bytesRead;
+        if (bytes > maxBodyFileBytes) {
+            throw new PlatformApiError(`${tool}: bodyFile 5 MB sınırını aşıyor. Tanımı parçalara bölün — sayfa için page_schema_patch'e birden çok batch, akış için flow_patch. İstek gönderilmedi.`, 400);
+        }
+        text = buffer.subarray(0, bytes).toString('utf8');
+    }
+    finally {
+        await handle.close();
+    }
+    let value;
+    try {
+        value = JSON.parse(text);
+    }
+    catch (error) {
+        throw new PlatformApiError(`${tool}: bodyFile JSON değil — ${real} (${error instanceof Error ? error.message : String(error)}). İstek gönderilmedi.`, 400);
+    }
+    return { args: { ...rest, [argument]: value }, note: `${bodyFile} → ${argument} (${bytes} B)` };
+}

package/dist/platform/capture/capture.js

@@ -4,6 +4,7 @@ import { INTERNAL_ROLE_SEPARATOR, knownInternalRoles } from '../../knowledge/com
 import { logStep } from '../../observability/trace.js';
 import { actionScript, activeTabScript, rootElementId, runtimePropsScript } from './actions.js';
 import { domSummaryScript } from './summary.js';
+import { createPageConsoleLog, describePageFailure, parseRenderErrors, renderErrorsScript } from './console-log.js';
 import { decideReadiness, describeUnready, parseReadiness, readinessScript, runtimePath } from './readiness.js';
 /**
  * Ziyaretçinin tema tercihinin yaşadığı localStorage anahtarı — `theme-toggle` bunu yazar,
@@ -17,6 +18,12 @@ const VIEWER_MODE_STORAGE_KEY = 'zeyrek-viewer-theme-mode';
  * büyüterek alınır: Studio runtime'ı kendi kaydırma kabını `100vh` üzerine kuruyor ve viewport
  * ötesi yakalama o kabı bir kez daha çiziyordu — aynı sayfa karede iki kez görünüyordu (09-04
  * Y-23). Tek karede çekilen görüntüde o birleştirme adımı hiç yok.
+ *
+ * İç kaydırıcı için gereken viewport `innerHeight + (scrollHeight − clientHeight)`'tir, kabın
+ * `scrollHeight`'i DEĞİL: kap viewport'la birlikte büyür ama üstündeki/altındaki sabit parçalar
+ * (mobil host'ta app bar + tab bar, ZM-23 f-06) büyümez. Yalnız `scrollHeight` itilince viewport
+ * içerik boyuna çıkıyor, kap hâlâ o parçalar kadar kısa kalıyor ve uzun mobil sayfanın altı
+ * karenin dışında kalıyordu. Kap viewport kadar yüksekse iki formül aynı sonucu verir.
  */
 export const contentHeightScript = [
     '(function () {',
@@ -27,7 +34,7 @@ export const contentHeightScript = [
     '  var nodes = document.querySelectorAll("*");',
     '  for (var index = 0; index < nodes.length && index < 4000; index += 1) {',
     '    var node = nodes[index];',
-    '    if (node.clientHeight >= viewportHeight * 0.6 && node.scrollHeight > node.clientHeight + 1) heights.push(node.scrollHeight);',
+    '    if (node.clientHeight >= viewportHeight * 0.6 && node.scrollHeight > node.clientHeight + 1) heights.push(viewportHeight + node.scrollHeight - node.clientHeight);',
     '  }',
     '  return { contentHeight: Math.max.apply(null, heights), viewportHeight: viewportHeight };',
     '})()'
@@ -91,6 +98,10 @@ export const layoutReportScript = [
     '  };',
     '})'
 ].join('\n');
+/** Mobil çizicinin hata sınırı işaretleri; betik düşerse boş (çekimi düşürmez). */
+async function readRenderErrors(page) {
+    return page.evaluate(renderErrorsScript).then(parseRenderErrors).catch(() => []);
+}
 /**
  * F-09 — sayfa akışı yalnız tarayıcıda koşar, bu yüzden bir setter iteratee'sinin
  * patlamasının gateway'e ulaşan HİÇBİR yolu yoktu: akış 200 dönüyor, hedef prop
@@ -264,7 +275,7 @@ export class StudioScreenshotter {
      * işaretlenir ve kare yine çekilir, çünkü bozuk/boş sayfayı görmek de bir doğrulamadır. Veri
      * yanıtından sonra fontlar + kısa yerleşme beklemesi Svelte hydrate'ine alan bırakır.
      */
-    async runActions(page, request) {
+    async runActions(page, request, consoleLog) {
         if (!request.actions || request.actions.length === 0)
             return undefined;
         const outcomes = [];
@@ -306,7 +317,8 @@ export class StudioScreenshotter {
                 completedBefore: activityBefore?.completed ?? Number.POSITIVE_INFINITY
             });
             if (readiness.state === 'not-ready' && request.captureUnready !== true) {
-                throw new PlatformApiError(`Etkileşim adımı ${index} (${action.action}${action.target === undefined ? '' : ` '${action.target}'`}) sonrasında sayfa ${readiness.waitedMs} ms içinde durulmadı, kare ALINMADI — ${describeUnready(readiness)}. Bekleme bütçesi ${apiResponseTimeoutMs + request.delayMs} ms; akış gerçekten uzun sürüyorsa delayMs ile büyütün. Yüklenmemiş hâli yine de görmek için captureUnready: true verin (kare pageState: 'not-ready' ile döner).`, 504);
+                const failure = consoleLog ? describePageFailure(consoleLog, await readRenderErrors(page)) : '';
+                throw new PlatformApiError(`Etkileşim adımı ${index} (${action.action}${action.target === undefined ? '' : ` '${action.target}'`}) sonrasında sayfa ${readiness.waitedMs} ms içinde durulmadı, kare ALINMADI — ${describeUnready(readiness)}.${failure} Bekleme bütçesi ${apiResponseTimeoutMs + request.delayMs} ms; akış gerçekten uzun sürüyorsa delayMs ile büyütün. Yüklenmemiş hâli yine de görmek için captureUnready: true verin (kare pageState: 'not-ready' ile döner).`, 504);
             }
             const after = await page.evaluate("performance.getEntriesByType('resource').length").catch(() => undefined);
             const requests = typeof after === 'number' && typeof before.requests === 'number' ? Math.max(after - before.requests, 0) : 0;
@@ -459,6 +471,11 @@ export class StudioScreenshotter {
                 await context.addInitScript(`try { localStorage.setItem(${JSON.stringify(VIEWER_MODE_STORAGE_KEY)}, ${JSON.stringify(request.colorScheme)}) } catch (error) { /* localStorage kapalıysa proje varsayılanı çizilir */ }`);
             }
             const page = await context.newPage();
+            // Konsol ve istisna dinleyicileri navigasyondan ÖNCE takılır: modül yüklenirken patlayan
+            // bileşenin hatası ilk karede düşer ve sonradan takılan dinleyici onu kaçırırdı (g-06).
+            const consoleLog = createPageConsoleLog();
+            page.on?.('console', message => consoleLog.onConsole(message));
+            page.on?.('pageerror', error => consoleLog.onPageError(error));
             // Soğuk Vite derlemesinde sayfanın kendi veri isteği 15 sn'yi aşabiliyor; delayMs bu
             // bütçeyi de uzatır (09-02 E-2). Yanıt hazırlık döngüsünü BLOKLAMAZ: runtime dışına
             // yönlendirilen sayfa bu isteği hiç atmaz ve eskiden 15 sn boşa bekleniyordu.
@@ -499,7 +516,8 @@ export class StudioScreenshotter {
             const apiStatus = await Promise.race([observedApiStatus, Promise.resolve(undefined)]);
             const apiNote = apiStatus === undefined ? 'sayfanın veri isteği gözlenmedi' : `veri isteği HTTP ${apiStatus}`;
             if (readiness.state === 'not-ready' && request.captureUnready !== true) {
-                throw new PlatformApiError(`Sayfa ${readiness.waitedMs} ms içinde yüklenmedi, kare ALINMADI — ${describeUnready(readiness, apiNote)}. Bekleme bütçesi ${readyBudgetMs} ms; sayfa yalnız yavaşsa delayMs ile büyütün. Sayfa gerçekten bozuksa page_runtime_get ile şemayı, STUDIO_BASE_URL ve slug'ları doğrulayın. Yüklenmemiş hâli yine de görmek için captureUnready: true verin (kare pageState: 'not-ready' ile döner).`, 504);
+                const failure = describePageFailure(consoleLog, await readRenderErrors(page));
+                throw new PlatformApiError(`Sayfa ${readiness.waitedMs} ms içinde yüklenmedi, kare ALINMADI — ${describeUnready(readiness, apiNote)}.${failure} Bekleme bütçesi ${readyBudgetMs} ms; sayfa yalnız yavaşsa delayMs ile büyütün. Sayfa gerçekten bozuksa page_runtime_get ile şemayı, STUDIO_BASE_URL ve slug'ları doğrulayın. Yüklenmemiş hâli yine de görmek için captureUnready: true verin (kare pageState: 'not-ready' ile döner).`, 504);
             }
             await page.evaluate('document.fonts.ready.then(() => true)').catch(() => undefined);
             const flowsSettled = readiness.state === 'ready' || readiness.state === 'ready-no-flows'
@@ -507,7 +525,7 @@ export class StudioScreenshotter {
                 : readiness.state === 'not-ready' ? false : undefined;
             const finalHref = readiness.snapshot?.href;
             const finalUrl = finalHref !== undefined && runtimePath(finalHref) !== runtimePath(request.url) ? finalHref : undefined;
-            const actions = await this.runActions(page, request);
+            const actions = await this.runActions(page, request, consoleLog);
             // Ölçüm EYLEMLERDEN SONRA: eylem sekme değiştirir, filtre uygular, panel açar — içerik
             // boyu o zaman kesinleşir. Eskiden ölçüm eylemlerden önceydi ve ikinci sekmede 40 satırlık
             // tablo açan bir çekim viewport boyunda kalıyordu; `contentHeight` ilk sekmenin boyuydu
@@ -548,6 +566,9 @@ export class StudioScreenshotter {
             const runtimeErrors = await page.evaluate(flowRuntimeErrorsScript)
                 .then(value => Array.isArray(value) ? value : [])
                 .catch(() => []);
+            const renderErrors = await readRenderErrors(page);
+            const consoleErrors = consoleLog.consoleErrors();
+            const pageErrors = consoleLog.pageErrors();
             // Özet kareden ÖNCE ve büyütmeden SONRA: ikisi de aynı yerleşmiş sayfayı anlatsın.
             const summaryRaw = request.summary === false
                 ? undefined
@@ -590,6 +611,9 @@ export class StudioScreenshotter {
                 ...(layout === undefined ? {} : { layout }),
                 ...(actions === undefined ? {} : { actions }),
                 ...(runtimeErrors.length > 0 ? { runtimeErrors } : {}),
+                ...(consoleErrors.length > 0 ? { consoleErrors } : {}),
+                ...(pageErrors.length > 0 ? { pageErrors } : {}),
+                ...(renderErrors.length > 0 ? { renderErrors } : {}),
                 ...(flowsSettled === undefined ? {} : { flowsSettled }),
                 ...(navigationRetried ? { navigationRetried: true } : {})
             };