zames_pro 2.63.1 → 2.64.1

package/CHANGELOG.md

@@ -5,6 +5,34 @@ All notable changes to this project are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+## [2.64.1] - 2026-10-07
+
+### Changed
+
+- README: добавлен скриншот терминальной сессии (`docs/demo.png`) под
+  шапкой, чтобы интерфейс был виден сразу; скрипт воспроизводимого
+  VHS-демо (`docs/demo.tape`) для будущего GIF.
+
+## [2.64.0] - 2026-10-06
+
+### Added
+
+- Генератор черновика CHANGELOG из conventional-commits (BACKLOG D2):
+  `npm run changelog:draft [ref]` печатает готовый блок для «Unreleased» из
+  коммитов после последнего тега (или указанного ref). Чистый модуль
+  `src/changelog.ts` (`parseConventionalCommit` / `groupCommits` /
+  `renderChangelogDraft`, покрыт тестами). Файл `CHANGELOG.md` НЕ
+  перезаписывается автоматически — черновик ревьюится вручную.
+
+### Changed
+
+- Рефакторинг (BACKLOG C3, шаг 1): разрешение путей вложения и инлайн
+  `@file`-ссылок вынесены из `src/index.ts` в `src/attach-refs.ts`
+  (`resolveAttachPath` / `inlineAtRefs`) — теперь это отдельный тестируемый
+  модуль.
+
 ## [2.63.1] - 2026-10-06
 
 ### Fixed
@@ -328,7 +356,9 @@ 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.63.1...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
 [2.61.0]: https://github.com/Viqto0r/zames_pro/compare/v2.60.0...v2.61.0

package/README.md

@@ -23,6 +23,10 @@ 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

package/dist/attach-refs.js

@@ -0,0 +1,90 @@
+import fs from 'fs/promises';
+import path from 'path';
+import { looksLikeFilePath, isImageName } from './attachments.js';
+import { extractAtFileRefs } from './path-token.js';
+// Path resolution and `@file` reference inlining (BACKLOG B5, C3).
+// Extracted from src/index.ts so the logic is unit-testable without the whole
+// CLI. This module touches only the filesystem (no browser/terminal).
+const NL = String.fromCharCode(10);
+// Resolve a pasted string into a path to an EXISTING file. Handles quoted
+// paths (drag&drop from some file managers adds quotes) and paths relative to
+// the working directory. Returns null when nothing matches.
+export async function resolveAttachPath(workdir, raw) {
+    let s = String(raw || '').trim();
+    if (!s)
+        return null;
+    if ((s.startsWith('"') && s.endsWith('"')) ||
+        (s.startsWith("'") && s.endsWith("'"))) {
+        s = s.slice(1, -1);
+    }
+    s = s.replace(/\\ /g, ' ');
+    if (!looksLikeFilePath(s) && !isImageName(s))
+        return null;
+    const candidates = path.isAbsolute(s)
+        ? [s]
+        : [
+            // Most common: relative to the project (working) directory.
+            path.resolve(workdir, s),
+            // The operator may paste a path relative to the terminal cwd (which
+            // can be the parent of the project) or copy it with the project name
+            // included, e.g. "zames_pro/tmp/image.png" while workdir is already
+            // .../zames_pro. Try both so the marker appears instead of raw text.
+            path.resolve(process.cwd(), s),
+            path.resolve(workdir, '..', s),
+        ];
+    for (const c of candidates) {
+        const st = await fs.stat(c).catch(() => null);
+        if (st && st.isFile())
+            return c;
+    }
+    return null;
+}
+// Per-file and total caps for `@path` inlining (B5). A reference should SAVE
+// round-trips, not flood the context: a huge file is truncated with a note
+// telling the agent to read the rest itself.
+export const AT_REF_FILE_CAP = 60 * 1024;
+export const AT_REF_TOTAL_CAP = 200 * 1024;
+// Inline `@path` references found in a task text (B5). Returns the augmented
+// text plus the list of files actually inlined (for the operator notice).
+// Unknown/unreadable references are left in place untouched -- they may be
+// part of the prose; we never fail the task over a missing file.
+export async function inlineAtRefs(workdir, text) {
+    const refs = extractAtFileRefs(text);
+    if (!refs.length)
+        return { text, inlined: [] };
+    const blocks = [];
+    const inlined = [];
+    let total = 0;
+    for (const ref of refs) {
+        if (total >= AT_REF_TOTAL_CAP)
+            break;
+        const file = await resolveAttachPath(workdir, ref);
+        if (!file)
+            continue;
+        let raw;
+        try {
+            raw = await fs.readFile(file, 'utf-8');
+        }
+        catch {
+            continue;
+        }
+        let body = raw;
+        let note = '';
+        if (body.length > AT_REF_FILE_CAP) {
+            body = body.slice(0, AT_REF_FILE_CAP);
+            note = NL + NL + '(truncated at ' + AT_REF_FILE_CAP + ' chars)';
+        }
+        total += body.length;
+        inlined.push(path.relative(workdir, file) || file);
+        blocks.push('### ' + ref + NL + '```' + NL + body + NL + '```' + note);
+    }
+    if (!blocks.length)
+        return { text, inlined: [] };
+    const section = NL +
+        NL +
+        '## Files referenced with @ in the task' +
+        NL +
+        NL +
+        blocks.join(NL + NL);
+    return { text: text + section, inlined };
+}

