@appaflytech/zeyrek-ai-mcp 0.0.43 → 0.0.45

package/dist/knowledge/textHooks.js

@@ -0,0 +1,434 @@
+// Okunduğunda ekrandaki yazıyı veren alanlar ve öznitelikler: bunlarla karşılaştırma her metinde kancadır.
+// `statusText` bilerek yok: XHR / fetch yanıtının HTTP durum metnidir ('Not Found'), arayüz yazısı değil.
+const DISPLAY_PROPS = 'title|label|text|textContent|innerText|innerHTML|outerText|nodeValue|caption|placeholder|buttonText|headerText|displayText|tooltip|ariaLabel';
+const DISPLAY_ATTRS = 'aria-label|title|placeholder|alt';
+const displayMember = new RegExp(`(?:\\.|\\?\\.)\\s*(?:${DISPLAY_PROPS})\\s*$`);
+const displayBare = new RegExp(`^(?:${DISPLAY_PROPS})$`);
+const displayAttribute = new RegExp(`getAttribute\\s*\\(\\s*['"](?:${DISPLAY_ATTRS})['"]\\s*\\)\\s*$`);
+// Adres parametresi bir koddur — dili ne olursa olsun (`mod === 'düzenle'`) görünen yazı değildir.
+const codeSource = /\bqueryParams\b/;
+const normalizingCall = /(?:\?\.|\.)\s*(?:trim|trimStart|trimEnd|toLowerCase|toUpperCase|toLocaleLowerCase|toLocaleUpperCase|normalize)\s*\([^()]*\)\s*$/;
+// `=` çevresinde boşluk yok: `const [title = 'Başlık'] = args` dizi yıkımı seçici sanılmasın.
+const selectorPattern = new RegExp(`\\[\\s*(?:${DISPLAY_ATTRS})[~|^$*]?=(?:"([^"\\n]*)"|'([^'\\n]*)'|([^\\]"'\\s]+))\\s*[is]?\\s*\\]|:(?:contains|has-text)\\(\\s*(?:"([^"\\n]*)"|'([^'\\n]*)'|([^)"'\\n]+))\\s*\\)`, 'g');
+// Q(,Q)* biçimi: önceki `(?:\s*Q\s*,?)+` boşlukla ayrılmış dizelerde üstel geri izliyordu (n=20 → 13 sn, inceleme 2026-10-16).
+const QUOTED = `(?:'(?:[^'\\\\\\n]|\\\\.)*'|"(?:[^"\\\\\\n]|\\\\.)*")`;
+const arrayMembership = new RegExp(`\\[\\s*(${QUOTED}(?:\\s*,\\s*${QUOTED})*)\\s*,?\\s*\\]\\s*(?:\\?\\.|\\.)\\s*(?:includes|indexOf)\\s*\\(`, 'g');
+const quoted = /'((?:[^'\\\n]|\\.)*)'|"((?:[^"\\\n]|\\.)*)"/g;
+const regexTest = /(^|[=(,:!&|?;{}\s])\/((?:[^/\\\n]|\\.)+)\/([gimsuy]*)\s*\.\s*test\s*\(/g;
+const regexMatch = /(?:\?\.|\.)\s*(?:match|search)\s*\(\s*\/((?:[^/\\\n]|\\.)+)\/[gimsuy]*/g;
+const scriptBody = /<script\b[^>]*>([\s\S]*?)<\/script>/gi;
+// Karşılaştırılan tek kelime biçimce kod gibi görünüyorsa ama dilin / tarayıcının kendi adıysa aday değildir.
+const LANGUAGE_WORDS = new Set([
+    'string', 'number', 'boolean', 'object', 'function', 'undefined', 'symbol', 'bigint',
+    'Enter', 'Escape', 'Esc', 'Tab', 'Backspace', 'Delete', 'Space', 'ArrowUp', 'ArrowDown', 'ArrowLeft', 'ArrowRight', 'Home', 'End', 'PageUp', 'PageDown',
+    'none', 'block', 'flex', 'grid', 'inline', 'hidden', 'visible', 'auto', 'true', 'false', 'null'
+]);
+function hasForeignLetter(text) {
+    return /[^\x00-\x7F]/.test(text.replace(/[^\p{L}]/gu, ''));
+}
+/** En az iki harf: Türkçe arama / slug normalleştirmesindeki tek harf (`case 'ş': return 's'`) yazı değildir. */
+export function looksLikeDisplayText(value) {
+    const text = value.trim();
+    if ((text.match(/\p{L}/gu) ?? []).length < 2)
+        return false;
+    return /\s/.test(text) || hasForeignLetter(text);
+}
+/** Görünen alanla karşılaştırılan metin söz gibi olmalı: ikon adı ('download') ve karakter sınıfı ('a-zA-Z0-9') değil. */
+function looksLikeWording(value) {
+    const text = value.trim();
+    return looksLikeDisplayText(text) || /^\p{Lu}\p{Ll}/u.test(text);
+}
+function isWordCandidate(value) {
+    return /^[A-Za-z][A-Za-z0-9_-]+$/.test(value) && !LANGUAGE_WORDS.has(value);
+}
+function readsDisplayText(operand) {
+    let expression = operand.trim();
+    while (normalizingCall.test(expression))
+        expression = expression.replace(normalizingCall, '').trim();
+    return displayMember.test(expression) || displayBare.test(expression) || displayAttribute.test(expression);
+}
+/** `${` açılışından sonra eşleşen `}`'nin konumu; içteki dize ve iç içe şablon atlanır. */
+function interpolationEnd(code, start) {
+    let depth = 0;
+    let index = start;
+    while (index < code.length) {
+        const char = code[index];
+        if (char === "'" || char === '"' || char === '`') {
+            let cursor = index + 1;
+            while (cursor < code.length && code[cursor] !== char)
+                cursor += code[cursor] === '\\' ? 2 : 1;
+            index = cursor + 1;
+            continue;
+        }
+        if (char === '{')
+            depth++;
+        else if (char === '}') {
+            if (depth === 0)
+                return index;
+            depth--;
+        }
+        index++;
+    }
+    return code.length;
+}
+function scanLiterals(code) {
+    const literals = [];
+    let index = 0;
+    while (index < code.length) {
+        const char = code[index];
+        // `\/` kaçışlı bölü (düzenli ifade `/^https?:\/\//`) yorum başlangıcı değildir.
+        if (char === '/' && code[index + 1] === '/' && code[index - 1] !== '\\') {
+            const newline = code.indexOf('\n', index);
+            index = newline < 0 ? code.length : newline;
+            continue;
+        }
+        if (char === '/' && code[index + 1] === '*') {
+            const close = code.indexOf('*/', index + 2);
+            index = close < 0 ? code.length : close + 2;
+            continue;
+        }
+        if (char !== "'" && char !== '"' && char !== '`') {
+            index++;
+            continue;
+        }
+        let cursor = index + 1;
+        let value = '';
+        const interpolations = [];
+        while (cursor < code.length && code[cursor] !== char) {
+            if (code[cursor] === '\\') {
+                value += code[cursor + 1] ?? '';
+                cursor += 2;
+                continue;
+            }
+            if (char !== '`' && code[cursor] === '\n')
+                break;
+            if (char === '`' && code[cursor] === '$' && code[cursor + 1] === '{') {
+                const end = interpolationEnd(code, cursor + 2);
+                interpolations.push({ start: cursor + 2, end });
+                cursor = end + 1;
+                continue;
+            }
+            value += code[cursor];
+            cursor++;
+        }
+        if (code[cursor] !== char) {
+            index = cursor;
+            continue;
+        }
+        literals.push({ value, start: index, end: cursor + 1, ...(interpolations.length > 0 ? { interpolations } : {}) });
+        index = cursor + 1;
+    }
+    return literals;
+}
+/** Dize içeriklerini aynı uzunlukta dolguyla örter: işlenen sınırları aranırken tırnak içi ayraç sayılmasın. */
+function maskLiterals(code, literals) {
+    let masked = '';
+    let last = 0;
+    for (const literal of literals) {
+        masked += code.slice(last, literal.start + 1) + '_'.repeat(Math.max(0, literal.end - literal.start - 2));
+        last = literal.end - 1;
+    }
+    return masked + code.slice(last);
+}
+const OPERAND_DELIMITER = /[;,?:&|!=<>+\-*%\s]/;
+function leftOperandStart(masked, end) {
+    let depth = 0;
+    for (let index = end - 1; index >= 0; index--) {
+        const char = masked[index] ?? '';
+        if (char === ')' || char === ']' || char === '}')
+            depth++;
+        else if (char === '(' || char === '[' || char === '{') {
+            if (depth === 0)
+                return index + 1;
+            depth--;
+        }
+        else if (depth === 0 && OPERAND_DELIMITER.test(char) && !(char === '?' && masked[index + 1] === '.'))
+            return index + 1;
+    }
+    return 0;
+}
+function rightOperandEnd(masked, start) {
+    let depth = 0;
+    for (let index = start; index < masked.length; index++) {
+        const char = masked[index] ?? '';
+        if (char === '(' || char === '[' || char === '{')
+            depth++;
+        else if (char === ')' || char === ']' || char === '}') {
+            if (depth === 0)
+                return index;
+            depth--;
+        }
+        else if (depth === 0 && OPERAND_DELIMITER.test(char) && !(char === '?' && masked[index + 1] === '.'))
+            return index;
+    }
+    return masked.length;
+}
+function skipSpaceBack(text, index) {
+    let cursor = index;
+    while (cursor > 0 && /\s/.test(text[cursor - 1] ?? ''))
+        cursor--;
+    return cursor;
+}
+function skipSpaceForward(text, index) {
+    let cursor = index;
+    while (cursor < text.length && /\s/.test(text[cursor] ?? ''))
+        cursor++;
+    return cursor;
+}
+function excerptOf(code, start, end) {
+    return code.slice(Math.max(0, start - 40), Math.min(code.length, end + 20)).replace(/\s+/g, ' ').trim();
+}
+function classify(code, text, start, end, displayRead) {
+    const excerpt = excerptOf(code, start, end);
+    if (displayRead && looksLikeWording(text))
+        return { position: start, hook: { kind: 'display-read', text, excerpt, certain: true } };
+    if (looksLikeDisplayText(text))
+        return { position: start, hook: { kind: 'literal', text, excerpt, certain: hasForeignLetter(text) } };
+    if (isWordCandidate(text))
+        return { position: start, word: text };
+    return { position: start };
+}
+/**
+ * Düzenli ifadenin söz kısmı: kaçışlar, nicelik ve karakter sınıfları (`[a-z]`, `[çğıöşü]`, `\d{2}`) düşer,
+ * seçenekler (`a|b`) ayrı tutulur. Tarih kalıbı `/(Z|[+-]\d\d:?\d\d)$/` ve Türkçe harf normalleştirmesi
+ * `/[çğıöşü]/` böylece söz üretmez.
+ */
+function regexAlternatives(body) {
+    return body
+        .replace(/\[[^\]]*\]/g, '')
+        .replace(/\\[sSdDwWbBnrt]/g, '')
+        .replace(/\{\d+(?:,\d*)?\}/g, '')
+        .replace(/\\(.)/g, '$1')
+        .replace(/[\^$()[\]{}*+?.]/g, '')
+        .split('|')
+        .map(part => part.trim())
+        .filter(part => /\p{L}/u.test(part));
+}
+function classifyRegex(code, body, start, end, displayRead) {
+    return regexAlternatives(body).map(part => classify(code, part, start, end, displayRead));
+}
+function scanCode(code, offset, source) {
+    const literals = scanLiterals(code);
+    const masked = maskLiterals(code, literals);
+    const found = [];
+    for (const literal of literals) {
+        if (literal.interpolations) {
+            for (const part of literal.interpolations)
+                found.push(...scanCode(code.slice(part.start, part.end), offset + part.start, source));
+            continue;
+        }
+        if (literal.value.trim() === '')
+            continue;
+        const beforeEnd = skipSpaceBack(masked, literal.start);
+        const before = masked.slice(Math.max(0, beforeEnd - 40), beforeEnd);
+        const afterStart = skipSpaceForward(masked, literal.end);
+        const after = masked.slice(afterStart, afterStart + 3);
+        const operatorBefore = /(?:!==|===|!=|==)$/.exec(before);
+        const operatorAfter = /^(?:!==|===|!=|==)/.exec(after);
+        const method = /(?:\?\.|\.)\s*(?:includes|startsWith|endsWith|indexOf|lastIndexOf)\s*\($/.exec(before);
+        let operand;
+        if (operatorBefore) {
+            const operandEnd = skipSpaceBack(masked, beforeEnd - operatorBefore[0].length);
+            operand = code.slice(leftOperandStart(masked, operandEnd), operandEnd);
+        }
+        else if (operatorAfter) {
+            const operandStart = skipSpaceForward(masked, afterStart + operatorAfter[0].length);
+            operand = code.slice(operandStart, rightOperandEnd(masked, operandStart));
+        }
+        else if (method) {
+            const receiverEnd = beforeEnd - method[0].length;
+            operand = code.slice(leftOperandStart(masked, receiverEnd), receiverEnd);
+        }
+        else if (!/\bcase$/.test(before) && !/\bnew\s+RegExp\s*\($/.test(before)) {
+            continue;
+        }
+        if (operand !== undefined && codeSource.test(operand))
+            continue;
+        const located = classify(code, literal.value, literal.start, literal.end, operand !== undefined && readsDisplayText(operand));
+        found.push({ ...located, position: offset + located.position, ...(located.hook ? { hook: { ...located.hook, excerpt: excerptOf(source, offset + literal.start, offset + literal.end) } } : {}) });
+    }
+    for (const match of masked.matchAll(arrayMembership)) {
+        const list = match[1] ?? '';
+        const listStart = (match.index ?? 0) + match[0].indexOf(list);
+        for (const item of code.slice(listStart, listStart + list.length).matchAll(quoted)) {
+            const value = item[1] ?? item[2] ?? '';
+            const start = listStart + (item.index ?? 0);
+            const located = classify(source, value, offset + start, offset + start + item[0].length, false);
+            found.push(located);
+        }
+    }
+    // Örtülmüş metinde aranır: şablon dizesinin `${…}` gövdesindeki ifade özyinelemede bir kez sayılsın.
+    for (const match of masked.matchAll(regexTest)) {
+        const lead = match[1] ?? '';
+        const bodyStart = (match.index ?? 0) + lead.length + 1;
+        const body = code.slice(bodyStart, bodyStart + (match[2] ?? '').length);
+        const argumentStart = (match.index ?? 0) + match[0].length;
+        const argument = code.slice(argumentStart, rightOperandEnd(masked, argumentStart));
+        found.push(...classifyRegex(source, body, offset + bodyStart - 1, offset + bodyStart + body.length + 1, readsDisplayText(argument)));
+    }
+    for (const match of masked.matchAll(regexMatch)) {
+        const methodStart = match.index ?? 0;
+        const receiver = code.slice(leftOperandStart(masked, methodStart), methodStart);
+        const bodyEnd = methodStart + match[0].length - (match[0].length - match[0].lastIndexOf('/'));
+        const body = code.slice(bodyEnd - (match[1] ?? '').length, bodyEnd);
+        found.push(...classifyRegex(source, body, offset + methodStart, offset + methodStart + match[0].length, readsDisplayText(receiver)));
+    }
+    return found;
+}
+function scanSelectors(source) {
+    const found = [];
+    for (const match of source.matchAll(selectorPattern)) {
+        const value = (match.slice(1).find(group => group !== undefined) ?? '').trim();
+        if (value === '' || value.includes('{{') || value.includes('${'))
+            continue;
+        const start = match.index ?? 0;
+        // Etiket özniteliği görünen alandır: söz gibi değer kesin kanca, kod gibi tek kelime TR-006 adayı.
+        if (looksLikeWording(value))
+            found.push({ position: start, hook: { kind: 'selector', text: value, excerpt: excerptOf(source, start, start + match[0].length), certain: true } });
+        else if (isWordCandidate(value))
+            found.push({ position: start, word: value });
+    }
+    return found;
+}
+/**
+ * html içeriğinde (`<` ile başlayan dize) kod yalnız `<script>` gövdesidir: düz metindeki kesme işareti
+ * ("Kullanıcı'nın") dize başlangıcı sanılıp betiğin gerçek dizelerini kaydırmasın. Etiket kuran akış kodu
+ * (`'<div>' + x`) `<` ile başlamadığı için kod olarak taranır.
+ */
+function locate(source) {
+    const scripts = /^\s*</.test(source) ? [...source.matchAll(scriptBody)] : [];
+    const code = /^\s*</.test(source)
+        ? scripts.flatMap(match => scanCode(match[1] ?? '', (match.index ?? 0) + match[0].indexOf(match[1] ?? ''), source))
+        : scanCode(source, 0, source);
+    return [...code, ...scanSelectors(source)].sort((left, right) => left.position - right.position);
+}
+export function findTextHooks(source) {
+    return locate(source).flatMap(entry => entry.hook ? [entry.hook] : []);
+}
+export function comparedWords(source) {
+    return locate(source).flatMap(entry => entry.word ? [entry.word] : []);
+}
+function collectStrings(value, into = []) {
+    if (typeof value === 'string')
+        into.push(value);
+    else if (Array.isArray(value))
+        for (const entry of value)
+            collectStrings(entry, into);
+    else if (value && typeof value === 'object')
+        for (const entry of Object.values(value))
+            collectStrings(entry, into);
+    return into;
+}
+function colorMapValues(value, into = []) {
+    if (Array.isArray(value)) {
+        for (const entry of value)
+            colorMapValues(entry, into);
+    }
+    else if (value && typeof value === 'object') {
+        for (const [key, entry] of Object.entries(value)) {
+            if (key === 'colorMap' && Array.isArray(entry)) {
+                for (const item of entry) {
+                    const mapped = item && typeof item === 'object' ? item.value : undefined;
+                    if (typeof mapped === 'string' && mapped.trim() !== '')
+                        into.push(mapped);
+                }
+            }
+            else {
+                colorMapValues(entry, into);
+            }
+        }
+    }
+    return into;
+}
+export function textHooksIn(value) {
+    return [
+        ...collectStrings(value).flatMap(findTextHooks),
+        ...colorMapValues(value)
+            .filter(looksLikeDisplayText)
+            .map(text => ({ kind: 'color-map', text, excerpt: `colorMap value: '${text}'`, certain: hasForeignLetter(text) }))
+    ];
+}
+export function comparedWordsIn(value) {
+    return [...collectStrings(value).flatMap(comparedWords), ...colorMapValues(value).filter(isWordCandidate)];
+}
+function multisetDifference(before, after, key) {
+    const remaining = new Map();
+    for (const entry of before)
+        remaining.set(key(entry), (remaining.get(key(entry)) ?? 0) + 1);
+    return after.filter(entry => {
+        const left = remaining.get(key(entry)) ?? 0;
+        if (left === 0)
+            return true;
+        remaining.set(key(entry), left - 1);
+        return false;
+    });
+}
+/** Kayıtta aynı kanca kaç kez duruyorsa o kadarı eskidir; fazlası bu yazımla gelmiştir. Konuma bakmaz: adım ve düğüm sırası değişebilir. */
+export function addedHooks(before, after) {
+    return multisetDifference(before, after, hook => `${hook.kind}\u0000${hook.text}`);
+}
+export function addedWords(before, after) {
+    return multisetDifference(before, after, word => word);
+}
+function findNode(tree, elementId) {
+    if (Array.isArray(tree)) {
+        for (const entry of tree) {
+            const found = findNode(entry, elementId);
+            if (found)
+                return found;
+        }
+        return undefined;
+    }
+    if (!tree || typeof tree !== 'object')
+        return undefined;
+    const node = tree;
+    return node.elementId === elementId ? node : findNode(node.children, elementId);
+}
+const OP_AREAS = { set_validations: 'validations', set_appearance: 'appearance', set_states: 'states', set_block: 'blocks' };
+/**
+ * Micro-op yamasında "kayıtta duran" yalnız op'un EZDİĞİ değerdir: `replace_prop` / `set_prop_type` / `set_binding` için
+ * hedef düğümün o prop'u, alan op'ları için düğümün o alanı; `add_component` hiçbir şeyi ezmez. Bütün ağaç taban
+ * alınsaydı başka düğümde duran aynı metin (qm'de aynı kanca onlarca düğümde) yeni kancayı eski gösterirdi (inceleme 2026-10-16).
+ */
+export function overwrittenValues(tree, ops) {
+    return ops.flatMap(op => {
+        if (typeof op.target !== 'string' || op.op === 'add_component')
+            return [];
+        const node = findNode(tree, op.target);
+        if (!node)
+            return [];
+        if (typeof op.prop === 'string')
+            return [node.props?.[op.prop]];
+        const area = OP_AREAS[String(op.op)];
+        return area ? [node[area]] : [];
+    });
+}
+const DISPLAY_KEYS = new Set(['label', 'title', 'text', 'placeholder', 'description', 'header', 'caption', 'buttonText', 'emptyText', 'tooltip', 'subtitle', 'helperText']);
+function addDisplayText(value, into) {
+    if (typeof value === 'string') {
+        if (value.trim() !== '' && !value.includes('{{'))
+            into.add(value.trim());
+        return;
+    }
+    const wrapped = value && typeof value === 'object' && !Array.isArray(value) ? value : undefined;
+    if (wrapped && (wrapped.type === 'static' || wrapped.type === 'translation') && typeof wrapped.data === 'string')
+        addDisplayText(wrapped.data, into);
+}
+/** Barındırıcının (sayfa / layout / widget ağacı) görünen yazıları: statik metin ve çeviri bağının tasarım yedeği (`data`). Kod bağı okunmaz. */
+export function displayTextsIn(tree, into = new Set()) {
+    if (Array.isArray(tree)) {
+        for (const entry of tree)
+            displayTextsIn(entry, into);
+    }
+    else if (tree && typeof tree === 'object') {
+        const record = tree;
+        if (record.type === 'code')
+            return into;
+        for (const [key, value] of Object.entries(record)) {
+            if (DISPLAY_KEYS.has(key))
+                addDisplayText(value, into);
+            displayTextsIn(value, into);
+        }
+    }
+    return into;
+}

package/dist/platform/capture/capture.js

@@ -431,7 +431,7 @@ export class StudioScreenshotter {
                 if (state !== undefined) {
                     await page.waitForTimeout(flowSettleGraceMs);
                     const confirmed = parseReadiness(await page.evaluate(readinessScript).catch(() => undefined));
-                    if (confirmed !== undefined && !confirmed.skeleton && confirmed.href === snapshot.href && (confirmed.activity === null || confirmed.activity.running === 0)) {
+                    if (confirmed !== undefined && !confirmed.skeleton && confirmed.href === snapshot.href && (confirmed.activity === null || confirmed.activity.running === 0 || (state === 'awaiting-user' && confirmed.awaitingUser))) {
                         return { state, waitedMs: Date.now() - startedAt, snapshot: confirmed };
                     }
                     previousKey = undefined;

package/dist/platform/capture/readiness.js

@@ -22,6 +22,7 @@ export const readinessScript = `(function () { /* readinessSnapshot */
     skeleton: !!document.querySelector('.view-detail > .bx--skeleton__placeholder'),
     viewDetail: !!document.querySelector('.view-detail'),
     errorState: !!document.querySelector('.view-detail__error, .view-detail .error-page'),
+    awaitingUser: !!document.querySelector('[data-element-id="preview-biometric"]'),
     readyState: String(document.readyState),
     href: String(location.href)
   };
@@ -46,6 +47,7 @@ export function parseReadiness(raw) {
         skeleton: value.skeleton === true,
         viewDetail: value.viewDetail === true,
         errorState: value.errorState === true,
+        awaitingUser: value.awaitingUser === true,
         readyState: String(value.readyState ?? ''),
         href: value.href
     };
@@ -79,6 +81,8 @@ export function decideReadiness(snapshot, quiet, completedBefore, baselineUrl) {
         return 'ready';
     if (idle && snapshot.runtimeNodes > 0 && quiet >= quietPolls)
         return 'ready-no-flows';
+    if (snapshot.awaitingUser && snapshot.runtimeNodes > 0 && quiet >= quietPolls)
+        return 'awaiting-user';
     if (activity === null && snapshot.runtimeNodes > 0 && quiet >= legacyQuietPolls)
         return 'ready-no-counter';
     if (idle && snapshot.errorState && quiet >= quietPolls)

package/dist/platform/errors.js

@@ -73,6 +73,15 @@ function mergeHint(path) {
         return '';
     return " Üç sebepten biri: çözülmemiş çakışma, ya da plan alındığından beri DALIN veya development’ın değişmesi (MergePlanStaleException) — ikincisinde planın taşıdığı liste eskidir ve uygulansaydı sonradan yapılan iş sessizce düşerdi. merge_get ile planı yeniden okuyun (isStale), bayatsa merge_refresh ile tazeleyin — yeni plan açmanız gerekmez. Aynı merge_apply çağrısını tekrarlamak sonucu değiştirmez.";
 }
+/**
+ * `POST /microfunctions/{id}/archive/changes` iyimser kilittir: istemcinin gönderdiği expectedHash
+ * kaydın hash'i değilse hiçbir şey yazılmaz. Aynı gövdeyi tekrar göndermek sonucu değiştirmez.
+ */
+function microfunctionArchiveHint(code) {
+    if (code !== 'MicrofunctionArchiveConflictException')
+        return '';
+    return ' Arşiv siz okuduktan sonra değişti (expectedHash güncel değil) ya da iskelet istenen kayıtta arşiv zaten var. microfunction_files_list ile güncel hash\'i ve girdileri yeniden okuyun, işlemleri ona göre kurup tekrar gönderin; aynı çağrıyı tekrarlamak sonucu değiştirmez.';
+}
 function mergeRevertHint(code) {
     if (code === 'MergeRevertWindowExpiredException') {
         return " Geri alma penceresi doldu: pencere kapanınca merge öncesi anlık görüntü de silinir, bu yüzden plan artık geri alınamaz. merge_list status:'applied' ile pencere içindeki bir plan seçin.";
@@ -85,6 +94,17 @@ function mergeRevertHint(code) {
     }
     return '';
 }
+/**
+ * Şablondan kurulup güncellemeleri alan projede dal ve merge yazmaları kapalıdır (backend
+ * `CheckBranchWriteAllowedBehavior`, ADR 0022, MRG-018). Ret kalıcıdır: ajan bunu dalı ya da
+ * planı düzelterek aşamaz, değişiklik şablonun kaynak projesinden gelir. Backend 400 döner —
+ * 409 olsaydı `mergeHint` "bayat plan, merge_refresh" diye yanlış yöne gönderirdi.
+ */
+function templateSubscriptionHint(code) {
+    if (code !== 'CantBranchTemplateSubscribedProjectException')
+        return '';
+    return ' Bu proje şablon güncellemelerini alıyor; dal açma, dal silme ve merge planının hiçbir adımı bu projede yapılamaz. Değişikliği şablonun kaynak projesinde yapın, template_create ile yeni sürüm yayımlayın, bu projede template_check_updates → template_receive_updates ile alın. Aynı çağrıyı tekrarlamak sonucu değiştirmez.';
+}
 /**
  * İçe aktarma zinciri dört çağrıdır ve her hata farklı bir adıma geri gönderir: plan süresi
  * dolduysa analizden, anahtar benzersiz değilse plan gövdesinden, hata oranı yüksekse dosyanın
@@ -375,7 +395,7 @@ export function mapPlatformError(status, payload, context) {
         if (validationMessages.length > 0) {
             return new PlatformApiError(`Doğrulama hatası (${location}): ${validationMessages.join(' ; ')}. Gövde şeması için ilgili ngapps://schemas kaynağına ya da mevcut bir kaydın *_get çıktısına bakın.`, status, code);
         }
-        return new PlatformApiError(`Geçersiz istek (${location}): ${apiMessage ?? 'API gövdeyi reddetti.'}${mergeRevertHint(code)}${importHint(code, context.path)}${accessHint(code, apiMessage)}`, status, code);
+        return new PlatformApiError(`Geçersiz istek (${location}): ${apiMessage ?? 'API gövdeyi reddetti.'}${mergeRevertHint(code)}${templateSubscriptionHint(code)}${importHint(code, context.path)}${accessHint(code, apiMessage)}`, status, code);
     }
     if (status === 401) {
         // Uygulama oturumu 401'i gateway kimliğinin değil uygulama kullanıcısının sorunudur; USERNAME/PASSWORD
@@ -441,7 +461,7 @@ export function mapPlatformError(status, payload, context) {
             : '';
         const validationMessages = collectValidationMessages(body);
         const detail = validationMessages.length > 0 ? ` → ${validationMessages.join(' ; ')}` : '';
-        const rejected = new PlatformApiError(`İş kuralı reddetti (${location}): ${apiMessage ?? 'çakışma'}${code ? ` [${code}]` : ''}${detail}${projectConflictHint}${pageSchemaHint(code, context.path)}${processHint(code, context.path)}${bulkRowHint(code)}${importHint(code, context.path)}${versionConflictHint(code, context.path)}${mergeHint(context.path)}${accessHint(code, apiMessage)}`, status, code);
+        const rejected = new PlatformApiError(`İş kuralı reddetti (${location}): ${apiMessage ?? 'çakışma'}${code ? ` [${code}]` : ''}${detail}${projectConflictHint}${pageSchemaHint(code, context.path)}${processHint(code, context.path)}${bulkRowHint(code)}${importHint(code, context.path)}${versionConflictHint(code, context.path)}${mergeHint(context.path)}${accessHint(code, apiMessage)}${microfunctionArchiveHint(code)}`, status, code);
         if (typeof body.rowIndex === 'number')
             rejected.rowIndex = body.rowIndex;
         return rejected;

package/dist/prompts/mobilePublish.js

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+import { readKnowledgeFile } from '../resources/knowledge.js';
+export const MOBILE_PUBLISH_PROMPT = 'mobile_publish_prepare';
+/**
+ * Yayınla 3 · Test sürümü ve 4 · Yayına hazırla adımlarının iş tarifi (ADR 0003). Metin `resources/prompts/` altındadır; burada yalnız argüman
+ * şeması ve yerleştirme durur. İkinci prompt gelince kayıt genel bir döngüye taşınır.
+ */
+export function renderMobilePublishPrompt(applicationId) {
+    return readKnowledgeFile('prompts', 'mobile-publish-prepare.md').replaceAll('{{applicationId}}', applicationId);
+}
+export function registerMobilePublishPrompt(server) {
+    server.registerPrompt(MOBILE_PUBLISH_PROMPT, {
+        title: 'Mobil uygulamayı yayına hazırla',
+        description: "Studio › Yayınla 3 · Test sürümü (kimlik ve sürüm, hesaplar, test ön kontrolü) ve 4 · Yayına hazırla (mağaza metinleri, ekran görüntüleri, yaş anketi, gizlilik adresi, beyanlar, sürüm ve fiyat) adımlarını zeyrek-ai araçlarıyla doldurur; beyanı yalnız kullanıcı onayıyla işaretler, gizli bilgi girmez, ön kontrolü dryRun koşar, test derlemesini yalnız kullanıcı isterse başlatır ve insana kalan işi listeler.",
+        argsSchema: {
+            applicationId: z.string().trim().min(1).describe("Mobil uygulamanın id'si (application_list / mobile_app_create çıktısı)")
+        }
+    }, ({ applicationId }) => ({
+        messages: [{ role: 'user', content: { type: 'text', text: renderMobilePublishPrompt(applicationId) } }]
+    }));
+}