gp-cron 0.1.0 → 0.1.1

package/README.md

@@ -25,9 +25,10 @@ gp add
 gp
 ```
 
-`gp add` открывает мастер настройки. На первом шаге текущая папка предложена
-по умолчанию — нажмите Enter. Затем укажите название, интервал, команды после
-обновления, таймаут и подтвердите доверие. Путь можно передать явно:
+`gp add` открывает форму настройки с текущей папкой. Стрелками или Tab выберите
+поле, нажмите Enter для изменения. Задайте интервал, команды после обновления
+и таймаут, отметьте разрешение на обновление клавишей Space и выберите «Сохранить».
+Путь можно передать явно:
 `gp add ~/Projects/my-app`.
 
 Папка должна быть корнем Git-репозитория; текущая ветка должна иметь upstream.
@@ -37,8 +38,8 @@ gp
 git branch --set-upstream-to=origin/main main
 ```
 
-Добавленный проект сразу начинает обновляться. `--no-start` регистрирует его
-остановленным. Для серверов и скриптов есть явная настройка без вопросов:
+Переключатель «Запустить после сохранения» включает обновления сразу.
+`--no-start` отключает его по умолчанию. Для серверов и скриптов есть настройка без вопросов:
 
 ```sh
 gp add /srv/my-app --name my-app --interval 5m --trust \
@@ -48,7 +49,7 @@ gp add /srv/my-app --name my-app --interval 5m --trust \
 
 Каждая команда выполняется отдельно, по порядку, в папке проекта через системный
 shell. Можно передавать `npm ci && npm run build` одной командой. Пустой список
-команд означает только обновление Git. При редактировании список вводится заново.
+команд означает только обновление Git. При редактировании существующие команды сохраняются.
 Таймаут применяется к каждой команде; Git-операции имеют отдельный таймаут 120 секунд.
 Интервалы и таймауты: от `10s` до `168h`.
 
@@ -59,18 +60,26 @@ shell. Можно передавать `npm ci && npm run build` одной ко
 
 | Клавиша | Действие |
 | --- | --- |
-| ↑ / ↓ или k / j | Выбрать проект |
+| ↑ / ↓ или Tab | Выбрать проект |
+| Enter | Открыть меню действий проекта |
 | a | Добавить проект |
 | Space | Запустить / остановить расписание |
 | p | Проверить и обновить сейчас |
 | e | Изменить настройки |
-| l | Посмотреть последние логи |
+| l | Открыть логи с прокруткой и автоматическим обновлением |
 | r | Повторить команды после ошибки |
 | d | Удалить из реестра |
-| q / Ctrl+C | Закрыть панель; фоновые обновления продолжаются |
+| q / Esc / Ctrl+C | Закрыть панель; фоновые обновления продолжаются |
+
+В формах Tab / Shift+Tab и стрелки переключают поля, Enter открывает редактор,
+Space меняет переключатель, Esc возвращает назад без сохранения формы.
+В редакторе текста Ctrl+U очищает поле, ←→ / Home / End перемещают курсор.
+В списке команд Enter добавляет или изменяет команду, Delete удаляет,
+Ctrl+↑↓ меняет порядок. В просмотре логов ↑↓ / PageUp / PageDown прокручивают
+вывод, End включает слежение за новыми строками.
 
 Без интерактивного терминала `gp` выводит таблицу статусов. `NO_COLOR=1` отключает
-цвета в обычном CLI. Панель использует ANSI-терминал.
+цвета. Панель использует ANSI-терминал, восстанавливает экран и курсор при выходе.
 
 ## Команды
 

package/package.json

@@ -1,12 +1,31 @@
 {
   "name": "gp-cron",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "A safe, local Git project updater with a terminal dashboard",
   "type": "module",
-  "bin": { "gp": "bin/gp.js" },
-  "engines": { "node": ">=20" },
-  "files": ["bin", "src", "README.md", "LICENSE"],
-  "scripts": { "test": "node --test", "check": "node --check bin/gp.js && node --check src/cli.js && node --check src/worker.js", "start": "node bin/gp.js" },
-  "keywords": ["git", "updater", "cli", "tui", "automation"],
+  "bin": {
+    "gp": "bin/gp.js"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "bin",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "node --test",
+    "check": "node --check bin/gp.js && node --check src/cli.js && node --check src/worker.js && node --check src/tui.js",
+    "start": "node bin/gp.js"
+  },
+  "keywords": [
+    "git",
+    "updater",
+    "cli",
+    "tui",
+    "automation"
+  ],
   "license": "MIT"
 }

package/src/cli.js

@@ -3,8 +3,8 @@ import path from 'node:path';
 import crypto from 'node:crypto';
 import { fileURLToPath } from 'node:url';
 import { spawn } from 'node:child_process';
-import readline from 'node:readline';
-import { createInterface } from 'node:readline/promises';
+import os from 'node:os';
+import { withTerminal } from './tui.js';
 import { config, home, alive, interval, lock, logFile, select, setState, state, updateConfig } from './store.js';
 import { daemon, inspect, pull } from './worker.js';
 
@@ -41,28 +41,20 @@ async function ensureDaemon() {
   for (let i = 0; i < 50; i++) { if (spawnError) throw spawnError; if (daemonPid()) return; await sleep(100); }
   throw new Error(`Daemon failed to start. Inspect ${path.join(home, 'daemon.log')}`);
 }
-async function promptSession(fn) {
-  if (!process.stdin.isTTY) throw new Error('Interactive setup needs a terminal. Use --trust and explicit options; see gp help.');
-  const rl = createInterface({ input: process.stdin, output: process.stdout });
-  try { return await fn(async (label, fallback = '') => (await rl.question(`${label}${fallback ? ` [${fallback}]` : ''}: `)).trim() || fallback); }
-  finally { rl.close(); }
-}
-async function wizard(folder, existing) {
-  return promptSession(async ask => {
-    const repo = await inspect(folder || await ask('Repository folder', process.cwd()));
-    console.log(`\n${safe(repo.path)}\nBranch: ${safe(repo.branch)} → ${safe(repo.upstream)}\n`);
-    const name = await ask('Project name', existing?.name || path.basename(repo.path));
-    const frequency = interval(await ask('Update interval (10s, 5m, 1h)', existing ? `${existing.interval / 1000}s` : '5m'));
-    console.log('Commands run in this folder using your shell, with your user permissions.');
-    if (existing?.commands.length) console.log(`Current commands: ${safe(existing.commands.join(' → '))}`);
-    const commands = [];
-    console.log('Enter each post-update command in execution order. Empty input finishes.');
-    while (true) { const command = await ask(`Command ${commands.length + 1}`); if (!command) break; commands.push(command); }
-    const timeout = interval(await ask('Timeout for each command', existing ? `${existing.commandTimeout / 1000}s` : '10m'));
-    console.log('Trust allows Git network access and updates in this folder. Built-in Git hooks are disabled.');
-    if ((await ask('Trust this folder and enable these commands? Type yes', 'no')).toLowerCase() !== 'yes') throw new Error('Setup cancelled.');
-    return { ...repo, name, interval: frequency, commands, commandTimeout: timeout, trusted: true };
+function say(opts, message) { if (opts?.ui) opts.ui.notice = message; else console.log(message); }
+async function wizard(folder, existing, opts = {}) {
+  const show = ui => ui.projectForm({
+    folder: folder || process.cwd(), existing, start: !opts['no-start'],
+    validate: async value => {
+      const frequency = interval(value.interval), timeout = interval(value.timeout);
+      const folderPath = value.folder === '~' ? os.homedir() : value.folder.startsWith('~/') ? path.join(os.homedir(), value.folder.slice(2)) : value.folder;
+      const repo = await inspect(path.resolve(folderPath));
+      const name = value.name || path.basename(repo.path);
+      if (name === 'all' || config().projects.some(p => p.id !== existing?.id && (p.path === repo.path || p.name === name || p.id === name))) throw new Error('Папка или название уже зарегистрированы.');
+      return { ...repo, name, interval: frequency, commands: value.commands, commandTimeout: timeout, trusted: true, enabled: existing?.enabled ?? value.enabled };
+    }
   });
+  return opts.ui ? show(opts.ui) : withTerminal(show);
 }
 async function add(folder, opts) {
   let values;
@@ -70,14 +62,15 @@ async function add(folder, opts) {
     const repo = await inspect(path.resolve(folder || '.'));
     if (opts.command.length && !opts['allow-commands']) throw new Error('Use --allow-commands to explicitly authorize post-update commands.');
     values = { ...repo, name: opts.name || path.basename(repo.path), interval: interval(opts.interval || '5m'), commands: opts.command, commandTimeout: interval(opts.timeout || '10m'), trusted: true };
-  } else values = await wizard(folder);
-  const project = { ...values, id: crypto.randomBytes(4).toString('hex'), enabled: !opts['no-start'] };
+  } else values = await wizard(folder, undefined, opts);
+  if (!values) { say(opts, 'Добавление отменено.'); return; }
+  const project = { ...values, id: crypto.randomBytes(4).toString('hex'), enabled: values.enabled ?? !opts['no-start'] };
   updateConfig(c => {
     if (c.projects.some(p => p.path === project.path || p.name === project.name || p.id === project.name) || project.name === 'all') throw new Error('Project folder or name is already registered, or name is reserved.');
     c.projects.push(project);
   });
   if (project.enabled) await ensureDaemon();
-  console.log(`Added ${safe(project.name)} (${project.id})${project.enabled ? ' · running' : ' · stopped'}`);
+  say(opts, `Added ${safe(project.name)} (${project.id})${project.enabled ? ' · running' : ' · stopped'}`);
 }
 function status(p) {
   const s = state(p.id);
@@ -97,15 +90,16 @@ function mutateProject(p, fn) {
   if (!release) throw new Error('Project is currently updating. Try again when it finishes.');
   try { return fn(); } finally { release(); }
 }
-async function edit(p) {
-  const values = await wizard(p.path, p);
+async function edit(p, opts = {}) {
+  const values = await wizard(p.path, p, opts);
+  if (!values) { say(opts, 'Изменения отменены.'); return; }
   mutateProject(p, () => updateConfig(c => {
-    if (values.name === 'all' || c.projects.some(item => item.id !== p.id && (item.name === values.name || item.id === values.name))) throw new Error('Project name is already used or reserved.');
+    if (values.name === 'all' || c.projects.some(item => item.id !== p.id && (item.name === values.name || item.id === values.name || item.path === values.path))) throw new Error('Project name or folder is already used or reserved.');
     const current = c.projects.find(item => item.id === p.id);
     if (!current) throw new Error('Project was removed.');
     Object.assign(current, values);
   }));
-  console.log('Saved. Run gp start to resume a paused project.');
+  say(opts, 'Настройки сохранены. Для возобновления проекта используйте Start.');
 }
 async function logs(p, opts = {}) {
   const count = Number(opts.lines || 30);
@@ -156,93 +150,46 @@ async function action(command, query, opts = {}) {
       updateConfig(c => { for (const p of c.projects) if (targets.some(t => t.id === p.id)) p.enabled = command === 'start'; });
     } finally { for (const release of releases.reverse()) release(); }
     if (command === 'start') await ensureDaemon();
-    console.log(`${command === 'start' ? 'Started' : 'Stopped scheduling'} ${targets.length} project(s).${command === 'stop' ? ' An active job is allowed to finish.' : ''}`);
+    say(opts, `${command === 'start' ? 'Started' : 'Stopped scheduling'} ${targets.length} project(s).${command === 'stop' ? ' An active job is allowed to finish.' : ''}`);
     return;
   }
   const p = select(query);
-  if (command === 'edit') return edit(p);
+  if (command === 'edit') return edit(p, opts);
   if (command === 'logs') return logs(p, opts);
   if (command === 'info') { console.log(JSON.stringify({ ...p, status: status(p), runtime: state(p.id) }, null, 2)); return; }
   if (command === 'pull' || command === 'retry') {
     const result = await pull(p, { retry: command === 'retry' });
     if (result.error) throw new Error(result.error);
-    console.log(result.busy ? 'Project is already updating.' : 'Done.'); return;
+    say(opts, result.busy ? 'Project is already updating.' : 'Done.'); return;
   }
   if (command === 'remove' || command === 'accept') {
     if (!opts.yes) {
-      const confirmed = await promptSession(async ask => (await ask(command === 'remove' ? `Unregister ${p.name}? Files will stay. Type yes` : 'Clear pending commands without running them? Type yes', 'no')) === 'yes');
+      const show = ui => ui.confirm(command === 'remove' ? 'Удаление из реестра' : 'Снять незавершённые команды', p.name, command === 'remove' ? ['Прекратить управление этой папкой?', 'Файлы проекта и логи сохранятся.'] : ['Снять блокировку без выполнения команд?', 'Подтвердите, если решили проблему вручную.']);
+      const confirmed = opts.ui ? await show(opts.ui) : await withTerminal(show);
       if (!confirmed) return;
     }
     mutateProject(p, () => {
       if (command === 'remove') updateConfig(c => { c.projects = c.projects.filter(item => item.id !== p.id); });
       else setState(p.id, { pendingRevision: null, blocked: false, error: null, phase: 'idle', nextRun: Date.now() + p.interval });
     });
-    console.log(command === 'remove' ? 'Project unregistered; files and logs retained.' : 'Pending commands cleared.'); return;
+    say(opts, command === 'remove' ? 'Project unregistered; files and logs retained.' : 'Pending commands cleared.'); return;
   }
   throw new Error(`Unknown command: ${command}`);
 }
 
 async function dashboard() {
   if (!process.stdin.isTTY || !process.stdout.isTTY) return list();
-  let selected = 0, busy = false, done = false, notice = '';
-  readline.emitKeypressEvents(process.stdin);
-  const draw = () => {
-    if (busy || done) return;
-    const projects = config().projects;
-    selected = Math.max(0, Math.min(selected, projects.length - 1));
-    const width = Math.max(30, (process.stdout.columns || 90) - 2);
-    const line = text => console.log(safe(text).slice(0, width));
-    process.stdout.write('\x1b[2J\x1b[H');
-    console.log(color('1;36', '  ◈  git-puller') + color('2', `   daemon ${daemonPid() ? '● online' : '○ offline'}`));
-    line('  Git projects, quietly kept current.'); console.log();
-    const visible = Math.max(1, (process.stdout.rows || 24) - 13);
-    const first = Math.max(0, selected - visible + 1);
-    for (let index = first; index < Math.min(projects.length, first + visible); index++) {
-      const p = projects[index];
-      const text = ` ${index === selected ? '›' : ' '} ${p.name.padEnd(22)} ${status(p).padEnd(10)} ${String(p.interval / 1000).padStart(5)}s  ${p.branch}`;
-      console.log(color(index === selected ? '1;36' : '0', safe(text).slice(0, width)));
-    }
-    if (!projects.length) line('  No projects. Press a to add your first repository.');
-    const p = projects[selected];
-    console.log();
-    if (p) {
-      const s = state(p.id);
-      line(`  ${p.path}`);
-      line(`  Checked: ${s.checkedAt || '—'}   Updated: ${s.updatedAt || '—'}`);
-      line(`  Next: ${p.enabled && !s.blocked && s.nextRun ? new Date(s.nextRun).toLocaleTimeString() : '—'}`);
-      if (s.error) line(`  ⚠ ${s.error}`);
+  const labels = { stopped: 'остановлен', paused: 'пауза', offline: 'нет daemon', checking: 'проверка', commands: 'команды', watching: 'работает' };
+  return withTerminal(ui => ui.dashboard({
+    projects: () => config().projects,
+    status: p => labels[status(p)], state, daemon: daemonPid,
+    logs: p => fs.existsSync(logFile(p.id)) ? fs.readFileSync(logFile(p.id), 'utf8') : 'Логов пока нет.',
+    action: async (command, p, terminal) => {
+      const opts = { ui: terminal, command: [] };
+      if (command === 'add') await add(undefined, opts);
+      else await action(command, p.id, opts);
     }
-    console.log();
-    line('  ↑↓ select  a add  space start/stop  p pull  e edit  l logs');
-    line('  r retry commands  d remove  q quit');
-    if (notice) line(`  ${notice}`);
-  };
-  const cleanup = () => { clearInterval(timer); process.stdin.off('keypress', keypress); process.stdin.setRawMode(false); process.stdin.pause(); process.stdout.write('\x1b[?25h\n'); };
-  let finish;
-  const completed = new Promise(resolve => { finish = resolve; });
-  const keypress = async (text, key = {}) => {
-    if (busy || done) return;
-    if (text === 'q' || (key.ctrl && key.name === 'c')) { done = true; cleanup(); finish(); return; }
-    const projects = config().projects;
-    if (key.name === 'up' || text === 'k') { selected--; draw(); return; }
-    if (key.name === 'down' || text === 'j') { selected++; draw(); return; }
-    const p = projects[selected];
-    if (!['a', ' ', 'p', 'e', 'l', 'r', 'd'].includes(text) || (text !== 'a' && !p)) return;
-    busy = true; process.stdin.setRawMode(false); process.stdout.write('\x1b[?25h\x1b[2J\x1b[H');
-    try {
-      if (text === 'a') await add(undefined, { command: [] });
-      else await action(({ ' ': p.enabled ? 'stop' : 'start', p: 'pull', e: 'edit', l: 'logs', r: 'retry', d: 'remove' })[text], p.id);
-      notice = 'Done';
-    } catch (error) { notice = error.message; console.log(safe(error.message)); }
-    finally {
-      await promptSession(async ask => { await ask('Press Enter to return'); });
-      process.stdin.setRawMode(true); process.stdin.resume(); process.stdout.write('\x1b[?25l'); busy = false; draw();
-    }
-  };
-  process.stdin.setRawMode(true); process.stdin.resume(); process.stdout.write('\x1b[?25l');
-  process.stdin.on('keypress', keypress);
-  const timer = setInterval(draw, 1000);
-  draw(); await completed;
+  }));
 }
 
 const help = `git-puller · gp