package/dist/changelog.js

@@ -0,0 +1,80 @@
+// Conventional-Commits -> CHANGELOG draft (BACKLOG D2). PURE and
+// unit-tested: the draft is built from git log OUTSIDE the release flow
+// (scripts/changelog-draft.mts), so a misparse never touches CHANGELOG.md.
+// We do NOT auto-write the file: a human (or the agent) reviews the draft
+// first -- the changelog must stay a deliberate document, not a byproduct.
+// Parse one commit SUBJECT into a conventional commit, or null when it
+// does not follow the format (a free-form subject is skipped from the draft).
+// Supported forms:
+//   feat: add X            feat(cli): add X
+//   fix!: change Y         feat!: breaking
+// Explicit breaking markers: `!` after the type/scope. A BREAKING CHANGE
+// body footer is beyond a subject-only parser (git log %s only) -- out of scope.
+export function parseConventionalCommit(subject) {
+    const s = String(subject ?? '').trim();
+    if (!s)
+        return null;
+    // <type>(<scope>)!?: <description>
+    const m = /^([a-zA-Z]+)(\(.+?\))?(!)?:\s*(.+)$/.exec(s);
+    if (!m)
+        return null;
+    const type = m[1].toLowerCase();
+    const scope = m[2] ? m[2].slice(1, -1).trim() : undefined;
+    const breaking = m[3] === '!';
+    const description = (m[4] || '').trim();
+    if (!description)
+        return null;
+    return { type, scope, breaking, description };
+}
+const KIND_BY_TYPE = {
+    feat: 'Added',
+    fix: 'Fixed',
+    perf: 'Changed',
+    refactor: 'Changed',
+    style: 'Changed',
+    revert: 'Changed',
+    remove: 'Removed',
+};
+// Types that never belong in a user-facing changelog (build/CI/internal).
+const SKIP_TYPES = new Set(['chore', 'ci', 'test', 'build', 'docs', 'internal']);
+// Group parsed commits by changelog kind. Each entry is a short
+// imperative line; a scope is prefixed as `**scope:** ` and a breaking marker
+// is appended as `(BREAKING)`. Order within a group is preserved (commit
+// order), and duplicate lines are dropped so a rebase that repeats a subject
+// does not flip the draft twice.
+export function groupCommits(forCommit) {
+    const groups = {
+        Added: [],
+        Fixed: [],
+        Changed: [],
+        Removed: [],
+    };
+    const seen = new Set();
+    for (const c of forCommit || []) {
+        const kind = KIND_BY_TYPE[c.type];
+        if (!kind || SKIP_TYPES.has(c.type))
+            continue;
+        const prefix = c.scope ? '**' + c.scope + ':** ' : '';
+        const line = '- ' + prefix + c.description + (c.breaking ? ' (BREAKING)' : '');
+        if (seen.has(line))
+            continue;
+        seen.add(line);
+        groups[kind].push(line);
+    }
+    return groups;
+}
+// Render the groups as a changelog body (the parts under a version
+// heading), with the standard Keep-a-Changelog order and empty groups
+// omitted. Returns '' when there is nothing to report.
+export function renderChangelogDraft(groups) {
+    const order = ['Added', 'Fixed', 'Changed', 'Removed'];
+    const out = [];
+    for (const kind of order) {
+        const items = groups[kind] || [];
+        if (!items.length)
+            continue;
+        out.push('## ' + kind, '');
+        out.push(...items, '');
+    }
+    return out.join('\n').trimEnd();
+}

package/dist/index.js

