zames_pro 2.61.0 → 2.63.1

package/dist/config.js

@@ -22,6 +22,12 @@ export const DEFAULTS = {
         enabled: true,
         maxBackups: 200,
     },
+    // BACKLOG B3: snapshot the whole working tree at the start of each task so
+    // /rewind can roll a risky task back in one step.
+    checkpoint: {
+        enabled: true,
+        maxBackups: 50,
+    },
     transcript: {
         enabled: true,
         dir: path.join(os.homedir(), '.zames', 'logs'),
@@ -162,6 +168,20 @@ export const CONFIG_SCHEMA = [
         labelKey: 'cfg.f.undo_maxBackups',
         groupKey: 'cfg.group.undo',
     },
+    {
+        path: 'checkpoint.enabled',
+        type: 'boolean',
+        labelKey: 'cfg.f.checkpoint_enabled',
+        groupKey: 'cfg.group.checkpoint',
+    },
+    {
+        path: 'checkpoint.maxBackups',
+        type: 'number',
+        min: 1,
+        max: 1000,
+        labelKey: 'cfg.f.checkpoint_maxBackups',
+        groupKey: 'cfg.group.checkpoint',
+    },
     {
         path: 'transcript.enabled',
         type: 'boolean',

package/dist/context.js

@@ -1,4 +1,5 @@
 import fs from 'fs/promises';
+import { statSync } from 'fs';
 import path from 'path';
 import os from 'os';
 // Built-in skills, always available unless a project/global skill with the
@@ -169,11 +170,21 @@ function parseFrontmatter(raw) {
     const userInvokable = typeof out['user-invokable'] === 'string'
         ? out['user-invokable'].toLowerCase() !== 'false'
         : undefined;
+    const argumentsList = typeof out['arguments'] === 'string'
+        ? out['arguments']
+            .split(/[,\s]+/)
+            .map((s) => s.trim())
+            .filter(Boolean)
+        : undefined;
     return {
         name: out.name,
         description: out.description,
         allowedTools,
         userInvokable,
+        argumentHint: typeof out['argument-hint'] === 'string'
+            ? out['argument-hint']
+            : undefined,
+        arguments: argumentsList,
     };
 }
 export function skillBody(raw) {
@@ -302,6 +313,8 @@ async function loadCommandsFromDir(dir) {
             description: (fm.description || '').replace(/\s+/g, ' ').trim(),
             path: full,
             body: skillBody(raw),
+            argumentHint: fm.argumentHint,
+            arguments: fm.arguments,
         });
     }
     return out;
@@ -376,13 +389,14 @@ async function loadMemoryChain(workdir) {
     }
     return out;
 }