package/src/tui.js

@@ -0,0 +1,254 @@
+import readline from 'node:readline';
+
+export const cleanText = value => String(value ?? '').replace(/[\x00-\x1f\x7f-\x9f]/g, ' ');
+const chars = value => Array.from(cleanText(value));
+export function fit(value, width) {
+  const text = chars(value);
+  return (text.length > width ? text.slice(0, Math.max(0, width - 1)).join('') + '…' : text.join('')).padEnd(width);
+}
+const row = (text = '', selected = false, warning = false) => ({ text, selected, warning });
+const cancelKey = key => key.name === 'escape' || (key.ctrl && key.name === 'c');
+
+export class Terminal {
+  constructor(input = process.stdin, output = process.stdout) {
+    this.input = input; this.output = output; this.view = null; this.notice = '';
+  }
+  async open(fn) {
+    if (!this.input.isTTY || !this.output.isTTY) throw new Error('Настройка требует терминала. Для скриптов используйте --trust и параметры из gp help.');
+    this.wasRaw = Boolean(this.input.isRaw);
+    readline.emitKeypressEvents(this.input, { escapeCodeTimeout: 100 });
+    this.onKey = (text, key = {}) => this.view?.key(text, key);
+    this.onResize = () => this.draw();
+    this.onSignal = () => { this.view?.cancel(); this.close(); process.exitCode = 143; };
+    this.input.on('keypress', this.onKey); this.output.on('resize', this.onResize);
+    process.on('SIGTERM', this.onSignal);
+    this.input.setRawMode(true); this.input.resume();
+    this.output.write('\x1b[?1049h\x1b[?25l');
+    this.timer = setInterval(() => this.draw(), 1000);
+    try { return await fn(this); } finally { this.close(); }
+  }
+  close() {
+    if (!this.onKey) return;
+    clearInterval(this.timer);
+    this.input.off('keypress', this.onKey); this.output.off('resize', this.onResize);
+    process.off('SIGTERM', this.onSignal);
+    this.input.setRawMode(this.wasRaw); this.input.pause();
+    this.output.write('\x1b[0m\x1b[?25h\x1b[?1049l');
+    this.onKey = null;
+  }
+  draw() {
+    if (!this.view || !this.onKey) return;
+    const columns = this.output.columns || 80, height = this.output.rows || 24;
+    const width = Math.max(10, Math.min(96, columns - 4));
+    const inner = width - 4, capacity = Math.max(1, height - 9);
+    const { title, rows, footer, focus = 0 } = this.view.render(inner, capacity);
+    const start = Math.max(0, Math.min(Math.max(0, rows.length - capacity), focus - capacity + 2));
+    const visible = rows.slice(start, start + capacity);
+    const lines = [row(`┌${'─'.repeat(width - 2)}┐`), row(`│ ${fit(title, inner)} │`)];
+    for (let i = 0; i < capacity; i++) {
+      const item = visible[i] || row();
+      lines.push({ ...item, text: `│${item.selected ? '›' : ' '}${fit(item.text, inner)} │` });
+    }
+    lines.push(row(`├${'─'.repeat(width - 2)}┤`), row(`│ ${fit(footer, inner)} │`), row(`└${'─'.repeat(width - 2)}┘`));
+    const top = Math.max(2, Math.floor((height - lines.length) / 2));
+    const left = Math.max(0, Math.floor((columns - width) / 2));
+    const colored = !process.env.NO_COLOR && process.env.TERM !== 'dumb';
+    const paint = (code, text) => colored ? `\x1b[${code}m${text}\x1b[0m` : text;
+    const background = fit('', columns);
+    const screen = Array.from({ length: height }, () => paint('37;44', background));
+    screen[0] = paint('1;97;44', fit('  git-puller / gp', columns));
+    for (let i = 0; i < lines.length && top + i < height - 1; i++) {
+      const item = lines[i];
+      screen[top + i] = paint('37;44', ' '.repeat(left)) + paint(item.selected ? '1;97;46' : item.warning ? '31;47' : '30;47', item.text) + paint('37;44', ' '.repeat(Math.max(0, columns - left - width)));
+    }
+    screen[height - 1] = paint('37;44', fit('  Tab / ↑↓ — выбор   Enter — открыть   Esc — назад', columns));
+    const frame = '\x1b[H' + screen.join('\r\n');
+    if (frame !== this.lastFrame) { this.output.write(frame); this.lastFrame = frame; }
+  }
+  async show(render, handler) {
+    const previous = this.view;
+    let resolve;
+    const promise = new Promise(done => { resolve = done; });
+    let settled = false, handling = false;
+    const queue = [];
+    const finish = value => { if (!settled) { settled = true; resolve(value); } };
+    const drain = async () => {
+      if (handling || settled) return;
+      handling = true;
+      try {
+        while (queue.length && !settled) {
+          const [text, key] = queue.shift();
+          try { await handler(text, key, finish); }
+          catch (error) { this.notice = error.message; }
+          this.draw();
+        }
+      } finally { handling = false; }
+    };
+    this.view = {
+      render,
+      cancel: () => finish(null),
+      key: (text, key) => { if (!settled) { queue.push([text, key]); void drain(); } }
+    };
+    this.draw();
+    try { return await promise; } finally { this.view = previous; this.draw(); }
+  }
+  async inputText(title, initial = '', hint = '') {
+    let buffer = Array.from(initial), cursor = buffer.length;
+    return this.show(width => {
+      const start = Math.max(0, cursor - width + 6);
+      const displayed = buffer.slice(start, cursor).join('') + '▏' + buffer.slice(cursor).join('');
+      return { title, rows: [row(hint), row(), row(displayed, true), row(), row('Enter — сохранить   Esc — отменить')], footer: 'Ctrl+U — очистить   ←→ / Home / End — курсор', focus: 2 };
+    }, (text, key, finish) => {
+      if (cancelKey(key)) return finish(null);
+      if (key.name === 'return') return finish(buffer.join(''));
+      if (key.ctrl && key.name === 'u') { buffer = []; cursor = 0; }
+      else if (key.name === 'left') cursor = Math.max(0, cursor - 1);
+      else if (key.name === 'right') cursor = Math.min(buffer.length, cursor + 1);
+      else if (key.name === 'home') cursor = 0;
+      else if (key.name === 'end') cursor = buffer.length;
+      else if (key.name === 'backspace' && cursor) { buffer.splice(--cursor, 1); }
+      else if (key.name === 'delete') buffer.splice(cursor, 1);
+      else if (text && !key.ctrl && !key.meta && !['up', 'down', 'tab'].includes(key.name)) {
+        const insertion = Array.from(cleanText(text)); buffer.splice(cursor, 0, ...insertion); cursor += insertion.length;
+      }
+    });
+  }
+  async confirm(title, message, details = []) {
+    let selected = 0;
+    return this.show(() => ({ title, rows: [row(message), ...details.map(text => row(text)), row(), row(selected ? '  [ Нет ]     < Да >' : '  < Нет >     [ Да ]', true)], footer: '←→ / Tab — выбор   Enter — подтвердить   Esc — отменить', focus: details.length + 2 }), (text, key, finish) => {
+      if (cancelKey(key)) return finish(false);
+      if (['left', 'right', 'tab'].includes(key.name)) selected = 1 - selected;
+      if (key.name === 'return') finish(Boolean(selected));
+    });
+  }
+  async commands(initial) {
+    const commands = [...initial];
+    let selected = 0;
+    await this.show(() => ({
+      title: 'Команды после обновления',
+      rows: [row('Выполняются по порядку. Ошибка останавливает цепочку.'), row(), ...commands.map((command, index) => row(`${index + 1}. ${command}`, selected === index)), row('+ Добавить команду', selected === commands.length), row('✓ Готово', selected === commands.length + 1)],
+      footer: 'Enter — изменить   Del — удалить   Ctrl+↑↓ — порядок', focus: selected + 2
+    }), async (text, key, finish) => {
+      if (cancelKey(key)) return finish();
+      if (key.ctrl && ['up', 'down'].includes(key.name) && selected < commands.length) {
+        const next = selected + (key.name === 'up' ? -1 : 1);
+        if (next >= 0 && next < commands.length) { [commands[selected], commands[next]] = [commands[next], commands[selected]]; selected = next; }
+      } else if (key.name === 'up') selected = Math.max(0, selected - 1);
+      else if (key.name === 'down' || key.name === 'tab') selected = (selected + 1) % (commands.length + 2);
+      else if (key.name === 'delete' && selected < commands.length) commands.splice(selected, 1);
+      else if (key.name === 'return') {
+        if (selected === commands.length + 1) return finish();
+        const command = await this.inputText(selected === commands.length ? 'Новая команда' : `Команда ${selected + 1}`, commands[selected] || '', 'Shell-команда в папке проекта; например npm ci');
+        if (command?.trim()) commands[selected] = command.trim();
+      }
+      selected = Math.min(selected, commands.length + 1);
+    });
+    return commands;
+  }
+  async projectForm({ folder, existing, validate, start = true }) {
+    const value = { folder, name: existing?.name || '', interval: existing ? `${existing.interval / 1000}s` : '5m', timeout: existing ? `${existing.commandTimeout / 1000}s` : '10m', commands: [...(existing?.commands || [])], trusted: false, enabled: start };
+    let selected = 0, error = '';
+    const fields = ['folder', 'name', 'interval', 'timeout', 'commands', 'trusted', ...(!existing ? ['enabled'] : []), 'save', 'cancel'];
+    const labels = { folder: 'Папка', name: 'Название', interval: 'Проверять каждые', timeout: 'Лимит одной команды' };
+    const hints = { folder: 'Корень Git-репозитория. Ctrl+U очищает поле.', name: 'Оставьте пустым для названия по имени папки.', interval: 'Например 30s, 5m, 1h. Минимум 10 секунд.', timeout: 'Максимальное время выполнения одной команды.' };
+    return this.show(() => ({
+      title: existing ? `Настройка: ${existing.name}` : 'Добавить проект',
+      rows: [row('Выберите поле и нажмите Enter для изменения.'), row(), ...fields.map((field, index) => {
+        let text;
+        if (labels[field]) text = `${labels[field].padEnd(21)} ${value[field] || '(автоматически)'}`;
+        if (field === 'commands') text = `Команды по порядку     ${value.commands.length ? value.commands.join(' → ') : '(не заданы)'}`;
+        if (field === 'trusted') text = `[${value.trusted ? 'x' : ' '}] Разрешить обновление и указанные команды`;
+        if (field === 'enabled') text = `[${value.enabled ? 'x' : ' '}] Запустить после сохранения`;
+        if (field === 'save') text = '                         [ Сохранить ]';
+        if (field === 'cancel') text = '                         [ Отмена ]';
+        return row(text, selected === index);
+      }), row(), row(error || 'Git hooks отключены. Команды выполняются от вашего имени.', false, Boolean(error))],
+      footer: 'Tab / ↑↓ — поле   Enter — выбрать   Space — переключить', focus: selected + 2
+    }), async (text, key, finish) => {
+      if (cancelKey(key)) return finish(null);
+      if (key.name === 'up' || (key.name === 'tab' && key.shift)) selected = (selected - 1 + fields.length) % fields.length;
+      else if (key.name === 'down' || key.name === 'tab') selected = (selected + 1) % fields.length;
+      else if (key.name === 'return' || text === ' ') {
+        const field = fields[selected];
+        if (['trusted', 'enabled'].includes(field)) value[field] = !value[field];
+        else if (key.name === 'return') {
+          if (field === 'cancel') return finish(null);
+          if (field === 'commands') value.commands = await this.commands(value.commands);
+          else if (field === 'save') {
+            if (!value.trusted) { error = 'Сначала разрешите обновление и запуск указанных команд.'; return; }
+            error = 'Проверка репозитория…'; this.draw();
+            try { finish(await validate(value)); } catch (e) { error = e.message; }
+          } else {
+            const result = await this.inputText(labels[field], value[field], hints[field]);
+            if (result !== null) value[field] = result.trim();
+          }
+        }
+      }
+    });
+  }
+  async viewer(title, read) {
+    let offset = 0, following = true;
+    return this.show((width, capacity) => {
+      const lines = read().split('\n').flatMap(line => {
+        const text = chars(line), pieces = [];
+        for (let index = 0; index < text.length; index += width) pieces.push(row(text.slice(index, index + width).join('')));
+        return pieces.length ? pieces : [row()];
+      });
+      if (following) offset = Math.max(0, lines.length - capacity);
+      offset = Math.max(0, Math.min(offset, Math.max(0, lines.length - capacity)));
+      return { title, rows: lines.slice(offset, offset + capacity), footer: '↑↓ / PgUp PgDn — прокрутка   End — следить   Esc — назад' };
+    }, (text, key, finish) => {
+      if (cancelKey(key) || text === 'q') return finish();
+      if (key.name === 'end') following = true;
+      else if (['up', 'down', 'pageup', 'pagedown', 'home'].includes(key.name)) {
+        following = false;
+        offset = key.name === 'home' ? 0 : offset + ({ up: -1, down: 1, pageup: -10, pagedown: 10 }[key.name]);
+      }
+    });
+  }
+  async dashboard({ projects, status, state, daemon, action, logs }) {
+    let selected = 0, processing = false;
+    return this.show((width, capacity) => {
+      const items = projects(); selected = Math.max(0, Math.min(selected, items.length - 1));
+      const p = items[selected], s = p ? state(p.id) : {};
+      const count = Math.max(1, capacity - 11), first = Math.max(0, selected - count + 1);
+      return {
+        title: `Проекты · daemon ${daemon() ? 'работает' : 'выключен'}`,
+        rows: [row('  ПРОЕКТ                   СТАТУС       ИНТЕРВАЛ'), row(), ...(items.length ? items.slice(first, first + count).map((item, index) => row(`${index + first === selected ? '›' : ' '} ${fit(item.name, 24)} ${fit(status(item), 12)} ${item.interval / 1000}s`, index + first === selected)) : [row('Проектов нет. Нажмите A, чтобы добавить.')]), row(), ...(p ? [row(p.path), row(`Ветка: ${p.branch} → ${p.upstream}`), row(`Проверка: ${s.checkedAt || '—'}`), row(`Обновление: ${s.updatedAt || '—'}`), row(`Следующая проверка: ${p.enabled && !s.blocked && s.nextRun ? new Date(s.nextRun).toLocaleTimeString() : '—'}`), row(s.error || '', false, Boolean(s.error))] : []), row(), row(processing ? 'Выполнение…' : this.notice)],
+        footer: 'A добавить  Enter меню  Space старт/стоп  L логи  Q выход', focus: selected - first + 2
+      };
+    }, async (text, key, finish) => {
+      if (cancelKey(key) || text === 'q') return finish();
+      const items = projects(), p = items[selected];
+      if (key.name === 'up') selected = Math.max(0, selected - 1);
+      else if (key.name === 'down' || key.name === 'tab') selected = Math.min(items.length - 1, selected + 1);
+      else if (text === 'l' && p) await this.viewer(`Логи: ${p.name}`, () => logs(p));
+      else {
+        let command = text === 'a' ? 'add' : ({ ' ': p?.enabled ? 'stop' : 'start', e: 'edit', p: 'pull', r: 'retry', d: 'remove' })[text];
+        if (key.name === 'return' && p) command = await this.menu(p.name, [
+          [p.enabled ? 'Остановить расписание' : 'Запустить / возобновить', p.enabled ? 'stop' : 'start'],
+          ['Обновить сейчас', 'pull'], ['Настройки', 'edit'], ['Логи', 'logs'],
+          ['Повторить команды', 'retry'], ['Снять незавершённые команды', 'accept'], ['Удалить из реестра', 'remove']
+        ]);
+        if (command === 'logs') await this.viewer(`Логи: ${p.name}`, () => logs(p));
+        else if (command && (p || command === 'add')) {
+          processing = true; this.notice = ''; this.draw();
+          try { await action(command, p, this); }
+          catch (e) { this.notice = e.message; }
+          finally { processing = false; }
+        }
+      }
+    });
+  }
+  async menu(title, items) {
+    let selected = 0;
+    return this.show(() => ({ title, rows: items.map(([label], index) => row(`  ${label}`, index === selected)), footer: '↑↓ / Tab — выбор   Enter — открыть   Esc — назад', focus: selected }), (text, key, finish) => {
+      if (cancelKey(key)) return finish(null);
+      if (key.name === 'up' || (key.name === 'tab' && key.shift)) selected = (selected - 1 + items.length) % items.length;
+      else if (key.name === 'down' || key.name === 'tab') selected = (selected + 1) % items.length;
+      else if (key.name === 'return') finish(items[selected][1]);
+    });
+  }
+}
+
+export const withTerminal = fn => new Terminal().open(fn);