zames_pro 2.5.1 → 2.7.0

package/dist/input.js

@@ -1,32 +1,34 @@
 import { theme } from './theme.js';
 import { renderMarkdown } from './markdown.js';
 import { randomThinkingPhrase, stripEllipsis } from './spinner.js';
-// Постоянная строка ввода внизу терминала + область статуса/вывода над ней.
+// A permanent input line at the bottom of the terminal + a status/output area above it.
 //
-// Зачем свой редактор:
-//   * строка ввода видна ВСЕГДА и не затирается выводом агента;
-//   * спиннер/статус и ответы печатаются ВЫШЕ строки ввода (printAbove);
-//   * перерисовка учитывает перенос по ширине терминала, поэтому нет
-//     дублирования строк при многострочном вводе;
-//   * многострочный ввод: Enter отправляет, Ctrl+J (и Shift+Enter в
-//     терминалах с расширенным протоколом) вставляют перевод строки;
-//   * перенос длинных строк по словам (слово не рвётся посередине);
-//   * перемещение по словам: Ctrl+←/→ (и Alt+B/Alt+F), удаление слова
-//     Ctrl+W; Ctrl+K — удалить до конца строки;
-//   * история введённых сообщений: ↑/↓ на краях ввода (внутри многострочного
-//     ввода стрелки двигают по строкам, как в обычном терминале);
-//   * подсказки slash-команд: при вводе «/» под строкой показываются
-//     подходящие команды с описанием, Tab — дополнить.
+// Why a custom editor:
+//   * the input line is ALWAYS visible and is not overwritten by the agent's output;
+//   * the spinner/status and answers are printed ABOVE the input line (printAbove);
+//   * redraw accounts for wrapping by terminal width, so there is no
+//     line duplication on multiline input;
+//   * multiline input: Enter sends, but if the cursor is right after a «\»,
+//     Enter removes the «\» and breaks the line (like in Claude Code).
+//     Ctrl+J, Ctrl+Enter and Shift+Enter (in terminals with the extended
+//     protocol) always insert a newline;
+//   * long lines wrap by words (a word is not split in the middle);
+//   * word movement: Ctrl+←/→ (and Alt+B/Alt+F), word deletion
+//     Ctrl+W; Ctrl+K — delete to end of line;
+//   * input history: ↑/↓ at the edges of the input (inside multiline
+//     input the arrows move by lines, like in a normal terminal);
+//   * slash-command hints: when you type «/», matching commands with
+//     descriptions are shown below the line, Tab completes.
 //
-// Все управляющие символы собираются из кодов, чтобы в файле не было
-// «сырых» ESC/CR/LF в строковых литералах (см. AGENTS.md).
+// All control characters are assembled from codes so the file has no
+// "raw" ESC/CR/LF in string literals (see AGENTS.md).
 const NL = String.fromCharCode(10);
 const CR = String.fromCharCode(13);
 const ESC = String.fromCharCode(27);
 const PASTE_START = ESC + '[200~';
 const PASTE_END = ESC + '[201~';
-// Анимация точек: старт с пустой строки (0 точек), затем рост.
-// Ширину выравниваем по максимуму (3), чтобы подсказка не смещалась.
+// Dot animation: start from an empty string (0 dots), then grow.
+// We align the width to the maximum (3) so the hint doesn't shift.
 const DOTS = ['', '.', '..', '...'];
 const DOTS_PAD = '   ';
 const HINT = theme.dim('  ·  Esc — стоп');
@@ -38,15 +40,15 @@ function safeJson(v) {
         return String(v);
     }
 }
-// Сколько визуальных строк занимает текст при данной ширине терминала
-// (с учётом переноса). Нужно, чтобы курсор/стирание блока не сбивались,
-// когда статус длиннее ширины терминала и переносится на 2+ строки.
+// How many visual lines the text occupies at the given terminal width
+// (accounting for wrapping). Needed so the cursor/block erase don't drift
+// when the status is longer than the terminal width and wraps onto 2+ lines.
 export function visRows(s, cols) {
     const width = Math.max(1, Number(cols) || 80);
     const len = visLen(s);
     return Math.max(1, Math.ceil(len / width));
 }