-export async function loadProjectContext(workdir) {
+export async function loadProjectContext(workdir, touchPaths = []) {
     const [agents, memory, skills, commands] = await Promise.all([
         loadAgentsChain(workdir).catch(() => []),
         loadMemoryChain(workdir).catch(() => []),
         loadSkills(workdir).catch(() => []),
         loadCommands(workdir).catch(() => []),
     ]);
+    const scopedAgents = await loadScopedAgents(workdir, touchPaths).catch(() => []);
     let used = 0;
     const withinBudget = (files) => {
         const kept = [];
@@ -396,8 +410,81 @@ export async function loadProjectContext(workdir) {
     };
     return {
         agents: withinBudget(agents),
+        // Scoped files are dropped silently when the total budget is already spent
+        // on the main chain: a nested AGENTS.md is an optimization, not a hard
+        // requirement, and must never push out a top-level instruction.
+        scopedAgents: withinBudget(scopedAgents),
         memory: withinBudget(memory),
         skills,
         commands,
     };
 }
+// A directory is "touched" by a task when the task text mentions a path inside
+// it (a `@ref`, a quoted path, a bare `src/foo.ts`). We look for the deepest
+// existing directories named in the text and collect AGENTS.md/MEMORY.md from
+// them and their ancestors below `workdir`. Implemented by scanning word tokens
+// rather than a regex over the whole text so a long prompt stays cheap.
+function touchedDirs(workdir, text) {
+    const root = path.resolve(workdir);
+    const out = new Set();
+    const words = String(text || '')
+        .split(/\s+/)
+        .map((w) => w.replace(/^[\('"\[]+/, '').replace(/[\),.;:'"\]]+$/, ''));
+    for (const w of words) {
+        if (!w || w.length > 300)
+            continue;
+        // Only path-looking tokens (contain a separator or a known file extension).
+        if (!/[\\/]/.test(w) && !/\.[A-Za-z0-9]{1,8}$/.test(w))
+            continue;
+        const abs = path.isAbsolute(w) ? w : path.resolve(root, w);
+        if (abs !== root && !abs.startsWith(root + path.sep))
+            continue;
+        // Walk from the deepest directory that actually exists up to the root.
+        let dir = abs;
+        let st = statSyncSafe(dir);
+        while (!st && dir !== root && dir.startsWith(root + path.sep)) {
+            dir = path.dirname(dir);
+            st = statSyncSafe(dir);
+        }
+        if (!st || !st.isDirectory())
+            continue;
+        let cur = dir;
+        while (cur.startsWith(root + path.sep)) {
+            out.add(cur);
+            cur = path.dirname(cur);
+        }
+    }
+    return [...out];
+}
+function statSyncSafe(p) {
+    try {
+        return statSync(p);
+    }
+    catch {
+        return null;
+    }
+}
+async function loadScopedAgents(workdir, touchPaths) {
+    if (!touchPaths.length)
+        return [];
+    const root = path.resolve(workdir);
+    // Collect every directory named by the task, deepest first, so the most
+    // specific instructions come first and win the budget.
+    const dirs = touchedDirs(root, touchPaths.join(' '));
+    dirs.sort((a, b) => b.length - a.length);
+    const out = [];
+    const seen = new Set();
+    for (const dir of dirs) {
+        for (const names of [AGENT_NAMES, MEMORY_NAMES]) {
+            const p = await findNamedFile(dir, names);
+            if (!p || seen.has(p))
+                continue;
+            const f = await readIfFile(p, MAX_FILE_BASE);
+            if (!f)
+                continue;
+            seen.add(p);
+            out.push(f);
+        }
+    }
+    return out;
+}

package/dist/i18n.js

@@ -194,6 +194,14 @@ export const CATALOG = {
         ru: '/undo-list               список того, что можно откатить',
         en: '/undo-list               list revertable changes',
     },
+    'help.cmd.rewind': {
+        ru: '/rewind [n]              откатить рабочее дерево к чекпойнту',
+        en: '/rewind [n]              roll the working tree back to a checkpoint',
+    },
+    'help.cmd.rewind_list': {
+        ru: '/rewind-list             список чекпойнтов',
+        en: '/rewind-list             list checkpoints',
+    },
     'help.cmd.transcript': {
         ru: '/transcript              путь к файлу транскрипта',
         en: '/transcript              transcript file path',
@@ -565,6 +573,7 @@ export const CATALOG = {
     'help.files': { ru: 'Файлы:', en: 'Files:' },
     'help.files.logs': { ru: 'Логи:', en: 'Logs:' },
     'help.files.undo': { ru: 'Undo:', en: 'Undo:' },
+    'help.files.checkpoints': { ru: 'Чекпойнты:', en: 'Checkpoints:' },
     'help.files.sessions': { ru: 'Сессии:', en: 'Sessions:' },
     'help.files.profile': { ru: 'Профиль:', en: 'Profile:' },
     'help.files.snapshots': { ru: 'Снапшоты:', en: 'Snapshots:' },
@@ -649,6 +658,7 @@ export const CATALOG = {
     'status.headless': { ru: 'Headless: {v}', en: 'Headless: {v}' },
     'status.debug': { ru: 'Debug: {v}', en: 'Debug: {v}' },
     'status.undo': { ru: 'Undo: {v}', en: 'Undo: {v}' },
+    'status.checkpoint': { ru: 'Чекпойнты: {v}', en: 'Checkpoints: {v}' },
     'status.transcript': { ru: 'Транскрипт: {v}', en: 'Transcript: {v}' },
     'status.locale': { ru: 'Язык: {v}', en: 'Language: {v}' },
     'status.goal': { ru: 'Цель сессии: {v}', en: 'Session goal: {v}' },
@@ -708,6 +718,26 @@ export const CATALOG = {
         ru: 'Неизвестная команда: {v}. Набери /help.',
         en: 'Unknown command: {v}. Type /help.',
     },
+    'msg.missing_args': {
+        ru: 'Не хватает обязательных аргументов: {v}.',
+        en: 'Missing required arguments: {v}.',
+    },
+    'perm.ask': {
+        ru: '⚠ Запрос подтверждения: {tool} ({reason})',
+        en: '⚠ Approval required: {tool} ({reason})',
+    },
+    'perm.confirm': {
+        ru: 'Разрешить выполнение?',
+        en: 'Allow this call?',
+    },
+    'perm.allowed': {
+        ru: '✔ Разрешено оператором.',
+        en: '✔ Allowed by operator.',
+    },
+    'perm.denied': {
+        ru: '✖ Отклонено оператором — вызов не выполнен.',
+        en: '✖ Denied by operator — the call was not run.',
+    },
     'msg.dev_only': {
         ru: 'Команда {v} доступна только в dev-режиме (--dev или hotReload).',
         en: 'The {v} command is only available in dev mode (--dev or hotReload).',
@@ -749,6 +779,11 @@ export const CATALOG = {
         ru: '📎 Вложен файл {marker} {name} ({size}) — {path}',
         en: '📎 Attached file {marker} {name} ({size}) — {path}',
     },
+    // B5: shown when `@path` references in a task were inlined as file contents.
+    'msg.at_refs': {
+        ru: '📄 Встроено файлов по @-ссылкам: {n} —',
+        en: '📄 Inlined @-referenced files: {n} —',
+    },
     'msg.clip_empty': {
         ru: '⚠ В буфере обмена нет картинки (проверено: {via}).',
         en: '⚠ No image found in the clipboard (tried: {via}).',
@@ -849,6 +884,11 @@ export const CATALOG = {
     },
     'cost.auto_compacts': { ru: ' авто-сжатий: {n}', en: ' auto-compacts: {n}' },
     'cost.by_tool': { ru: ' по инструментам:', en: ' by tool:' },
+    // T-D3: total time spent inside tools, then a top-N per-tool breakdown.
+    'cost.by_time': {
+        ru: ' время в инструментах: {dur}; топ по времени:',
+        en: ' time in tools: {dur}; top by time:',
+    },
     'cost.duration': { ru: ' длительность: {dur}', en: ' duration: {dur}' },
     'cost.started': { ru: ' начало: {v}', en: ' started: {v}' },
     'cost.transcript': { ru: ' транскрипт: {v}', en: ' transcript: {v}' },
@@ -1293,6 +1333,46 @@ export const CATALOG = {
         ru: 'undo отключён в конфиге',
         en: 'undo is disabled in the config',
     },
+    'rewind.empty': { ru: 'Чекпойнтов нет.', en: 'No checkpoints.' },
+    'rewind.created': {
+        ru: '📸 Чекпойнт: {v}',
+        en: '📸 Checkpoint: {v}',
+    },
+    'rewind.list_title': { ru: 'Чекпойнты:', en: 'Checkpoints:' },
+    'rewind.reverted': {
+        ru: '↶ Откатили рабочее дерево к чекпойнту {v}',
+        en: '↶ Rolled the working tree back to checkpoint {v}',
+    },
+    'rewind.backup': {
+        ru: 'Текущее состояние сохранено как чекпойнт {v}',
+        en: 'Current state saved as checkpoint {v}',
+    },
+    'rewind.failed': {
+        ru: 'Не удалось откатить: {v}',
+        en: 'Failed to rewind: {v}',
+    },
+    'rewind.reason_not_found': {
+        ru: 'чекпойнт не найден',
+        en: 'checkpoint not found',
+    },
+    'rewind.reason_archive_missing': {
+        ru: 'архив чекпойнта отсутствует',
+        en: 'checkpoint archive is missing',
+    },
+    'rewind.reason_extract_failed': {
+        ru: 'не удалось распаковать архив',
+        en: 'failed to unpack the archive',
+    },
+    'rewind.reason_disabled': {
+        ru: 'чекпойнты отключены в конфиге',
+        en: 'checkpoints are disabled in the config',
+    },
+    'rewind.confirm': {
+        ru: 'Откатить рабочее дерево к чекпойнту {v}? Текущее состояние будет сохранено как бэкап.',
+        en: 'Roll the working tree back to checkpoint {v}? The current state will be saved as a backup.',
+    },
+    'rewind.cancelled': { ru: 'Отменено.', en: 'Cancelled.' },
+    'rewind.label_backup': { ru: 'бэкап', en: 'backup' },
     'dom.saved': { ru: 'HTML сохранён: {v}', en: 'HTML saved: {v}' },
     'dom.selectors': { ru: 'Селекторы:', en: 'Selectors:' },
     'dom.save_error': {
@@ -1366,6 +1446,7 @@ export const CATALOG = {
     'cfg.group.ui': { ru: 'Интерфейс', en: 'Interface' },
     'cfg.group.agent': { ru: 'Агент', en: 'Agent' },
     'cfg.group.undo': { ru: 'Откат (undo)', en: 'Undo' },
+    'cfg.group.checkpoint': { ru: 'Чекпойнты', en: 'Checkpoints' },
     'cfg.group.transcript': { ru: 'Транскрипт', en: 'Transcript' },
     'cfg.group.browser': { ru: 'Браузер / DeepSeek', en: 'Browser / DeepSeek' },
     'cfg.f.ui_contextLimit': {
@@ -1401,6 +1482,14 @@ export const CATALOG = {
         ru: 'Сколько бэкапов хранить',
         en: 'Max undo backups kept',
     },
+    'cfg.f.checkpoint_enabled': {
+        ru: 'Чекпойнт в начале каждой задачи (для /rewind)',
+        en: 'Checkpoint at the start of each task (for /rewind)',
+    },
+    'cfg.f.checkpoint_maxBackups': {
+        ru: 'Сколько чекпойнтов хранить',
+        en: 'How many checkpoints to keep',
+    },
     'cfg.f.transcript_enabled': {
         ru: 'Вести транскрипт',
         en: 'Write transcript log',