zames_pro 2.64.0 → 2.65.0

package/CHANGELOG.md

@@ -7,6 +7,50 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.65.0] - 2026-10-07
+
+### Changed
+
+- README-скриншот `docs/demo.png` перегенерирован на английском языке
+  (раньше был на русском). Воспроизводимый генератор
+  `npm run render-demo` (`scripts/render-demo.mjs`) рендерит реальную
+  раскладку редактора и палитру темы через headless Chromium с
+  изолированным профилем.
+- README: ASCII-схема «как это работает» заменена на диаграмму Mermaid
+  (стрелки не «плывут») плюс текстовое описание словами.
+- Убраны неиспользуемые файлы: `logo.jpg` (в README используется только
+  `logo-small.jpg`) и заготовка `docs/demo.tape` (VHS-рендер так и не был
+  сгенерирован). `logo.jpg` удалён и из списка `files` в package.json.
+
+### Fixed
+
+- Перерисовка терминала после ресайза окна: относительный стирающий
+  `ESC[n A` после изменения размера попадал на устаревшую строку (терминал
+  переформатировал переносы), из-за чего статус/инпут рисовались не там.
+  Теперь после ресайза блок заново «прибивается» к низу (home + padding),
+  история скроллбэка сохраняется. Тест в `test/terminal-drift.test.ts`.
+- Живая смена языка (`/config lang`) не доходила до двух «одноразово
+  созданных» объектов: спиннер думающих фраз брал язык по умолчанию
+  (`randomThinkingPhrase()` вместо `randomThinkingPhrase(this.locale)`),
+  а `DeepSeekBrowser` печатал свои уведомления (`ds.*`) на языке,
+  зафиксированном при старте. Из-за этого при английском UI всплывали
+  русские «Структурирую мысли…» и «⏳ DeepSeek оборвал ответ…». Добавлен
+  `DeepSeekBrowser.setLocale()`, вызываемый из `setConfigRuntime`.
+- Меню `/config` теперь рисуется ОКНОМ по высоте терминала (раньше весь
+  список из 49 полей выводился одним блоком). На невысоком терминале блок
+  уходил верхними строками за экран, из-за чего восстановление курсора
+  `ESC[lastRows A` попадало не на ту строку и навигация стрелками «не
+  скроллила» список. Заодно исправлена мёртвая регулярка снятия ANSI
+  (лишний обратный апостроф) в `src/config-menu.ts`.
+
+## [2.64.1] - 2026-10-07
+
+### Changed
+
+- README: добавлен скриншот терминальной сессии (`docs/demo.png`) под
+  шапкой, чтобы интерфейс был виден сразу; скрипт воспроизводимого
+  VHS-демо (`docs/demo.tape`) для будущего GIF.
+
 ## [2.64.0] - 2026-10-06
 
 ### Added
@@ -348,7 +392,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Session banner warns when no saved DeepSeek session exists.
 - `--no-color` flag (explicit `NO_COLOR`).
 
-[Unreleased]: https://github.com/Viqto0r/zames_pro/compare/v2.64.0...HEAD
+[Unreleased]: https://github.com/Viqto0r/zames_pro/compare/v2.64.1...HEAD
+[2.64.1]: https://github.com/Viqto0r/zames_pro/compare/v2.64.0...v2.64.1
 [2.64.0]: https://github.com/Viqto0r/zames_pro/compare/v2.63.1...v2.64.0
 [2.63.1]: https://github.com/Viqto0r/zames_pro/compare/v2.63.0...v2.63.1
 [2.63.0]: https://github.com/Viqto0r/zames_pro/compare/v2.61.0...v2.63.0

package/README.md

@@ -23,24 +23,29 @@ directory, reads and edits files, runs commands, and commits to git.
 > No API key required — it drives the DeepSeek web chat like a regular user
 > through a real (headless) browser.
 
+<p align="center">
+  <img src="https://raw.githubusercontent.com/Viqto0r/zames_pro/master/docs/demo.png" alt="zames session in the terminal" width="860">
+</p>
+
 ## How it works
 
 zames does not call the model API. It launches a headless Chromium with a
 persistent profile, signs in to `chat.deepseek.com` like a human, types the task
 into the chat box, and reads the answer back.
 
+```mermaid
+flowchart LR
+    U["terminal (you)"] -->|"task"| Z["zames"]
+    Z -->|"system prompt + task"| D["chat.deepseek.com"]
+    D -->|"model answers (raw SSE)"| Z
+    Z -->|"parse tool-call"| Z
+    Z -->|"run tool: Read/Edit/Bash/…"| Z
+    Z -->|"answer"| U
 ```
