zames_pro 2.6.0 → 2.7.0

package/dist/input.js

@@ -1,34 +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 отправляет, но если курсор стоит сразу
-//     после «\», Enter удаляет «\» и переносит строку (как в Claude Code).
-//     Ctrl+J, Ctrl+Enter и 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 — стоп');
@@ -40,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;
@@ -82,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;
@@ -98,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;
@@ -149,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 = [] } = {}) {
@@ -180,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('/'))
@@ -192,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)
@@ -236,9 +236,9 @@ export class LineEditor {
         if (stdin.setRawMode)
             stdin.setRawMode(this._wasRaw || false);
     }
-    // Временно отдать терминал внешнему UI (например, меню /config):
-    // снимаем свой обработчик ввода и стираем блок ввода, чтобы чужой вывод
-    // не накладывался на строку ввода. Парно с resume().
+    // 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();
@@ -263,7 +263,7 @@ export class LineEditor {
         this.promptStr = str;
         this._render();
     }
-    // Обновить описания slash-команд (смена языка интерфейса).
+    // Update slash-command descriptions (interface language change).
     setCommands(commands) {
         this.slashCommands = commands;
         this._render();
@@ -273,7 +273,7 @@ export class LineEditor {
         this.cursor = 0;
         this._render();
     }
-    // ---------- отрисовка ----------
+    // ---------- rendering ----------
     _eraseBlock() {
         if (!this.rendered)
             return;
@@ -289,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;
@@ -314,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)
@@ -330,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();
@@ -348,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() {
@@ -399,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);
         }
@@ -428,9 +433,9 @@ export class LineEditor {
         this.buf = next.join('');
         this.cursor += ins.length;
     }
-    // Вставить перевод строки. Если курсор стоит сразу после символа «\»
-    // (как в Claude Code), символ удаляется — чтобы «\» + Enter давали
-    // обычный перенос без лишней обратной косой черты в тексте.
+    // 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] === '\\') {
@@ -477,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);
@@ -521,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;
@@ -532,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;
@@ -542,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;
@@ -554,7 +559,7 @@ export class LineEditor {
         this.buf = chars.join('');
         this.cursor = i;
     }
-    // ---------- история ----------
+    // ---------- history ----------
     _historyUp() {
         if (!this.history.length)
             return;
@@ -612,8 +617,8 @@ export class LineEditor {
                 }
                 continue;
             }
-            // Shift+Enter, Ctrl+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._insertNewline();
                 s = s.slice(7);
@@ -647,10 +652,10 @@ export class LineEditor {
             const ch = s[0];
             const code = s.charCodeAt(0);
             s = s.slice(1);
-            // Enter: если предыдущий символ — «\», Claude-Code-стиль: удаляем
-            // «\» и переносим строку; иначе отправляем сообщение.
-            // Ctrl+J (code 10) всегда вставляет перевод строки; Ctrl+Enter
-            // (ESC[13;5u) и Shift+Enter тоже.
+            // 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 === '\\') {
@@ -703,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)
@@ -720,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);
@@ -746,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
@@ -782,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);
@@ -808,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.`;

package/dist/sessions.js

@@ -1,10 +1,10 @@
 import fs from 'fs';
 import path from 'path';
 import os from 'os';
-// Сессии (чаты DeepSeek) храним в отдельной папке, чтобы они не терялись
-// после перезапуска процесса. Каждая сессия — отдельный JSON-файл
-// <id>.json в ~/.zames/.sessions. last.json указывает на последнюю
-// открытую сессию для конкретной рабочей директории.
+// We store sessions (DeepSeek chats) in a separate folder so they aren't lost
+// after a process restart. Each session is a separate JSON file
+// <id>.json in ~/.zames/.sessions. last.json points to the last
+// opened session for a specific working directory.
 const SESSIONS_DIR = path.join(os.homedir(), '.zames', '.sessions');
 const INDEX_FILE = path.join(SESSIONS_DIR, 'last.json');
 function ensureDir() {
@@ -13,8 +13,8 @@ function ensureDir() {
 function safeName(id) {
     return String(id).replace(/[^a-zA-Z0-9_.-]/g, '_');
 }
-// Сохраняем/обновляем сессию. workdir нужен, чтобы при запуске из того же
-// проекта восстанавливать именно его последний чат.
+// Save/update a session. workdir is needed so that when launched from the same
+// project we restore exactly its last chat.
 export function saveSession({ id, title = '', workdir = '', }) {
     if (!id)
         return null;
@@ -63,16 +63,16 @@ function writeIndex({ id, workdir }) {
     }
     catch { }
 }
-// Последняя сессия для рабочей директории. Если для неё ничего нет —
-// возвращаем последнюю сессию вообще (полезно при запуске из нового места).
+// The last session for the working directory. If there is none —
+// we return the last session overall (useful when launched from a new place).
 export function loadLastSession(workdir = '') {
     try {
         const index = JSON.parse(fs.readFileSync(INDEX_FILE, 'utf-8'));
         const byWorkdir = index && index.byWorkdir ? index.byWorkdir : {};
         const candidates = [byWorkdir[workdir], index.last].filter((x) => Boolean(x));
         for (const id of candidates) {
-            // Файл сессии мог быть удалён — индекс тогда устарел, и сессию
-            // восстанавливать нельзя. Пробуем следующий кандидат.
+            // The session file may have been deleted — the index is then stale and
+            // the session cannot be restored. We try the next candidate.
             const s = readSession(id);
             if (s)
                 return s;
@@ -94,7 +94,7 @@ export function readSession(id) {
         return null;
     }
 }
-// Список всех сессий, свежие — первыми.
+// List all sessions, newest first.
 export function listSessions() {
     try {
         ensureDir();