-// Видимая длина строки без ANSI-последовательностей.
+// Visible length of a line without ANSI sequences.
 export function visLen(s) {
     s = String(s);
     let n = 0;
@@ -80,13 +82,13 @@ export function layoutInput(promptStr, buf, cursor, cols) {
         const prefix = first ? promptStr : pad;
         const avail = Math.max(1, width - promptW);
         const start = i;
-        // Собираем очередную визуальную строку. Сначала набираем столько
-        // символов, сколько влезает (count < avail). Если упёрлись в ширину
-        // и следующий символ — не конец строки, откатываемся к последнему
-        // пробелу, чтобы не разрывать слово посередине (word-wrap).
+        // Build the next visual line. First we take as many
+        // characters as fit (count < avail). If we hit the width
+        // and the next character is not the end of the line, we roll back to the
+        // last space so we don't split a word in the middle (word-wrap).
         let text = '';
         let count = 0;
-        let lastSpace = -1; // индекс пробела в text (по Array.from)
+        let lastSpace = -1; // index of the space in text (by Array.from)
         while (i < chars.length && chars[i] !== NL && count < avail) {
             if (chars[i] === ' ')
                 lastSpace = count;
@@ -96,7 +98,7 @@ export function layoutInput(promptStr, buf, cursor, cols) {
         }
         const atLineEnd = i >= chars.length || chars[i] === NL;
         if (!atLineEnd && count >= avail && lastSpace > 0) {
-            // Переносим «хвост» строки на следующую визуальную строку.
+            // Move the "tail" of the line to the next visual line.
             const textChars = Array.from(text);
             const tailLen = textChars.length - lastSpace;
             i -= tailLen;
@@ -147,11 +149,11 @@ export class LineEditor {
     _thinkBase;
     _wasRaw;
     _onData;
-    // История отправленных сообщений (для стрелок вверх/вниз).
+    // History of sent messages (for the up/down arrows).
     history;
     _histIndex;
     _histDraft;
-    // Подсказки slash-команд (показываются при вводе «/»).
+    // Slash-command hints (shown when you type «/»).
     slashCommands;
     _suggestCount;
     constructor({ prompt = '> ', commands = [] } = {}) {
@@ -178,9 +180,9 @@ export class LineEditor {
         this.slashCommands = commands;
         this._suggestCount = 0;
     }
-    // Список подсказок для текущего ввода. Показываем, только когда строка
-    // начинается с «/» и это одно слово (без пробелов/переводов строк) — как
-    // автодополнение команд в Claude Code.
+    // List of hints for the current input. We show them only when the line
+    // starts with «/» and is a single word (no spaces/newlines) — like
+    // command completion in Claude Code.
     _suggestions() {
         const b = this.buf;
         if (!b.startsWith('/'))
@@ -190,8 +192,8 @@ export class LineEditor {
         const q = b.toLowerCase();
         return this.slashCommands.filter((c) => c.name.toLowerCase().startsWith(q));
     }
-    // Tab: дополнить команду до общего префикса; если совпадение одно —
-    // подставить его целиком и добавить пробел.
+    // Tab: complete the command up to the common prefix; if there is a single
+    // match — insert it whole and add a space.
     _completeCommand() {
         const sugg = this._suggestions();
         if (!sugg.length)
@@ -234,16 +236,44 @@ export class LineEditor {
         if (stdin.setRawMode)
             stdin.setRawMode(this._wasRaw || false);
     }
+    // Temporarily hand the terminal to an external UI (e.g. the /config menu):
+    // we detach our input handler and erase the input block so foreign output
+    // doesn't overlap the input line. Paired with resume().
+    pause() {
+        const stdin = process.stdin;
+        this._stopDots();
+        if (this.rendered)
+            this._eraseBlock();
+        stdin.removeListener('data', this._onData);
+        process.stdout.write(ESC + '[?2004l');
+    }
+    resume() {
+        const stdin = process.stdin;
+        if (!stdin.isTTY || !stdin.setRawMode)
+            return;
+        this._wasRaw = stdin.isRaw;
+        stdin.setRawMode(true);
+        stdin.resume();
+        process.stdout.write(ESC + '[?2004h');
+        stdin.on('data', this._onData);
+        this._writeBlock();
+        this._render();
+    }
     setPrompt(str) {
         this.promptStr = str;
         this._render();
     }
+    // Update slash-command descriptions (interface language change).
+    setCommands(commands) {
+        this.slashCommands = commands;
+        this._render();
+    }
     clear() {
         this.buf = '';
         this.cursor = 0;
         this._render();
     }
-    // ---------- отрисовка ----------
+    // ---------- rendering ----------
     _eraseBlock() {
         if (!this.rendered)
             return;
@@ -259,14 +289,14 @@ export class LineEditor {
         let top = 0;
         if (this.statusText) {
             out += this.statusText + NL;
-            // Статус может переноситься на несколько строк — учитываем это,
-            // иначе стирание блока промахивается и статусы «стопкой» копятся.
+            // The status may wrap onto several lines — we account for this,
+            // otherwise the block erase misses and statuses pile up.
             top = visRows(this.statusText, cols);
         }
         const lay = layoutInput(this.promptStr, this.buf, this.cursor, cols);
         out += lay.rows.map((r) => r.prefix + r.text).join(NL);
-        // Подсказки slash-команд рисуем НИЖЕ строки ввода. Курсор потом
-        // возвращаем вверх, на строку ввода, поэтому cursorRowFromTop не меняется.
+        // We draw the slash-command hints BELOW the input line. We then move the
+        // cursor back up to the input line, so cursorRowFromTop doesn't change.
         const sugg = this._suggestions();
         const shown = sugg.slice(0, 8);
         this._suggestCount = shown.length;
@@ -284,8 +314,8 @@ export class LineEditor {
         }
         process.stdout.write(out);
         const lastRow = lay.rows.length - 1;
-        // Курсор вверх: сначала на строку ввода внутри lay, затем ещё на
-        // строки подсказок (если они есть) — курсор должен стоять на вводе.
+        // Move the cursor up: first to the input line within lay, then further by
+        // the hint lines (if any) — the cursor must sit on the input.
         const linesBelow = shown.length ? shown.length + (sugg.length > shown.length ? 1 : 0) : 0;
         const up = lastRow - lay.cursorRow + linesBelow;
         if (up > 0)
@@ -300,13 +330,13 @@ export class LineEditor {
         this._eraseBlock();
         this._writeBlock();
     }
-    // Напечатать блок ВЫШЕ строки ввода и вернуть строку ввода на место.
+    // Print a block ABOVE the input line and put the input line back.
     printAbove(text) {
         this._eraseBlock();
         process.stdout.write(String(text) + NL);
         this._writeBlock();
     }
-    // ---------- интерфейс, совместимый со спиннером ----------
+    // ---------- spinner-compatible interface ----------
     setStatus(text) {
         this.statusText = text || '';
         this._render();
@@ -318,8 +348,8 @@ export class LineEditor {
         }
     }
     _dots(n) {
-        // Точки того же цвета, что и база, и фиксированной ширины — иначе
-        // подсказка справа «прыгает» при смене фазы анимации.
+        // The dots are the same color as the base and of fixed width — otherwise
+        // the hint on the right "jumps" when the animation phase changes.
         return theme.brown(DOTS[n] + DOTS_PAD.slice(DOTS[n].length));
     }
     _startThinking() {
@@ -369,14 +399,19 @@ export class LineEditor {
         const rendered = renderMarkdown(msg);
         this.printAbove(NL + theme.assistant('● Ответ') + NL + rendered + NL + theme.dim('─'.repeat(60)));
     }
-    // ---------- ввод ----------
+    // Warning to the operator (e.g. the agent stopped suspiciously).
+    // Printed above the input line without overwriting it.
+    warning(msg) {
+        this.printAbove(NL + theme.warn('⚠ ' + msg));
+    }
+    // ---------- input ----------
     _submit() {
         const text = this.buf;
         if (!text.trim()) {
             this._render();
             return;
         }
-        // В историю — только непустые и не дублирующие прошлое сообщение.
+        // Add to history only non-empty messages that don't duplicate the previous one.
         if (text.trim() && this.history[this.history.length - 1] !== text) {
             this.history.push(text);
         }
@@ -398,6 +433,18 @@ export class LineEditor {
         this.buf = next.join('');
         this.cursor += ins.length;
     }
+    // Insert a newline. If the cursor is right after a «\»
+    // (like in Claude Code), the character is removed — so «\» + Enter gives
+    // an ordinary break without a stray backslash in the text.
+    _insertNewline() {
+        const chars = Array.from(this.buf);
+        if (this.cursor > 0 && chars[this.cursor - 1] === '\\') {
+            chars.splice(this.cursor - 1, 1);
+            this.buf = chars.join('');
+            this.cursor--;
+        }
+        this._insert(NL);
+    }
     _backspace() {
         if (this.cursor <= 0)
             return;
@@ -435,9 +482,9 @@ export class LineEditor {
             i++;
         this.cursor = i;
     }
-    // Курсор на первой/последней ВИЗУАЛЬНОЙ строке (с учётом переноса).
-    // Нужно, чтобы Up/Down работали как история на краях ввода, а внутри —
-    // как перемещение по строкам, как в обычном терминале.
+    // Is the cursor on the first/last VISUAL line (accounting for wrapping).
+    // Needed so Up/Down act as history at the edges of the input, and inside —
+    // as line movement, like in a normal terminal.
     _onFirstVisualLine() {
         const cols = process.stdout.columns || 80;
         const lay = layoutInput(this.promptStr, this.buf, this.cursor, cols);
@@ -479,8 +526,8 @@ export class LineEditor {
             nextEnd++;
         this.cursor = nextStart + Math.min(col, nextEnd - nextStart);
     }
-    // Перемещение на слово назад (Ctrl+Left / Alt+B): пропускаем пробелы
-    // слева, затем идём до начала слова.
+    // Move one word back (Ctrl+Left / Alt+B): skip spaces
+    // on the left, then go to the start of the word.
     _wordLeft() {
         const chars = Array.from(this.buf);
         let i = this.cursor;
@@ -490,7 +537,7 @@ export class LineEditor {
             i--;
         this.cursor = i;
     }
-    // Перемещение на слово вперёд (Ctrl+Right / Alt+F).
+    // Move one word forward (Ctrl+Right / Alt+F).
     _wordRight() {
         const chars = Array.from(this.buf);
         let i = this.cursor;
@@ -500,7 +547,7 @@ export class LineEditor {
             i++;
         this.cursor = i;
     }
-    // Удаление слова слева (Ctrl+W / Alt+Backspace).
+    // Delete the word on the left (Ctrl+W / Alt+Backspace).
     _deleteWordLeft() {
         const chars = Array.from(this.buf);
         let i = this.cursor;
@@ -512,7 +559,7 @@ export class LineEditor {
         this.buf = chars.join('');
         this.cursor = i;
     }
-    // ---------- история ----------
+    // ---------- history ----------
     _historyUp() {
         if (!this.history.length)
             return;
@@ -570,21 +617,34 @@ export class LineEditor {
                 }
                 continue;
             }
-            // Shift+Enter в терминалах с расширенным протоколом и Alt+Enter.
+            // Shift+Enter, Ctrl+Enter in terminals with the extended protocol
+            // and Alt+Enter — insert a newline.
             if (s.startsWith(ESC + '[13;2u')) {
-                this._insert(NL);
+                this._insertNewline();
+                s = s.slice(7);
+                this._render();
+                continue;
+            }
+            if (s.startsWith(ESC + '[13;5u')) {
+                this._insertNewline();
                 s = s.slice(7);
                 this._render();
                 continue;
             }
             if (s.startsWith(ESC + '[27;2;13~')) {
-                this._insert(NL);
+                this._insertNewline();
+                s = s.slice(10);
+                this._render();
+                continue;
+            }
+            if (s.startsWith(ESC + '[27;5;13~')) {
+                this._insertNewline();
                 s = s.slice(10);
                 this._render();
                 continue;
             }
             if (s.startsWith(ESC + NL)) {
-                this._insert(NL);
+                this._insertNewline();
                 s = s.slice(2);
                 this._render();
                 continue;
@@ -592,12 +652,22 @@ export class LineEditor {
             const ch = s[0];
             const code = s.charCodeAt(0);
             s = s.slice(1);
+            // Enter: if the previous character is «\», Claude-Code style: remove
+            // the «\» and break the line; otherwise send the message.
+            // Ctrl+J (code 10) always inserts a newline; Ctrl+Enter
+            // (ESC[13;5u) and Shift+Enter too.
             if (ch === CR) {
+                const before = this.cursor > 0 ? Array.from(this.buf)[this.cursor - 1] : '';
+                if (before === '\\') {
+                    this._insertNewline();
+                    this._render();
+                    continue;
+                }
                 this._submit();
                 continue;
             }
             if (code === 10) {
-                this._insert(NL);
+                this._insertNewline();
                 this._render();
                 continue;
             }
@@ -638,7 +708,7 @@ export class LineEditor {
                 continue;
             }
             if (code === 11) {
-                // Ctrl+K — удалить от курсора до конца строки.
+                // Ctrl+K — delete from the cursor to the end of the line.
                 const arr = Array.from(this.buf);
                 let e = this.cursor;
                 while (e < arr.length && arr[e] !== NL)
@@ -655,7 +725,7 @@ export class LineEditor {
             }
             if (code === 27) {
                 // Ctrl+Left / Ctrl+Right (xterm: ESC [1;5D / ESC [1;5C;
-                // некоторые терминалы: ESC [5D / ESC [5C).
+                // some terminals: ESC [5D / ESC [5C).
                 if (s.startsWith('[1;5D') || s.startsWith('[5D')) {
                     this._wordLeft();
                     s = s.slice(s.startsWith('[1;5D') ? 5 : 3);
@@ -681,7 +751,7 @@ export class LineEditor {
                     continue;
                 }
                 if (s.startsWith('[A')) {
-                    // Вверх: на первой визуальной строке — история, иначе — строка выше.
+                    // Up: on the first visual line — history, otherwise — the line above.
                     if (this._onFirstVisualLine())
                         this._historyUp();
                     else
@@ -717,7 +787,7 @@ export class LineEditor {
                     this._render();
                     continue;
                 }
-                // Alt+B / Alt+F — перемещение по словам.
+                // Alt+B / Alt+F — word movement.
                 if (s.startsWith('b') || s.startsWith('B')) {
                     this._wordLeft();
                     s = s.slice(1);
@@ -743,7 +813,7 @@ export class LineEditor {
         }
     }
 }
-// Проверка раскладки: node src/input.js --selftest
+// Layout check: node src/input.js --selftest
 export function selftest() {
     const cases = [
         { p: '> ', b: 'hello', c: 5, w: 80 },

package/dist/markdown.js

@@ -14,7 +14,7 @@ const theme = {
     tableHeader: { color: '#9fb8d8', bold: true },
     tableCell: { color: '#d0d0d0' },
 };
-// Подсветка кода через cli-highlight (транзитивно уже есть у нас).
+// Code highlighting via cli-highlight (already present transitively).
 function highlighter(code, lang) {
     try {
         return highlight(code, {

package/dist/net-capture.js

@@ -1,14 +1,14 @@
 import fs from 'fs/promises';
 import os from 'os';
 import path from 'path';
-// Извлечение СЫРОГО текста ответа модели из сетевых данных DeepSeek.
+// Extraction of the RAW model answer text from DeepSeek's network data.
 //
-// Зачем: чтение ответа идёт из ОТРЕНДЕРЕННОГО DOM, а рендер DeepSeek
-// искажает ответ — превращает доллар-формулы в LaTeX (символ доллара
-// теряется), нормализует переводы строк, делает автолинки. Из-за этого
-// tool-call с шаблонными строками и экранированными переводами строк в
-// аргументах доходил до инструментов искажённым. Здесь мы достаём исходный
-// текст из тела сетевого ответа.
+// Why: the answer is read from the RENDERED DOM, and DeepSeek's rendering
+// distorts the answer — it turns dollar formulas into LaTeX (the dollar sign
+// is lost), normalizes newlines, and auto-links. Because of this a tool-call
+// with template strings and escaped newlines in its arguments reached the
+// tools distorted. Here we extract the original text from the network
+// response body.
 //
 // Format DeepSeek (SSE, chat.deepseek.com/api/v0/chat/completion):
 //   * startovy fragment otveta lezhit v data-chanke s uzlom v.response
@@ -36,11 +36,11 @@ function parseDataLines(body) {
     }
     return out;
 }
-// Собирает текст ответа из SSE-потока. Поддерживает два формата:
-//   * OpenAI-совместимый: choices[].delta.content (reasoning_content
-//     игнорируется — это размышления, а не ответ);
-//   * DeepSeek chat.deepseek.com: стартовый v.response.fragments[] и
-//     инкрементальные APPEND-чанки response/fragments/-1/content.
+// Assembles the answer text from the SSE stream. Supports two formats:
+//   * OpenAI-compatible: choices[].delta.content (reasoning_content
+//     is ignored — that's reasoning, not the answer);
+//   * DeepSeek chat.deepseek.com: the initial v.response.fragments[] and
+//     incremental APPEND chunks response/fragments/-1/content.
 export function extractFromSse(body) {
     let out = '';
     for (const obj of parseDataLines(body)) {
@@ -65,8 +65,8 @@ export function extractFromSse(body) {
             }
             continue;
         }
-        // Инкрементальный APPEND: p='response/fragments/-1/content' -> v=строка;
-        // последующие чанки идут с одним полем v.
+        // Incremental APPEND: p='response/fragments/-1/content' -> v=string;
+        // subsequent chunks come with a single v field.
         if (o.p === 'response/fragments/-1/content' && typeof o.v === 'string') {
             out += o.v;
             continue;
@@ -87,9 +87,9 @@ export function extractFromJson(body) {
     }
     return pickAnswerText(obj);
 }
-// Достает финальный текст ответа из узла, НЕ смешивая его с reasoning.
-// Порядок: choices/messages -> delta/message -> content; reasoning_content
-// намеренно не берем — это размышления модели, а не ответ.
+// Extracts the final answer text from a node, WITHOUT mixing it with reasoning.
+// Order: choices/messages -> delta/message -> content; reasoning_content is
+// deliberately not taken — that's the model's reasoning, not the answer.
 function pickAnswerText(node) {
     if (node == null)
         return '';
@@ -124,15 +124,15 @@ function pickAnswerText(node) {
     }
     return '';
 }
-// Универсальная попытка: сначала SSE, затем обычный JSON.
+// A universal attempt: first SSE, then regular JSON.
 export function extractAnswer(body) {
     const sse = extractFromSse(body);
     if (sse)
         return sse;
     return extractFromJson(body);
 }
-// Сохраняет тело сетевого ответа DeepSeek на диск для разбора постфактум.
-// Файлы лежат в ~/.zames/net-log — po nim видно реальный формат ответа.
+// Saves the DeepSeek network response body to disk for post-mortem analysis.
+// The files live in ~/.zames/net-log — from them the real answer format is visible.
 export async function dumpNetBody(url, body) {
     try {
         const dir = path.join(os.homedir(), '.zames', 'net-log');

package/dist/self-review.js

@@ -4,10 +4,10 @@ import { theme } from './theme.js';
 import { fileURLToPath } from 'url';
 import { ZAMES_HOME } from './config.js';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
-// Исходники для самообзора — это .ts файлы. После сборки (tsc → dist/)
-// __dirname указывает на dist, где лежат .js. Поэтому ищем каталог с
-// исходниками: либо рядом (запуск из src/ через tsx), либо в ../src
-// (запуск собранного dist/ из корня репозитория).
+// The sources for self-review are .ts files. After the build (tsc → dist/)
+// __dirname points to dist, where the .js files live. So we look for the
+// source directory: either nearby (running from src/ via tsx), or in ../src
+// (running the built dist/ from the repo root).
 function resolveSrcDir() {
     const candidates = [__dirname, path.join(__dirname, '..', 'src')];
     for (const dir of candidates) {
@@ -22,9 +22,9 @@ function resolveSrcDir() {
 }
 const SRC_DIR = resolveSrcDir();
 const SNAP_ROOT = path.join(ZAMES_HOME, 'snapshots');
-// Динамический импорт логики с timestamp — чтобы при /reload (или авто-reload)
-// self-review использовал СВЕЖИЕ tools/agent-loop, а не закэшированные при
-// первой загрузке. Иначе reload не доходил бы до зависимостей self-review.
+// Dynamic import of the logic with a timestamp — so that on /reload (or
+// auto-reload) self-review uses FRESH tools/agent-loop, not the ones cached on
+// first load. Otherwise reload wouldn't reach self-review's dependencies.
 async function loadFresh() {
     const stamp = Date.now();
     const toolsUrl = new URL('./tools.js', import.meta.url);
@@ -66,7 +66,7 @@ export async function selfReview({ browser, focus, transcript }) {
             `Проверь, что src/ не пуст и ты запускаешь агента из корня проекта.\n`));
         throw new Error('SRC_DIR пуст — нечего ревьюить');
     }
-    // Копируем package.json для контекста — чтобы агент видел зависимости
+    // Copy package.json for context — so the agent sees the dependencies
     try {
         const pkg = await fs.readFile(path.resolve(SRC_DIR, '..', 'package.json'), 'utf-8');
         await fs.writeFile(path.join(snapDir, 'package.json'), pkg, 'utf-8');
@@ -104,10 +104,10 @@ export async function selfReview({ browser, focus, transcript }) {
             console.log();
         },
     });
-    // Сохраняем отчёт
+    // Save the report
     const reportPath = path.join(snapDir, '_report.md');
     await fs.writeFile(reportPath, finalMessage || '(пусто)', 'utf-8');
-    // Считаем, что изменилось
+    // Compute what changed
     const changed = await diffFiles(SRC_DIR, snapDir);
     console.log(theme.system('─'.repeat(60)));
     console.log(theme.system(`Отчёт:       ${reportPath}`));
@@ -159,7 +159,7 @@ export async function selfApply({ name }) {
     const snapStat = await fs.stat(snapDir).catch(() => null);
     if (!snapStat)
         throw new Error(`Снапшот не найден: ${snapDir}`);
-    // Бэкап текущего src перед перезаписью
+    // Back up the current src before overwriting
     const stamp = new Date().toISOString().replace(/[:.]/g, '-');
     const backupDir = path.join(SNAP_ROOT, `backup-before-apply-${stamp}`);
     await copyDirJsFiles(SRC_DIR, backupDir);
@@ -264,16 +264,16 @@ ${focusLine}
 
 When done, respond with a markdown report as the message:
 
-## Найдено
+## Found
 - (bullet list of issues you found, with file:line if possible)
 
-## Исправлено
-- (bullet list: file — что именно изменил)
+## Fixed
+- (bullet list: file — what exactly you changed)
 
-## Не исправлено (осознанно)
+## Not fixed (deliberately)
 - (bullet list: what you left alone and why)
 
-## Проверка
+## Verification
 - (bullet list: what you verified, e.g. \`node --check\` results)
 
 Be honest and specific. If the code is fine in some area, say so.`;