- terminal (you)                 zames                          chat.deepseek.com
- ───────────────                ─────                          ─────────────────
-   task ──────────────────────▶ system prompt + task ────────▶  browser types it
-                                       ▲                              │
-                                       │                        model answers
-                                       │                              │
-   answer  ◀──── render ◀─────  parse tool-call  ◀──── raw answer ◀────┘
-                                       │
-                                       ▼
-                         run tool (Read/Edit/Bash/…) → feed result back
-```
+
+In text: you type a task → zames sends the system prompt plus the task into
+the DeepSeek web chat → the model answers → zames parses the tool call, runs
+the tool locally, feeds the result back, and prints the final answer for you.
 
 Key pieces:
 

package/dist/backlog.js

@@ -15,6 +15,26 @@ const NEW_ITEM_PREFIX = 'N';
 // worth, so the operator is nudged to collapse it.
 export const BACKLOG_WARN_LINES = 500;
 export const BACKLOG_WARN_CHARS = 60_000;
+// Parse a `/backlog <text>` note into the shape appendBacklogItem() wants. An
+// optional leading `P0..P3` token sets the priority; the first line becomes the
+// title and the rest the body. PURE so the operator's note is placed exactly as
+// shown — no model round-trip, no chance of a different id than the one printed.
+export function parseBacklogNote(note) {
+    const raw = String(note ?? '');
+    let priority = 'P2';
+    let body = raw;
+    for (const p of ['P0', 'P1', 'P2', 'P3']) {
+        if (raw.toUpperCase().startsWith(p + ' ')) {
+            priority = p;
+            body = raw.slice(p.length + 1);
+            break;
+        }
+    }
+    const bodyLines = body.split(NL);
+    const title = bodyLines[0];
+    const rest = bodyLines.slice(1).join(NL).trim();
+    return { priority, title, note: rest || undefined };
+}
 function squashBlankLines(lines) {
     const out = [];
     let blanks = 0;

package/dist/browser.js

@@ -550,6 +550,17 @@ export class DeepSeekBrowser {
     _t(key, params) {
         return translate(this.locale)(key, params);
     }
+    /**
+     * Switch the language of the messages the browser itself prints (login
+     * prompts, DeepSeek-side notices from `_notice()`). The browser is created
+     * ONCE at startup, so without this a `/config lang` change would leave every
+     * later notice in the OLD language until a restart — the operator saw
+     * Russian "⏳ DeepSeek оборвал ответ…" while the UI was set to English.
+     */
+    setLocale(locale) {
+        if (locale)
+            this.locale = locale;
+    }
     // A service notice for the operator. When a UI hook is wired (LineEditor is
     // active during a task) the notice goes ABOVE the input line so it is not
     // overwritten by the editor's repaint; otherwise it falls back to stderr.

package/dist/commands.js

@@ -951,3 +951,84 @@ export function buildReviewPrompt(focus, hasStaged = false) {
         s += NL + 'Extra focus: ' + f;
     return s;
 }
+// The canonical list. Dev-only entries are filtered by buildSlashCommandHints()
+// unless dev mode is on (DEV_ONLY_COMMANDS above), so a regular install never
+// advertises them.
+export const SLASH_COMMANDS = [
+    { name: '/help', key: 'help.cmd.help' },
+    { name: '/new', key: 'help.cmd.new' },
+    { name: '/clear', key: 'help.cmd.new' },
+    { name: '/sessions', key: 'help.cmd.sessions' },
+    { name: '/chats', key: 'help.cmd.chats' },
+    { name: '/resume', key: 'help.cmd.resume' },
+    { name: '/resume-id', key: 'help.cmd.resume_id' },
+    { name: '/last', key: 'help.cmd.last' },
+    { name: '/retry', key: 'help.cmd.retry' },
+    { name: '/rename', key: 'help.cmd.rename' },
+    { name: '/context', key: 'help.cmd.context' },
+    { name: '/copy', key: 'help.cmd.copy' },
+    { name: '/chat', key: 'help.cmd.chat' },
+    { name: '/cd', key: 'help.cmd.cd' },
+    { name: '/pwd', key: 'help.cmd.pwd' },
+    { name: '/status', key: 'help.cmd.status' },
+    { name: '/reload', key: 'help.cmd.reload' },
+    { name: '/undo', key: 'help.cmd.undo' },
+    { name: '/undo-list', key: 'help.cmd.undo_list' },
+    { name: '/rewind', key: 'help.cmd.rewind' },
+    { name: '/rewind-list', key: 'help.cmd.rewind_list' },
+    { name: '/transcript', key: 'help.cmd.transcript' },
+    { name: '/diff', key: 'help.cmd.diff' },
+    { name: '/diffstat', key: 'help.cmd.diffstat' },
+    { name: '/cost', key: 'help.cmd.cost' },
+    { name: '/export', key: 'help.cmd.export' },
+    { name: '/doctor', key: 'help.cmd.doctor' },
+    { name: '/add-dir', key: 'help.cmd.add_dir' },
+    { name: '/review', key: 'help.cmd.review' },
+    { name: '/improve', key: 'help.cmd.improve' },
+    { name: '/backlog', key: 'help.cmd.backlog' },
+    { name: '/goal', key: 'help.cmd.goal' },
+    { name: '/loop', key: 'help.cmd.loop' },
+    { name: '/cron', key: 'help.cmd.cron' },
+    { name: '/jobs', key: 'help.cmd.jobs' },
+    { name: '/thinking', key: 'help.cmd.thinking' },
+    { name: '/web', key: 'help.cmd.web' },
+    { name: '/plan', key: 'help.cmd.plan' },
+    { name: '/compact', key: 'help.cmd.compact' },
+    { name: '/queue', key: 'help.cmd.queue' },
+    { name: '/tasks', key: 'help.cmd.tasks' },
+    { name: '/config', key: 'help.cmd.config' },
+    { name: '/skills', key: 'help.cmd.skills' },
+    { name: '/memory', key: 'help.cmd.memory' },
+    { name: '/remember', key: 'help.cmd.remember' },
+    { name: '/init', key: 'help.cmd.init' },
+    { name: '/mcp', key: 'help.cmd.mcp' },
+    { name: '/debug-dom', key: 'help.cmd.debug_dom' },
+    { name: '/self-review', key: 'help.self.review' },
+    { name: '/self-fix', key: 'help.self.fix' },
+    { name: '/self-done', key: 'help.self.done' },
+    { name: '/self-list', key: 'help.self.list' },
+    { name: '/self-diff', key: 'help.self.diff' },
+    { name: '/self-apply', key: 'help.self.apply' },
+    { name: '/exit', key: 'help.cmd.exit' },
+    { name: '/quit', key: 'help.cmd.exit' },
+];
+// Build the localized hint list from the built-in table plus the dynamic
+// skills/custom commands discovered for the current workdir. PURE: the caller
+// passes `t` and the data; nothing here touches the terminal or the editor.
+// Dev-only commands are dropped unless `devMode`; a dynamic entry whose name
+// clashes with a built-in (case-insensitive) is skipped, so a skill cannot
+// shadow /help.
+export function buildSlashCommandHints(opts) {
+    const { devMode, t } = opts;
+    const table = opts.commands ?? SLASH_COMMANDS;
+    const base = table
+        .filter((c) => devMode || !isDevOnlyCommand(c.name))
+        .map((c) => ({ name: c.name, description: t(c.key) }));
+    const known = new Set(base.map((c) => c.name.toLowerCase()));
+    for (const d of opts.dynamic ?? []) {
+        if (known.has(d.name.toLowerCase()))
+            continue;
+        base.push(d);
+    }
+    return base;
+}

package/dist/config-menu.js

@@ -11,9 +11,11 @@
 import { theme } from './theme.js';
 import { visLen } from './input.js';
 const ESC = String.fromCharCode(27);
-// Strip ANSH sequences to compute the visible length of a line.
-function stripAnsi(s) {
-    return s.replace(/\x1b\`[0-9;?]*[A-Za-z]/g, '');
+// Strip ANSI sequences to compute the visible length of a line. (A module-
+// level name distinct from input.ts's internal helper; the old regex had a
+// stray backtick and never matched a real CSI, so visCols was over-counted.)
+function stripAnsiLocal(s) {
+    return s.replace(/\x1b\[[0-9;?]*[A-Za-z]/g, '');
 }
 // Visible COLUMNS of a line (ANSI removed, wide chars counted as 2). Using the
 // code-point count made the block height disagree with the real screen on lines
@@ -21,7 +23,7 @@ function stripAnsi(s) {
 // duplicated. A row that fills the terminal exactly also triggers autowrap on
 // some terminals, so we keep one column free here as the editor does.
 function visCols(s) {
-    return visLen(stripAnsi(s));
+    return visLen(stripAnsiLocal(s));
 }
 function displayValue(field, value, t) {
     if (value === undefined)
@@ -51,6 +53,11 @@ export function runConfigMenu(opts) {
     }
     // cursor indexes the VISIBLE (filtered) list, not the full `fields`.
     let cursor = 0;
+    // Index of the first VISIBLE field drawn. The menu is WINDOWED so the whole
+    // block always fits the terminal height; otherwise a block taller than the
+    // screen scrolled the top rows off and the `ESC[lastRows A` cursor restore
+    // landed on the wrong line, so arrow-key navigation did not scroll the list.
+    let scrollTop = 0;
     let editing = false;
     let editBuf = '';
     // Reverse/forward filter over the list (/ to enter, typing narrows it).
@@ -102,22 +109,78 @@ export function runConfigMenu(opts) {
     // start of the block via relative moves so we don't spawn blank lines.
     let lastRows = 0;
     const render = () => {
-        const lines = [];
         const vis = visible();
         if (cursor >= vis.length)
             cursor = Math.max(0, vis.length - 1);
+        // Trailing block (below the list): the edit/filter prompt or the hints.
+        const tail = [''];
+        if (editing) {
+            tail.push(theme.user(t('cfg.menu.edit_hint')));
+            tail.push(theme.prompt('\u276f ') + editBuf);
+        }
+        else if (filterMode) {
+            tail.push(theme.user(t('cfg.menu.filter_hint')));
+            tail.push(theme.prompt('\u276f ') + filterQuery);
+        }
+        else if (message) {
+            tail.push(theme.assistant(message));
+        }
+        else if (filterQuery) {
+            tail.push(theme.dim(t('cfg.menu.filter_active', { q: filterQuery }) +
+                '  ' +
+                t('cfg.menu.hint')));
+        }
+        else {
+            tail.push('  ' + theme.dim(t('cfg.menu.hint')));
+            tail.push('  ' + theme.dim(t('cfg.menu.filter_hint')));
+        }
+        // How many ITEM rows (fields + group headers) fit: terminal height minus
+        // the title and the trailing block, with one spare row. This is what keeps
+        // the block from scrolling off the top on a long list.
+        const termRows = output.rows || 24;
+        // Bias one row to the SAFE side (a spare blank row is harmless, a block
+        // that overflows scrolls the top away and breaks the cursor restore).
+        const maxItemRows = Math.max(3, termRows - 2 - tail.length);
+        // WINDOW over the fields: keep the cursor inside [scrollTop, +maxItemRows).
+        // Because a group header also consumes a row we use the cursor index as the
+        // primary bound and let the header be counted when the first shown field
+        // starts a new group (a rare one-row overshoot is harmless — a spare row is
+        // reserved above).
+        if (cursor < scrollTop)
+            scrollTop = cursor;
+        if (cursor >= scrollTop + maxItemRows)
+            scrollTop = cursor - maxItemRows + 1;
+        const maxTop = Math.max(0, vis.length - maxItemRows);
+        if (scrollTop > maxTop)
+            scrollTop = maxTop;
+        if (scrollTop < 0)
+            scrollTop = 0;
+        const start = scrollTop;
+        const lines = [];
         // Title with a position counter ("Settings — 12/49") so the operator knows
         // how far down a long list they are; a filter narrows both numbers.
         const pos = vis.length ? '  ' + (cursor + 1) + '/' + vis.length : '';
         lines.push(theme.bold(t('cfg.menu.title')) + theme.dim(pos));
+        // Group headers also consume a row, so we stop as soon as the item-row
+        // budget is used up (the window is advisory; this is the hard cap that
+        // guarantees the block fits the terminal).
+        let itemRows = 0;
         let lastGroup = '';
-        for (let i = 0; i < vis.length; i++) {
+        for (let i = start; i < vis.length; i++) {
             const f = vis[i];
             const g = groupLabel(f, t);
-            if (g !== lastGroup) {
+            // Always print the header for the FIRST shown row, so a windowed list
+            // still tells the operator which section it starts in.
+            if (i === start || g !== lastGroup) {
+                if (itemRows >= maxItemRows)
+                    break;
                 lines.push(g);
                 lastGroup = g;
+                itemRows++;
             }
+            if (itemRows >= maxItemRows)
+                break;
+            itemRows++;
             const selected = i === cursor;
             const marker = selected ? theme.prompt('\u276f ') : '  ';
             const label = selected
@@ -132,32 +195,7 @@ export function runConfigMenu(opts) {
         if (!vis.length) {
             lines.push(theme.dim('  ' + t('cfg.menu.no_match')));
         }
-        if (editing) {
-            lines.push('');
-            lines.push(theme.user(t('cfg.menu.edit_hint')));
-            lines.push(theme.prompt('\u276f ') + editBuf);
-        }
-        else if (filterMode) {
-            lines.push('');
-            lines.push(theme.user(t('cfg.menu.filter_hint')));
-            lines.push(theme.prompt('\u276f ') + filterQuery);
-        }
-        else if (message) {
-            lines.push('');
-            lines.push(theme.assistant(message));
-        }
-        else {
-            lines.push('');
-            if (filterQuery) {
-                lines.push(theme.dim(t('cfg.menu.filter_active', { q: filterQuery }) +
-                    '  ' +
-                    t('cfg.menu.hint')));
-            }
-            else {
-                lines.push('  ' + theme.dim(t('cfg.menu.hint')));
-                lines.push('  ' + theme.dim(t('cfg.menu.filter_hint')));
-            }
-        }
+        lines.push(...tail);
         // Erase the previous block and print the new one. We count VISUAL lines
         // (accounting for wrapping by terminal width), otherwise on narrow
         // terminals you get "garbage" from unerased tails.