@appaflytech/zeyrek-ai-mcp 0.0.48 → 0.0.50

package/dist/platform/capture/capture.js

@@ -188,6 +188,31 @@ async function resolveClip(page, clip) {
     }
     return { x: Math.round(raw.x), y: Math.round(raw.y), width: Math.round(raw.width), height: Math.round(raw.height) };
 }
+/**
+ * Gateway'in varsayılan tarayıcısı: kalıcı profilli Chromium. `mobile_asset_preview` de bunu kullanır
+ * (ADR 0004); aynı süreçte ikinci açılış profil dizini dolu olduğu için sıradaki yuvaya geçer.
+ */
+export async function launchScreenshotBrowser(config) {
+    let chromium;
+    try {
+        chromium = (await import('playwright-core')).chromium;
+    }
+    catch {
+        throw new PlatformApiError('playwright-core paketi yüklü değil — zeyrek-mcp dizininde `npm install playwright-core` çalıştırın, ardından tarayıcı için `npx playwright-core install chromium`.');
+    }
+    logStep('tarayıcı →', `chromium başlatılıyor (ilk çağrı — sonraki çağrılar önbellekteki tarayıcıyı kullanır) · profil ${screenshotProfileRoot()}`);
+    const open = persistentContextOpener(chromium, config.screenshotBrowserPath ? { executablePath: config.screenshotBrowserPath } : {});
+    const browser = new PersistentScreenshotBrowser(open);
+    try {
+        // İlk bağlam burada açılır ki başlatma hatası eskisi gibi `launch()`'tan dönsün.
+        await (await browser.newContext({ viewport: { width: 1280, height: 720 }, deviceScaleFactor: 1 })).close();
+    }
+    catch (firstError) {
+        const message = firstError instanceof Error ? firstError.message : String(firstError);
+        throw new PlatformApiError(`Chromium başlatılamadı: ${message}. \`npx playwright-core install chromium\` ile indirin; alternatif olarak sistemdeki tarayıcının yolunu SCREENSHOT_BROWSER_PATH ile verin (alpine imajında \`apk add chromium\` + /usr/bin/chromium-browser).`);
+    }
+    return browser;
+}
 /**
  * Playwright bağlamı ve tarayıcısı bu sınıfta PAYLAŞILIR. İki çekim aynı anda koştuğunda
  * 2026-09-06 koşusunda ikisi de `Target page, context or browser has been closed` ile düştü
@@ -272,27 +297,7 @@ export class StudioScreenshotter {
         }
     }
     async launch() {
-        if (this.launcher)
-            return this.launcher();
-        let chromium;
-        try {
-            chromium = (await import('playwright-core')).chromium;
-        }
-        catch {
-            throw new PlatformApiError('playwright-core paketi yüklü değil — zeyrek-mcp dizininde `npm install playwright-core` çalıştırın, ardından tarayıcı için `npx playwright-core install chromium`.');
-        }
-        logStep('tarayıcı →', `chromium başlatılıyor (ilk çağrı — sonraki çağrılar önbellekteki tarayıcıyı kullanır) · profil ${screenshotProfileRoot()}`);
-        const open = persistentContextOpener(chromium, this.config.screenshotBrowserPath ? { executablePath: this.config.screenshotBrowserPath } : {});
-        const browser = new PersistentScreenshotBrowser(open);
-        try {
-            // İlk bağlam burada açılır ki başlatma hatası eskisi gibi `launch()`'tan dönsün.
-            await (await browser.newContext({ viewport: { width: 1280, height: 720 }, deviceScaleFactor: 1 })).close();
-        }
-        catch (firstError) {
-            const message = firstError instanceof Error ? firstError.message : String(firstError);
-            throw new PlatformApiError(`Chromium başlatılamadı: ${message}. \`npx playwright-core install chromium\` ile indirin; alternatif olarak sistemdeki tarayıcının yolunu SCREENSHOT_BROWSER_PATH ile verin (alpine imajında \`apk add chromium\` + /usr/bin/chromium-browser).`);
-        }
-        return browser;
+        return this.launcher ? this.launcher() : launchScreenshotBrowser(this.config);
     }
     /**
      * Bekleme stratejisi bilinçli olarak `networkidle` DEĞİL: Studio'nun kök layout'u

package/dist/platform/errors.js

@@ -472,6 +472,15 @@ export function mapPlatformError(status, payload, context) {
     const errorBodyDetail = errorBody.length > 0 ? ` — ${errorBody.join(' · ')}` : '';
     return new PlatformApiError(`Platform hatası ${status} (${location}): ${apiMessage ?? 'beklenmeyen hata'}${code ? ` [${code}]` : ''}${errorBodyDetail}${fallbackDetail}${diagnoseKnownFailure(status, apiMessage ?? '', code, context)}`, status, code);
 }
+const CONNECTION_RESET_CODES = new Set(['ECONNRESET', 'UND_ERR_SOCKET', 'EPIPE', 'ECONNABORTED']);
+/**
+ * Bağlantı yolda koptu mu (yanıt gelmeden): Docker Desktop'ın host port yönlendirmesi yük altında açık bağlantıları ara ara
+ * düşürür — konteyner içinden aynı uç kopmaz (f-02, 2026-10-24 ölçümü: içeride 0/1800, host'ta `:3000` 4/1800, `:80` 2/1800).
+ */
+export function isConnectionReset(error) {
+    const failure = error;
+    return CONNECTION_RESET_CODES.has(String(failure?.code)) || CONNECTION_RESET_CODES.has(String(failure?.cause?.code));
+}
 export function mapNetworkError(error, context) {
     const cause = error instanceof Error ? error : new Error(String(error));
     if (cause.name === 'TimeoutError' || cause.name === 'AbortError') {

package/dist/platform/http.js

@@ -1,4 +1,4 @@
-import { PlatformApiError, mapNetworkError, mapPlatformError } from './errors.js';
+import { PlatformApiError, isConnectionReset, mapNetworkError, mapPlatformError } from './errors.js';
 import { logStep, logsDetail, renderJson } from '../observability/trace.js';
 import { AsyncLocalStorage } from 'node:async_hooks';
 import { TokenProvider } from './token.js';
@@ -134,7 +134,7 @@ export class Platform {
         }
         return `Bearer ${await this.tokens.getToken()}`;
     }
-    async send(api, method, path, options, raw = false, isRetry = false) {
+    async send(api, method, path, options, raw = false, isRetry = false, networkRetried = false) {
         const baseUrl = api === 'org' ? this.config.orgApiBaseUrl : this.config.tenantApiBaseUrl;
         const context = { api, method, path, baseUrl, environment: options.environment, authMode: this.config.authMode };
         const url = new URL(`${baseUrl}${path}`);
@@ -207,6 +207,11 @@ export class Platform {
         }
         catch (error) {
             logStep('ağ ✕', `${method} ${url.href} · ${Date.now() - startedAt} ms sonra ulaşılamadı`, [error instanceof Error ? `${error.name}: ${error.message}` : String(error)]);
+            // Yalnız tekrarı zararsız istek (GET/HEAD) ve yalnız bir kez: yazan istek sunucuya ulaşmış olabilir.
+            if ((method === 'GET' || method === 'HEAD') && !networkRetried && !options.noNetworkRetry && isConnectionReset(error)) {
+                logStep('ağ ⟳', `${method} ${url.href} · bağlantı koptu, bir kez yeniden deneniyor`);
+                return this.send(api, method, path, options, raw, isRetry, true);
+            }
             throw mapNetworkError(error, context);
         }
         logStep('yanıt ←', `HTTP ${statusCode} · ${Date.now() - startedAt} ms · ${responseBytes} B`, statusCode >= 400 || logsDetail()

package/dist/platform/storeArt/compose.js

@@ -0,0 +1,114 @@
+import { mkdir, rm, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { PlatformApiError } from '../errors.js';
+import { imageSize } from '../capture/capture.js';
+import { STORE_ART_LAYOUTS, storeCanvas } from './layouts.js';
+import { BACKDROPS, FONT_STACKS, resolveStyle } from './styles.js';
+import { cardFileName } from './deck.js';
+/**
+ * Mağaza pazarlama karesi (ADR 0004, 0005): ham ekran görüntüsü yerleşimin kutularına oturtulur, stilin
+ * zemini, yazısı ve sahnesiyle mağazanın istediği ölçüde alfasız JPEG çizilir. Çizim gateway'in Chromium'uyla
+ * yapılır; kare HTML'i saf fonksiyondur ve yerleşime ya da stile göre dallanmaz — ikisi de kayıttan okunur.
+ * Editörün önizlemesi de aynı HTML'dir (`cardHtml`); önizleme ile çıktı ayrışamaz.
+ */
+export { storeCanvas } from './layouts.js';
+const jpegQuality = 92;
+const renderTimeoutMs = 30000;
+/**
+ * Görseller `decode()` ile beklenir: `domcontentloaded` anında `<img>` henüz çözülmemiş olabilir ve kare
+ * boş ekranla çıkardı. Yazı tipi de beklenir; satır kırılımı yüklenen yazı tipine göre değişir.
+ */
+const slideReadyScript = "Promise.all([document.fonts.ready, ...Array.from(document.images).map(image => image.decode())]).then(() => true, error => String(error && error.message ? error.message : error))";
+export function slideGeometry(deviceClass, frame, captionPosition, layout = 'classic') {
+    return STORE_ART_LAYOUTS[layout].geometry({ deviceClass, frame, captionPosition });
+}
+const escapeHtml = (value) => value.replace(/[&<>"']/g, character => `&#${character.charCodeAt(0)};`);
+const place = (box) => `left:${box.x}px;top:${box.y}px;width:${box.width}px;height:${box.height}px`;
+const clamp = (lines) => `display:-webkit-box;-webkit-line-clamp:${lines};-webkit-box-orient:vertical;overflow:hidden`;
+/**
+ * `locale` sayfanın `lang`'idir: CSS `text-transform: uppercase` dilin kuralını ondan alır — dil yokken Türkçe
+ * "bir" "BIR" çiziliyordu, "BİR" olmalı (2026-10-26, swiss stili).
+ */
+export function slideHtml(geometry, style, slide, imageUrl, locale = 'en') {
+    const { canvas, caption, device, screen, cutout } = geometry;
+    const phone = device ?? screen;
+    const shadow = `0 ${Math.round(canvas.height * 0.012)}px ${Math.round(canvas.height * 0.03)}px rgba(0,0,0,${style.shadow})`;
+    const glow = style.glow ? `,0 0 ${Math.round(canvas.width * 0.09)}px ${style.colors.accent}88` : '';
+    const showScreen = screen !== undefined && imageUrl !== undefined;
+    return [
+        `<!doctype html><html lang="${escapeHtml(locale)}"><head><meta charset="utf-8"><style>`,
+        '*{margin:0;padding:0;box-sizing:border-box}',
+        `html,body{width:${canvas.width}px;height:${canvas.height}px;overflow:hidden}`,
+        `body{position:relative;background:${BACKDROPS[style.backdrop](style.colors, canvas)};color:${style.colors.text};font-family:${FONT_STACKS[style.font]};-webkit-font-smoothing:antialiased}`,
+        `.caption{position:absolute;${place(caption)};display:flex;flex-direction:column;justify-content:center;align-items:${style.align === 'left' ? 'flex-start' : 'center'};gap:${Math.round(geometry.subtitleSize * 0.5)}px;text-align:${style.align}}`,
+        `.eyebrow{font-size:${geometry.eyebrowSize}px;font-weight:700;letter-spacing:0.14em;text-transform:uppercase;color:${style.colors.accent}}`,
+        `.title{font-size:${geometry.titleSize}px;font-weight:${style.titleWeight};line-height:1.1;letter-spacing:-0.01em;text-transform:${style.titleCase};${clamp(geometry.titleLines)}}`,
+        `.subtitle{font-size:${geometry.subtitleSize}px;font-weight:500;line-height:1.25;opacity:0.8;${clamp(2)}}`,
+        phone ? `.phone{position:absolute;inset:0;transform-origin:${phone.x + phone.width / 2}px ${phone.y + phone.height / 2}px;transform:${geometry.phoneTransform ?? 'none'}}` : '',
+        device ? `.device{position:absolute;${place(device)};border-radius:${device.radius}px;background:${style.frameColor};box-shadow:${shadow}${glow},inset 0 0 0 ${Math.max(Math.round(device.width * 0.004), 2)}px #3a3a3e}` : '',
+        screen ? `.screen{position:absolute;${place(screen)};border-radius:${screen.radius}px;overflow:hidden;background:#ffffff${device ? '' : `;box-shadow:${shadow}${glow}`}}` : '',
+        '.screen img{display:block;width:100%;height:100%;object-fit:cover;object-position:top}',
+        cutout ? `.cutout{position:absolute;${place(cutout)};border-radius:${cutout.radius}px;background:#000000}` : '',
+        '</style></head><body>',
+        '<div class="caption">',
+        slide.eyebrow ? `<div class="eyebrow">${escapeHtml(slide.eyebrow)}</div>` : '',
+        `<div class="title">${escapeHtml(slide.title)}</div>`,
+        slide.subtitle ? `<div class="subtitle">${escapeHtml(slide.subtitle)}</div>` : '',
+        '</div>',
+        showScreen ? '<div class="phone">' : '',
+        showScreen && device ? '<div class="device"></div>' : '',
+        showScreen ? `<div class="screen"><img src="${escapeHtml(imageUrl)}" alt=""></div>` : '',
+        showScreen && cutout ? '<div class="cutout"></div>' : '',
+        showScreen ? '</div>' : '',
+        '</body></html>'
+    ].join('');
+}
+/** Kartın HTML'i; `imageUrl` ham karenin adresidir (çizimde file://, editör önizlemesinde galeri adresi) */
+export function cardHtml(deck, spec, imageUrl) {
+    const raw = spec.raw === undefined || !STORE_ART_LAYOUTS[spec.layout].needsScreen ? undefined : deck.raws[spec.raw];
+    return slideHtml(slideGeometry(deck.deviceClass, spec.frame, spec.captionPosition, spec.layout), resolveStyle(spec.style, { primary: spec.accent, text: spec.text }), spec, raw ? imageUrl(raw) : undefined, deck.locale);
+}
+/**
+ * Kartları tek tarayıcıda sırayla çizer; her kart `fileName(card)` adıyla galeri dizinine yazılır. Editör geçici
+ * ad verir ve dosyaları ancak bütün iş başarılı olunca yerine taşır (yarıda düşen çizim kartı ezmesin).
+ */
+export async function renderCards(launch, deck, directory, cards, fileName = cardFileName) {
+    const canvas = storeCanvas(deck.deviceClass);
+    const renderDirectory = path.join(directory, '.render');
+    let browser;
+    try {
+        await mkdir(renderDirectory, { recursive: true });
+        browser = await launch();
+        const context = await browser.newContext({ viewport: canvas, deviceScaleFactor: 1 });
+        try {
+            const page = await context.newPage();
+            const files = [];
+            for (const card of cards) {
+                const htmlPath = path.join(renderDirectory, `${card.name}.html`);
+                await writeFile(htmlPath, cardHtml(deck, card.spec, raw => pathToFileURL(raw.path).href));
+                await page.goto(pathToFileURL(htmlPath).href, { waitUntil: 'domcontentloaded', timeout: renderTimeoutMs });
+                const ready = await page.evaluate(slideReadyScript);
+                if (ready !== true) {
+                    throw new PlatformApiError(`mobile_asset_preview: slides[${card.slide}] çizilemedi — ham kare tarayıcıda açılmadı (${String(ready)}). Dosyanın bozuk olmadığını page_screenshot ile yeniden çekerek doğrulayın (kart ${card.name}).`, 422);
+                }
+                const bytes = await page.screenshot({ type: 'jpeg', quality: jpegQuality, fullPage: false });
+                const size = imageSize(bytes);
+                if (size === undefined || size.width !== canvas.width || size.height !== canvas.height) {
+                    throw new PlatformApiError(`mobile_asset_preview: slides[${card.slide}] ${size ? `${size.width}×${size.height}` : 'ölçüsü okunamayan'} çizildi, ${deck.deviceClass} mağaza ölçüsü ${canvas.width}×${canvas.height}. Mağaza bu kareyi reddederdi; dosya yazılmadı (kart ${card.name}).`, 500);
+                }
+                const file = path.join(directory, fileName(card));
+                await writeFile(file, bytes);
+                files.push({ card: card.name, style: card.spec.style, index: card.slide, path: file, width: size.width, height: size.height });
+            }
+            return files;
+        }
+        finally {
+            await context.close().catch(() => undefined);
+        }
+    }
+    finally {
+        await browser?.close().catch(() => undefined);
+        await rm(renderDirectory, { recursive: true, force: true });
+    }
+}

package/dist/platform/storeArt/deck.js

@@ -0,0 +1,133 @@
+import { copyFile, mkdir, readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { z } from 'zod';
+import { COLOR_PATTERN, SCREENSHOT_CAPTURE_DEVICES } from '../../knowledge/mobileStore.js';
+import { PlatformApiError } from '../errors.js';
+import { imageSize } from '../capture/capture.js';
+import { LAYOUT_IDS, STORE_ART_LAYOUTS } from './layouts.js';
+import { STYLE_IDS } from './styles.js';
+/**
+ * Pazarlama görseli destesi (ADR 0004 §Ek): araçtan gelen kareler × stiller birer KART olur; galeri editörü kartın
+ * spec'ini değiştirip yeniden çizer. Ham kareler galeri dizinine `raw-NN.<uzantı>` adıyla kopyalanır — sunucu
+ * yalnız bu adları sunar, çizici de kopyayı okur. Spec'in sınırları aracın girdi sınırlarıyla aynıdır (araç bu
+ * sabitleri kullanır); editörden gelen spec sunucuda bu şemayla yeniden doğrulanır.
+ */
+export const TITLE_MAX = 80;
+export const SUBTITLE_MAX = 140;
+export const EYEBROW_MAX = 30;
+export const MAX_STYLES = 4;
+export const MAX_CARDS = 40;
+const defaultStyles = ['clean'];
+const aspectTolerance = 0.01;
+const pad = (value) => String(value).padStart(2, '0');
+/** `deck.json`'a ve istemciye tanımsız alan gitmez: boş üst etiket "alan yok" demektir */
+const withoutUndefined = (value) => Object.fromEntries(Object.entries(value).filter(([, field]) => field !== undefined));
+/** Boş metin alanı siler: editörde üst etiketi ya da alt başlığı temizlemek alanı kaldırmaktır */
+const optionalText = (max) => z.string().trim().max(max).optional().transform(value => value ? value : undefined);
+const hexColor = z.string().regex(COLOR_PATTERN);
+const cardSpecSchema = z.object({
+    raw: z.number().int().min(0).optional(),
+    eyebrow: optionalText(EYEBROW_MAX),
+    title: z.string().trim().min(1).max(TITLE_MAX),
+    subtitle: optionalText(SUBTITLE_MAX),
+    style: z.enum(STYLE_IDS),
+    layout: z.enum(LAYOUT_IDS),
+    captionPosition: z.enum(['top', 'bottom']),
+    accent: hexColor.optional(),
+    text: hexColor.optional(),
+    frame: z.boolean()
+}).strict();
+/** Editörden gelen spec: şema + destenin kendi kuralları (ham kare destede olmalı; cihaz gösteren yerleşim kare ister) */
+export function parseCardSpec(deck, value) {
+    const parsed = cardSpecSchema.safeParse(value);
+    if (!parsed.success)
+        return { error: parsed.error.issues.map(issue => `${issue.path.join('.') || 'spec'}: ${issue.message}`).join('; ') };
+    const spec = withoutUndefined(parsed.data);
+    if (spec.raw !== undefined && spec.raw >= deck.raws.length)
+        return { error: `raw: destede ${deck.raws.length} ham kare var, ${spec.raw} yok` };
+    if (STORE_ART_LAYOUTS[spec.layout].needsScreen && spec.raw === undefined)
+        return { error: `layout: '${spec.layout}' ham kare ister — raw verin ya da 'text' seçin` };
+    return { spec };
+}
+async function readSlideSource(source, index) {
+    const absolute = path.resolve(source);
+    let bytes;
+    try {
+        bytes = await readFile(absolute);
+    }
+    catch (error) {
+        throw new PlatformApiError(`mobile_asset_preview: slides[${index}].path okunamadı — ${absolute} (${error instanceof Error ? error.message : String(error)}). Yol gateway sürecinin çalıştığı makineye göre çözülür; page_screenshot outPath'ini verin. Hiçbir kare çizilmedi.`, 400);
+    }
+    const size = imageSize(bytes);
+    if (size === undefined) {
+        throw new PlatformApiError(`mobile_asset_preview: slides[${index}].path PNG ya da JPEG değil — ${absolute}. Ham kareyi page_screenshot { format: 'jpeg', outPath } ile üretin. Hiçbir kare çizilmedi.`, 400);
+    }
+    return { absolute, size, png: bytes[0] === 0x89 };
+}
+/**
+ * Araç girdisinden desteyi kurar: ham kareleri doğrular ve galeri dizinine kopyalar, kartları kare sırasıyla
+ * (her karenin stilleri yan yana) dizer — deste sırası yükleme sırasıdır.
+ */
+export async function buildDeck(input, directory) {
+    const styles = input.styles ?? defaultStyles;
+    if (new Set(styles).size !== styles.length) {
+        throw new PlatformApiError(`mobile_asset_preview: styles tekrar ediyor (${styles.join(', ')}) — her stil bir kez verilir. Hiçbir kare çizilmedi.`, 400);
+    }
+    const capture = SCREENSHOT_CAPTURE_DEVICES[input.deviceClass];
+    const sources = await Promise.all(input.slides.map(async (slide, index) => {
+        const layout = slide.layout ?? 'classic';
+        if (!STORE_ART_LAYOUTS[layout].needsScreen)
+            return undefined;
+        if (slide.path === undefined) {
+            throw new PlatformApiError(`mobile_asset_preview: slides[${index}].path gerekli — '${layout}' yerleşimi ham kareyi cihazda gösterir; yalnız 'text' yerleşimi kare istemez. Hiçbir kare çizilmedi.`, 400);
+        }
+        return readSlideSource(slide.path, index);
+    }));
+    // Oranı farklı kare ekrana `object-fit: cover` ile kırpılarak oturur; çizim durmaz ama ajan bilmeli.
+    const warnings = sources.flatMap((source, index) => source && Math.abs(source.size.height / source.size.width - capture.height / capture.width) > aspectTolerance
+        ? [`slides[${index}]: ham kare ${source.size.width}×${source.size.height}, ${input.deviceClass} ekranı ${capture.width}×${capture.height} oranında — kare ekrana kırpılarak oturdu. page_screenshot'ı device { width: ${capture.width}, height: ${capture.height}, scale: ${capture.scale} } ile çekin.`]
+        : []);
+    const raws = [];
+    const rawOfSlide = [];
+    await mkdir(directory, { recursive: true });
+    for (const [index, source] of sources.entries()) {
+        if (source === undefined) {
+            rawOfSlide.push(undefined);
+            continue;
+        }
+        const name = `raw-${pad(index + 1)}.${source.png ? 'png' : 'jpg'}`;
+        const copy = path.join(directory, name);
+        await copyFile(source.absolute, copy);
+        raws.push({ name, path: copy, ...source.size });
+        rawOfSlide.push(raws.length - 1);
+    }
+    const cards = input.slides.flatMap((slide, index) => styles.map((style) => ({
+        name: `${style}-${pad(index + 1)}`,
+        slide: index,
+        version: 1,
+        // Araç girdisi zod'dan geçmiştir; yalnız tanımsız alanlar atılır.
+        spec: withoutUndefined({
+            raw: rawOfSlide[index],
+            eyebrow: slide.eyebrow,
+            title: slide.title,
+            subtitle: slide.subtitle,
+            style,
+            layout: slide.layout ?? 'classic',
+            captionPosition: input.captionPosition ?? 'top',
+            accent: input.palette?.primary,
+            text: input.palette?.text,
+            frame: input.frame ?? true
+        })
+    })));
+    return { deck: { deviceClass: input.deviceClass, locale: input.locale, slot: `screenshot/${input.locale}/${input.deviceClass}`, raws, cards }, warnings };
+}
+/** Kartın kopyası: aynı spec, kare sırası ve dosya; ad `<ad>-2`, `<ad>-3` … */
+export function duplicateCard(deck, original) {
+    const names = new Set(deck.cards.map(card => card.name));
+    let suffix = 2;
+    while (names.has(`${original.name}-${suffix}`))
+        suffix += 1;
+    return { name: `${original.name}-${suffix}`, slide: original.slide, version: 1, spec: { ...original.spec } };
+}
+export const cardFileName = (card) => `${card.name}.jpg`;
+export const saveDeck = (directory, deck) => writeFile(path.join(directory, 'deck.json'), JSON.stringify(deck, null, 2));