@@ -11,7 +11,7 @@ import { createTodoStore, getTodos, setTodos, resetTodos, renderTodos, } from '.
 import { runAgentLoop } from './agent-loop.js';
 import { createSpinner } from './spinner.js';
 import { LineEditor, expandPastes, pasteReplacement, formatCompactTokens, } from './input.js';
-import { parseImagePaste, extForMime, saveToTemp, guessMime, isImageName, formatSize, looksLikeFilePath, readClipboardImageDetailed, sniffMime, readWindowsClipboardFiles, hasClipboardTool, writeClipboardText, contentHash, } from './attachments.js';
+import { parseImagePaste, extForMime, saveToTemp, guessMime, formatSize, readClipboardImageDetailed, sniffMime, readWindowsClipboardFiles, hasClipboardTool, writeClipboardText, contentHash, } from './attachments.js';
 import { loadConfig, DEFAULTS, CONFIG_PATHS, ZAMES_HOME, CONFIG_SCHEMA, getByPath, validateConfigValue, writeConfigValue, resetConfigValue, } from './config.js';
 import { runConfigMenu } from './config-menu.js';
 import { translate, normalizeLocale, localeDisplayName, isLocale, } from './i18n.js';
@@ -23,7 +23,7 @@ import { formatDiff, formatDiffStat, formatContextSources, diffGitArgs, parseTra
 import { performCompact } from './compact.js';
 import { Scheduler, parseInterval, formatInterval, formatJobLine, parseCron, } from './scheduler.js';
 import { renderMarkdown, setAnswerWidth } from './markdown.js';
-import { extractAtFileRefs } from './path-token.js';
+import { resolveAttachPath, inlineAtRefs } from './attach-refs.js';
 import { closeWeb } from './web.js';
 import { assertCommandInsideRoot, runShell } from './shell.js';
 import { saveSession, loadLastSession, readSession, listSessions, sessionsDir, loadHistory, saveHistory, } from './sessions.js';
@@ -627,88 +627,6 @@ function buildSlashCommands() {
 // We put the agent's temporary files (one-off scripts, etc.) in
 // <project>/tmp — this folder is in .gitignore and is cleaned on every launch.
 const TMP_DIR = path.join(__dirname, '..', 'tmp');
-// Resolve a pasted string into a path to an existing file. Handles quoted
-// paths (drag&drop from some file managers adds quotes) and paths relative to
-// the working directory.
-async function resolveAttachPath(workdir, raw) {
-    let s = String(raw || '').trim();
-    if (!s)
-        return null;
-    if ((s.startsWith('"') && s.endsWith('"')) ||
-        (s.startsWith("'") && s.endsWith("'"))) {
-        s = s.slice(1, -1);
-    }
-    s = s.replace(/\\ /g, ' ');
-    if (!looksLikeFilePath(s) && !isImageName(s))
-        return null;
-    const candidates = path.isAbsolute(s)
-        ? [s]
-        : [
-            // Most common: relative to the project (working) directory.
-            path.resolve(workdir, s),
-            // The operator may paste a path relative to the terminal's cwd (which
-            // can be the parent of the project) or copy it with the project name
-            // included, e.g. "zames_pro/tmp/image.png" while workdir is already
-            // .../zames_pro. Try both so the marker appears instead of raw text.
-            path.resolve(process.cwd(), s),
-            path.resolve(workdir, '..', s),
-        ];
-    for (const c of candidates) {
-        const st = await fs.stat(c).catch(() => null);
-        if (st && st.isFile())
-            return c;
-    }
-    return null;
-}
-// Per-file and total caps for `@path` inlining (B5). A reference should SAVE
-// round-trips, not flood the context: a huge file is truncated with a note
-// telling the agent to read the rest itself.
-const AT_REF_FILE_CAP = 60 * 1024;
-const AT_REF_TOTAL_CAP = 200 * 1024;
-// Inline `@path` references found in a task text (B5). Returns the augmented
-// text plus the list of files actually inlined (for the operator notice).
-// Unknown/unreadable references are left in place untouched — they may be part
-// of the prose; we never fail the task over a missing file.
-async function inlineAtRefs(workdir, text) {
-    const refs = extractAtFileRefs(text);
-    if (!refs.length)
-        return { text, inlined: [] };
-    const blocks = [];
-    const inlined = [];
-    let total = 0;
-    for (const ref of refs) {
-        if (total >= AT_REF_TOTAL_CAP)
-            break;
-        const file = await resolveAttachPath(workdir, ref);
-        if (!file)
-            continue;
-        let raw;
-        try {
-            raw = await fs.readFile(file, 'utf-8');
-        }
-        catch {
-            continue;
-        }
-        let body = raw;
-        let note = '';
-        if (body.length > AT_REF_FILE_CAP) {
-            body = body.slice(0, AT_REF_FILE_CAP);
-            note = NL + NL + '(truncated at ' + AT_REF_FILE_CAP + ' chars)';
-        }
-        total += body.length;
-        inlined.push(path.relative(workdir, file) || file);
-        blocks.push('### ' + ref + NL + '```' + NL + body + NL + '```' + note);
-    }
-    if (!blocks.length)
-        return { text, inlined: [] };
-    const section = NL +
-        NL +
-        '## Files referenced with @ in the task' +
-        NL +
-        NL +
-        blocks.join(NL + NL);
-    return { text: text + section, inlined };
-}
 async function cleanTmpDir() {
     try {
         await fs.rm(TMP_DIR, { recursive: true, force: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zames_pro",
-  "version": "2.63.1",
+  "version": "2.64.1",
   "description": "Terminal coding agent that drives chat.deepseek.com through Playwright: reads and edits files, runs commands, commits to git.",
   "type": "module",
   "bin": {
@@ -21,6 +21,7 @@
     "clean": "node scripts/clean-dist.mjs",
     "build": "node scripts/clean-dist.mjs && tsc -p tsconfig.build.json",
     "coverage:gate": "node scripts/coverage-gate.mjs",
+    "changelog:draft": "tsx scripts/changelog-draft.mts",
     "typecheck": "tsc --noEmit",
     "lint": "node scripts/eslint-ts6.mjs",
     "lint:fix": "node scripts/eslint-ts6.mjs --fix",

package/scripts/changelog-draft.mts

@@ -0,0 +1,56 @@
+import { spawnSync } from 'node:child_process'
+import {
+  parseConventionalCommit,
+  groupCommits,
+  renderChangelogDraft,
+} from '../src/changelog.js'
+
+// Draft a CHANGELOG section from conventional commits since a ref (BACKLOG
+// D2). PRINTS to stdout and never touches CHANGELOG.md -- the operator (or
+// the agent) pastes the result in by hand, so a bad commit subject can never
+// corrupt the changelog.
+//
+// Usage:
+//   npm run changelog:draft            # since the latest tag, or an explicit ref
+//   npm run changelog:draft -- v2.63.0
+
+function git(args: string[]): string {
+  const r = spawnSync('git', args, { encoding: 'utf-8' })
+  if (r.status !== 0) return ''
+  return (r.stdout || '').toString()
+}
+
+const argRef = process.argv.slice(2).find((a) => !a.startsWith('-'))
+
+// Resolve the start ref: an explicit arg, otherwise the latest tag,
+// otherwise the root commit.
+const latestTag = git(['describe', '--tags', '--abbrev=0']).trim()
+const ref =
+  argRef ||
+  latestTag ||
+  git(['revlist', 'HEAD']).trim().split('\n').pop() ||
+  'HEAD'
+
+const subjects = git([
+  'log',
+  '--no-merges',
+  '--pretty=format:%s',
+  `${ref}..HEAD`,
+])
+  .split('\n')
+  .map((s) => s.trim())
+  .filter(Boolean)
+
+const parsed = subjects
+  .map(parseConventionalCommit)
+  .filter((c): c is NonNullable<typeof c> => c !== null)
+const body = renderChangelogDraft(groupCommits(parsed))
+
+if (!body) {
+  console.error('no conventional commits since ' + ref)
+  process.exit(0)
+}
+
+console.log('## [Unreleased]')
+console.log('')
+console.log(body)

package/scripts/coverage-gate.mjs

@@ -30,12 +30,18 @@ const FLOORS = {
   'undo.ts': 85,
   'checkpoint.ts': 80,
   'permissions.ts': 85,
+  'changelog.ts': 85,
+  'attach-refs.ts': 85,
 }
 
 const run = spawnSync(
   'npx',
   ['tsx', '--test', '--experimental-test-coverage', 'test/*.test.ts'],
-  { encoding: 'utf-8', shell: process.platform === 'win32', maxBuffer: 1024 * 1024 * 64 },
+  {
+    encoding: 'utf-8',
+    shell: process.platform === 'win32',
+    maxBuffer: 1024 * 1024 * 64,
+  },
 )
 
 const out = (run.stdout || '') + (run.stderr || '')