@tensor.chat/companion 0.4.2 → 0.4.4

package/src/setup/lang/pt.js

@@ -0,0 +1,68 @@
+'use strict';
+// The setup's words in Portuguese (Brazil, as on the site).
+
+module.exports = {
+  setup: 'configuração',
+  steps: ['O quê', 'Pastas', 'Comandos', 'Salvar'],
+  'start.title': 'O que a IA pode usar neste computador?',
+  'start.folders': 'Escolher pastas', 'start.foldersNote': 'recomendado',
+  'start.nothing': 'Nada por enquanto', 'start.nothingNote': 'uma conversa pergunta quando precisar de uma pasta',
+  'start.everything': 'Tudo', 'start.everythingNote': 'não recomendado',
+  'start.help': 'A IA lê, altera e exclui arquivos somente onde você permitir aqui.',
+  'start.now': 'Aprovado agora:',
+  'start.later': 'Altere quando quiser:',
+  'places.title': 'Quais pastas a IA pode usar?',
+  'places.loading': 'Procurando pastas…',
+  'places.none': 'Nenhuma sugestão neste computador.',
+  'places.browse': 'Procurar em todas as pastas…', 'places.type': 'Digitar um caminho…', 'places.continue': 'Continuar',
+  selected: 'Seleção: {n}',
+  'note.git': '{n} projetos Git', 'note.git1': '1 projeto Git', 'note.project': 'projeto Git',
+  'note.web': 'sites', 'note.srv': 'dados do servidor', 'note.opt': 'programas instalados',
+  'note.etc': 'configurações do sistema', 'note.log': 'logs', 'note.home': 'toda a sua pasta pessoal',
+  'note.readOnly': 'somente leitura para você', 'note.added': 'adicionada por você', 'note.earlier': 'aprovada antes',
+  'note.inside': 'dentro de {path}',
+  'help.home': 'Tudo em {home}, inclusive configurações ocultas e chaves como ~/.ssh.',
+  'help.etc': 'Configurações de todo o sistema. Uma alteração errada ali pode derrubar o servidor.',
+  'help.log': 'Logs do sistema e de seus serviços. Úteis para encontrar erros.',
+  'help.web': 'Arquivos dos sites hospedados neste servidor.',
+  'help.srv': 'Dados dos serviços deste servidor.',
+  'help.opt': 'Programas instalados fora do gerenciador de pacotes.',
+  'help.code': 'Seus projetos de código.',
+  'help.readOnly': 'Aqui você pode ler, mas não escrever. A IA pode fazer o mesmo, nada mais.',
+  'help.browse': 'Escolha qualquer pasta deste computador, como em um gerenciador de arquivos.',
+  'help.type': 'Digite um caminho completo. Tab completa.',
+  'help.continue': 'Próximo: comandos.',
+  'browse.title': 'Procurar', 'browse.thisPc': 'Este Computador',
+  'browse.loading': 'carregando…', 'browse.empty': 'nenhuma pasta', 'browse.noAccess': 'sem acesso', 'browse.link': 'link',
+  'browse.blocked': '{path} está dentro de {parent}, que já está selecionada.',
+  'browse.hidden': 'As pastas ocultas estão visíveis.', 'browse.hiddenOff': 'As pastas ocultas não são mostradas.',
+  'type.title': 'Digite o caminho de uma pasta', 'type.label': 'Caminho',
+  'type.notFound': 'A pasta {path} não existe.',
+  'everything.title': 'Compartilhar tudo?',
+  'everything.body': 'A IA pode ler, alterar e excluir qualquer arquivo que {user} consiga acessar neste computador.',
+  'everything.root': 'Você é root: isso inclui cada arquivo do sistema, inclusive o próprio sistema.',
+  'everything.free': 'Assim a IA pode trabalhar livremente neste servidor. Não recomendado.',
+  'everything.no': 'Não, voltar', 'everything.yes': 'Sim, compartilhar tudo',
+  'everything.summary': 'Tudo neste computador',
+  'shell.title': 'A IA pode executar comandos aqui?',
+  'shell.body': 'Os comandos são executados como {user}, com acesso total à Internet. Eles não se limitam às pastas compartilhadas.',
+  'shell.keep': 'Manter como está', 'shell.keepNote': 'até {date}',
+  'shell.no': 'Agora não', 'shell.noNote': 'uma conversa pergunta antes quando precisar deles',
+  'shell.off': 'Desativar', 'shell.offNote': 'uma conversa pergunta antes quando precisar deles',
+  'shell.d7': 'Sim, por 7 dias', 'shell.d30': 'Sim, por 30 dias', 'shell.d365': 'Sim, por um ano',
+  'review.title': 'Revisar e salvar',
+  'review.folders': 'Pastas', 'review.commands': 'Comandos',
+  'review.noFolders': 'nenhuma — uma conversa pergunta quando precisar de uma',
+  'review.removed': 'aprovação removida',
+  'review.cmdNo': 'não aprovados — uma conversa pergunta antes',
+  'review.cmdUntil': 'aprovados até {date}',
+  'review.save': 'Salvar', 'review.back': 'Voltar', 'review.quit': 'Sair sem salvar',
+  'review.where': 'Salvo somente neste computador, em {file}',
+  keyNames: { space: 'espaço', enter: 'enter', esc: 'esc', tab: 'tab', backspace: 'backspace' },
+  keys: { move: 'mover', select: 'escolher', toggle: 'marcar', back: 'voltar', quit: 'sair', open: 'abrir', close: 'fechar', openClose: 'abrir/fechar', up: 'pasta acima', hidden: 'ocultas', done: 'concluir', tab: 'completar', add: 'adicionar' },
+  'done.saved': 'Salvo neste computador.',
+  'done.unchanged': 'Nada foi alterado.',
+  'done.web': 'Quando uma conversa no tensor.chat compartilhar uma dessas pastas, este computador confirma isso sozinho.',
+  'done.run': 'Inicie o Companion com:',
+  'done.noTty': 'A configuração precisa de um terminal interativo. Sem um, use approve-folder e approve-shell.',
+};

package/src/setup/lang/ru.js

@@ -0,0 +1,69 @@
+'use strict';
+// The setup's words in Russian. A count comes after a colon ("Выбрано: 3"), so no
+// word has to take one of the three plural forms.
+
+module.exports = {
+  setup: 'настройка',
+  steps: ['Что', 'Папки', 'Команды', 'Сохранение'],
+  'start.title': 'Что ИИ может использовать на этом компьютере?',
+  'start.folders': 'Выбрать папки', 'start.foldersNote': 'рекомендуется',
+  'start.nothing': 'Пока ничего', 'start.nothingNote': 'чат спросит, когда ему понадобится папка',
+  'start.everything': 'Всё', 'start.everythingNote': 'не рекомендуется',
+  'start.help': 'ИИ читает, изменяет и удаляет файлы только там, где вы это здесь разрешите.',
+  'start.now': 'Сейчас разрешено:',
+  'start.later': 'Изменить можно в любой момент:',
+  'places.title': 'Какие папки может использовать ИИ?',
+  'places.loading': 'Ищем папки…',
+  'places.none': 'На этом компьютере нет предложений.',
+  'places.browse': 'Обзор всех папок…', 'places.type': 'Ввести путь…', 'places.continue': 'Продолжить',
+  selected: 'Выбрано: {n}',
+  'note.git': 'Git-проектов: {n}', 'note.git1': '1 Git-проект', 'note.project': 'Git-проект',
+  'note.web': 'сайты', 'note.srv': 'данные сервера', 'note.opt': 'установленные программы',
+  'note.etc': 'настройки системы', 'note.log': 'журналы', 'note.home': 'вся ваша домашняя папка',
+  'note.readOnly': 'для вас только чтение', 'note.added': 'добавлена вами', 'note.earlier': 'разрешена ранее',
+  'note.inside': 'внутри {path}',
+  'help.home': 'Всё в {home}, включая скрытые настройки и ключи, например ~/.ssh.',
+  'help.etc': 'Настройки всей системы. Неверное изменение здесь может остановить сервер.',
+  'help.log': 'Журналы системы и её служб. Помогают находить ошибки.',
+  'help.web': 'Файлы сайтов, которые отдаёт этот сервер.',
+  'help.srv': 'Данные служб на этом сервере.',
+  'help.opt': 'Программы, установленные в обход менеджера пакетов.',
+  'help.code': 'Ваши проекты с кодом.',
+  'help.readOnly': 'Здесь вы можете читать, но не писать. ИИ может то же самое, не больше.',
+  'help.browse': 'Выберите любую папку на этом компьютере, как в файловом менеджере.',
+  'help.type': 'Введите полный путь. Tab дополняет его.',
+  'help.continue': 'Далее: команды.',
+  'browse.title': 'Обзор', 'browse.thisPc': 'Этот компьютер',
+  'browse.loading': 'загрузка…', 'browse.empty': 'нет папок', 'browse.noAccess': 'нет доступа', 'browse.link': 'ссылка',
+  'browse.blocked': '{path} находится внутри {parent}, а эта папка уже выбрана.',
+  'browse.hidden': 'Скрытые папки показаны.', 'browse.hiddenOff': 'Скрытые папки не показываются.',
+  'type.title': 'Введите путь к папке', 'type.label': 'Путь',
+  'type.notFound': 'Папки {path} не существует.',
+  'everything.title': 'Открыть доступ ко всему?',
+  'everything.body': 'ИИ сможет читать, изменять и удалять любой файл, доступный пользователю {user} на этом компьютере.',
+  'everything.root': 'Вы root: это все файлы системы, включая саму систему.',
+  'everything.free': 'Так ИИ сможет свободно работать на этом сервере. Не рекомендуется.',
+  'everything.no': 'Нет, назад', 'everything.yes': 'Да, открыть доступ ко всему',
+  'everything.summary': 'Всё на этом компьютере',
+  'shell.title': 'Может ли ИИ выполнять здесь команды?',
+  'shell.body': 'Команды выполняются от имени {user}, с полным доступом в Интернет. Они не ограничены общими папками.',
+  'shell.keep': 'Оставить как есть', 'shell.keepNote': 'до {date}',
+  'shell.no': 'Не сейчас', 'shell.noNote': 'чат сначала спросит, когда они понадобятся',
+  'shell.off': 'Отключить', 'shell.offNote': 'чат сначала спросит, когда они понадобятся',
+  'shell.d7': 'Да, на 7 дней', 'shell.d30': 'Да, на 30 дней', 'shell.d365': 'Да, на год',
+  'review.title': 'Проверка и сохранение',
+  'review.folders': 'Папки', 'review.commands': 'Команды',
+  'review.noFolders': 'нет — чат спросит, когда ему понадобится папка',
+  'review.removed': 'разрешение отозвано',
+  'review.cmdNo': 'не разрешены — чат сначала спросит',
+  'review.cmdUntil': 'разрешены до {date}',
+  'review.save': 'Сохранить', 'review.back': 'Назад', 'review.quit': 'Выйти без сохранения',
+  'review.where': 'Сохраняется только на этом компьютере, в {file}',
+  keyNames: { space: 'пробел', enter: 'Enter', esc: 'Esc', tab: 'Tab', backspace: 'Backspace' },
+  keys: { move: 'перемещение', select: 'выбор', toggle: 'отметить', back: 'назад', quit: 'выход', open: 'открыть', close: 'закрыть', openClose: 'открыть/закрыть', up: 'папка выше', hidden: 'скрытые', done: 'готово', tab: 'дополнить', add: 'добавить' },
+  'done.saved': 'Сохранено на этом компьютере.',
+  'done.unchanged': 'Ничего не изменилось.',
+  'done.web': 'Когда чат на tensor.chat откроет доступ к одной из этих папок, этот компьютер подтвердит это сам.',
+  'done.run': 'Запустите Companion командой:',
+  'done.noTty': 'Для настройки нужен интерактивный терминал. Без него используйте approve-folder и approve-shell.',
+};

package/src/setup/lang/zh.js

@@ -0,0 +1,68 @@
+'use strict';
+// The setup's words in Chinese (Simplified).
+
+module.exports = {
+  setup: '设置',
+  steps: ['范围', '文件夹', '命令', '保存'],
+  'start.title': 'AI 可以使用这台电脑上的哪些内容？',
+  'start.folders': '选择文件夹', 'start.foldersNote': '推荐',
+  'start.nothing': '暂不共享', 'start.nothingNote': '聊天需要文件夹时会询问',
+  'start.everything': '全部', 'start.everythingNote': '不推荐',
+  'start.help': 'AI 只会在你在这里允许的位置读取、修改和删除文件。',
+  'start.now': '当前已批准：',
+  'start.later': '随时可以更改：',
+  'places.title': 'AI 可以使用哪些文件夹？',
+  'places.loading': '正在查找文件夹…',
+  'places.none': '这台电脑上没有建议。',
+  'places.browse': '浏览所有文件夹…', 'places.type': '输入路径…', 'places.continue': '继续',
+  selected: '已选 {n} 个',
+  'note.git': '{n} 个 Git 项目', 'note.git1': '1 个 Git 项目', 'note.project': 'Git 项目',
+  'note.web': '网站', 'note.srv': '服务器数据', 'note.opt': '已安装的程序',
+  'note.etc': '系统设置', 'note.log': '日志', 'note.home': '你的整个主目录',
+  'note.readOnly': '你只能读取', 'note.added': '由你添加', 'note.earlier': '之前已批准',
+  'note.inside': '位于 {path} 内',
+  'help.home': '{home} 中的所有内容，也包括隐藏的设置和密钥，例如 ~/.ssh。',
+  'help.etc': '整个系统的设置。改错一处就可能让服务器停止运行。',
+  'help.log': '系统及其服务的日志。便于排查错误。',
+  'help.web': '此服务器提供的网站文件。',
+  'help.srv': '此服务器上各项服务的数据。',
+  'help.opt': '在软件包管理器之外安装的程序。',
+  'help.code': '你的代码项目。',
+  'help.readOnly': '你在这里只能读取，不能写入。AI 也只有同样的权限。',
+  'help.browse': '像在文件管理器中一样，选择这台电脑上的任意文件夹。',
+  'help.type': '输入完整路径。按 Tab 自动补全。',
+  'help.continue': '下一步：命令。',
+  'browse.title': '浏览', 'browse.thisPc': '此电脑',
+  'browse.loading': '加载中…', 'browse.empty': '没有文件夹', 'browse.noAccess': '无权访问', 'browse.link': '链接',
+  'browse.blocked': '{path} 位于 {parent} 内，而后者已被选择。',
+  'browse.hidden': '隐藏文件夹已显示。', 'browse.hiddenOff': '隐藏文件夹未显示。',
+  'type.title': '输入文件夹路径', 'type.label': '路径',
+  'type.notFound': '文件夹 {path} 不存在。',
+  'everything.title': '共享全部内容？',
+  'everything.body': 'AI 可以读取、修改和删除 {user} 在这台电脑上能访问的所有文件。',
+  'everything.root': '你是 root：这意味着系统中的所有文件，包括系统本身。',
+  'everything.free': '这样 AI 可以在这台服务器上自由工作。不推荐。',
+  'everything.no': '不，返回', 'everything.yes': '是，共享全部',
+  'everything.summary': '这台电脑上的全部内容',
+  'shell.title': 'AI 可以在这里运行命令吗？',
+  'shell.body': '命令以 {user} 身份运行，并可完全访问互联网。命令不限于共享的文件夹。',
+  'shell.keep': '保持不变', 'shell.keepNote': '到 {date} 为止',
+  'shell.no': '暂不', 'shell.noNote': '聊天需要时会先询问',
+  'shell.off': '关闭', 'shell.offNote': '聊天需要时会先询问',
+  'shell.d7': '是，7 天', 'shell.d30': '是，30 天', 'shell.d365': '是，一年',
+  'review.title': '检查并保存',
+  'review.folders': '文件夹', 'review.commands': '命令',
+  'review.noFolders': '无 — 聊天需要时会询问',
+  'review.removed': '已撤销批准',
+  'review.cmdNo': '未批准 — 聊天会先询问',
+  'review.cmdUntil': '已批准，到 {date} 为止',
+  'review.save': '保存', 'review.back': '返回', 'review.quit': '退出且不保存',
+  'review.where': '仅保存在这台电脑上的 {file} 中',
+  keyNames: { space: '空格', enter: 'Enter', esc: 'Esc', tab: 'Tab', backspace: '退格' },
+  keys: { move: '移动', select: '选择', toggle: '勾选', back: '返回', quit: '退出', open: '展开', close: '收起', openClose: '展开/收起', up: '上一级', hidden: '隐藏项', done: '完成', tab: '补全', add: '添加' },
+  'done.saved': '已保存在这台电脑上。',
+  'done.unchanged': '没有更改。',
+  'done.web': '当 tensor.chat 上的聊天共享其中某个文件夹时，这台电脑会自动确认。',
+  'done.run': '使用以下命令启动 Companion：',
+  'done.noTty': '设置需要交互式终端。没有终端时，请使用 approve-folder 和 approve-shell。',
+};

package/src/setup/layout.js

@@ -0,0 +1,167 @@
+'use strict';
+// How the setup's lines are laid out: wrapped text, columns, the key hints and framed
+// blocks. Widths count what the terminal shows, not the escape codes.
+
+const { width, pad, fit } = require('./term');
+
+const ESC_SPLIT = /(\x1b\[[0-9;?]*[A-Za-z])/;
+// Chinese and Japanese break between any two characters, but a line never starts
+// with closing punctuation or ends with opening punctuation
+const NO_START = new Set([...'、。，．：；？！）」』】〕》〉…・ー〜％’”),.:;?!%]}']);
+const NO_END = new Set([...'（「『【〔《〈‘“([{']);
+
+// The text's runs that stay together on a line, each knowing whether a space came
+// before it. Only a real space separates words: French keeps its no-break space.
+function runs(text) {
+  const out = [];
+  let run = null;
+  let spaced = false;
+  let pending = '';
+  let prev = '';
+  for (const part of String(text).split(ESC_SPLIT)) {
+    if (part.startsWith('\x1b[')) { pending += part; continue; }
+    for (const ch of part) {
+      // codes right before a space end the word before it
+      if (/[ \t\r\n]/.test(ch)) { if (run) { run.s += pending; pending = ''; out.push(run); } run = null; spaced = out.length > 0; prev = ''; continue; }
+      const w = width(ch);
+      if (run && (w === 2 || width(prev) === 2) && !NO_START.has(ch) && !NO_END.has(prev)) { out.push(run); run = null; }
+      if (!run) { run = { s: '', w: 0, spaced }; spaced = false; }
+      run.s += pending + ch;
+      run.w += w;
+      pending = '';
+      prev = ch;
+    }
+  }
+  if (run) out.push(run);
+  if (pending && out.length) out[out.length - 1].s += pending;
+  return out;
+}
+
+// The colours and weights still switched on after `s`, given those before it
+function sgrAfter(active, s) {
+  let on = active;
+  for (const [, params] of s.matchAll(/\x1b\[([0-9;]*)m/g)) {
+    for (const p of params.split(';')) {
+      if (p === '' || p === '0') on = [];
+      else if (p === '22') on = on.filter((x) => x !== '1' && x !== '2');
+      else if (p === '24' || p === '27') on = on.filter((x) => x !== String(p - 20));
+      else if (p === '39') on = on.filter((x) => !/^(3[0-7]|9[0-7])$/.test(x));
+      else on = [...on, p];
+    }
+  }
+  return on;
+}
+
+// Lines of at most `cols` cells. A styled text keeps its style on every line.
+function wrap(text, cols) {
+  const lines = [];
+  let line = '';
+  let used = 0;
+  let on = [];
+  const add = (s, w) => { line += s; used += w; on = sgrAfter(on, s); };
+  const next = () => {
+    lines.push(line + (on.length ? '\x1b[0m' : ''));
+    line = on.map((p) => `\x1b[${p}m`).join('');
+    used = 0;
+  };
+  for (const run of runs(text)) {
+    const gap = used && run.spaced ? 1 : 0;
+    if (used && used + gap + run.w > cols) next();
+    else if (gap) add(' ', 1);
+    if (used + run.w <= cols) { add(run.s, run.w); continue; }
+    // a run longer than a whole line, like a long path, is cut where the line ends
+    for (const unit of run.s.match(/(?:\x1b\[[0-9;?]*[A-Za-z])*(?:[^\x1b]|$)/gu)) {
+      const w = width(unit);
+      if (used && used + w > cols) next();
+      add(unit, w);
+    }
+  }
+  if (used) lines.push(line + (on.length ? '\x1b[0m' : ''));
+  return lines;
+}
+
+// A path too long for its place loses its middle: the start says where, the end which
+function shorten(text, cols) {
+  if (width(text) <= cols) return text;
+  const chars = [...text];
+  let head = '';
+  while (width(head) < Math.floor((cols - 1) / 3)) head += chars.shift();
+  // both cuts fall on a separator where there is one
+  const sep = Math.max(head.lastIndexOf('/'), head.lastIndexOf('\\'));
+  if (sep > 0) { chars.unshift(...head.slice(sep + 1)); head = head.slice(0, sep + 1); }
+  let tail = '';
+  while (chars.length && width(tail) + width(chars[chars.length - 1]) <= cols - 1 - width(head)) tail = chars.pop() + tail;
+  const start = tail.search(/[\\/]/);
+  if (start > 0) tail = tail.slice(start);
+  return `${head}…${tail}`;
+}
+
+// A label in its column, always followed by a gap
+function cell(label, col) {
+  return pad(label, col - 2) + '  ';
+}
+
+function spread(left, right, cols) {
+  return left + ' '.repeat(Math.max(1, cols - width(left) - width(right))) + right;
+}
+
+// The key hints, on as many lines as the width needs
+function keyLines(S, keys, w) {
+  const lines = [''];
+  for (const [k, label] of keys) {
+    const part = `${S.bold(k)} ${S.dim(label)}`;
+    const last = lines[lines.length - 1];
+    if (last && width(last) + 3 + width(part) > w) lines.push(part); else lines[lines.length - 1] = last ? `${last}   ${part}` : part;
+  }
+  return lines.map((l) => '  ' + l);
+}
+
+// A framed block: a warning in yellow, a note in grey
+function panel(S, lines, tone, w) {
+  const edge = (s) => (tone ? S[tone](s) : S.dim(s));
+  const inner = [];
+  for (const l of lines) inner.push(...(width(l) <= w - 4 ? [l] : wrap(l, w - 4)));
+  return [
+    '  ' + edge('╭' + '─'.repeat(w - 2) + '╮'),
+    ...inner.map((l) => '  ' + edge('│') + ' ' + pad(l, w - 4) + ' ' + edge('│')),
+    '  ' + edge('╰' + '─'.repeat(w - 2) + '╯'),
+  ];
+}
+
+// At most `n` of the lines; a cut note ends in "…"
+function clip(lines, n, cols) {
+  if (lines.length <= n) return lines;
+  const last = lines[n - 1];
+  return [...lines.slice(0, n - 1), width(last) + 2 <= cols ? `${last} …` : fit(last, width(last) - 1)];
+}
+
+// The frame's top and bottom for a screen of `rows` lines. Before the list gets fewer
+// than three lines, these give way in turn: a third line of the note, the blank lines
+// on top, the gap above the keys, the rule, the steps, a second line of the note.
+function squeeze({ rows, width: cols, brand, steps, heading, note, rule, keys }) {
+  const at = (l) => '  ' + l;
+  let noteMax = 3;
+  let blanks = true;
+  let gap = 1;
+  let stepped = true;
+  let ruled = true;
+  const build = () => {
+    const blank = blanks ? [''] : [];
+    const said = clip(note, noteMax, cols).map(at);
+    return {
+      top: [...blank, ...brand.map(at), ...(stepped ? [at(steps)] : []), ...blank, ...heading.map(at), ...blank],
+      bottom: [...(said.length ? said : ['']), ...(ruled ? [at(rule)] : []), ...keys],
+      gap,
+    };
+  };
+  const giveWay = [() => { noteMax = 2; }, () => { blanks = false; }, () => { gap = 0; }, () => { ruled = false; }, () => { stepped = false; }, () => { noteMax = 1; }];
+  let parts = build();
+  for (const next of giveWay) {
+    if (parts.top.length + parts.bottom.length + parts.gap + 3 <= rows) break;
+    next();
+    parts = build();
+  }
+  return parts;
+}
+
+module.exports = { wrap, shorten, cell, spread, keyLines, panel, squeeze };

package/src/setup/places.js

@@ -0,0 +1,113 @@
+'use strict';
+// Folders worth offering on this computer: where code, documents and server data
+// usually live. Only folders that exist are offered, each once.
+
+const fs = require('fs');
+const path = require('path');
+
+const fsp = fs.promises;
+const CODE_DIRS = ['projects', 'Projects', 'src', 'code', 'Code', 'dev', 'Developer', 'git', 'repos', 'workspace', 'work', path.join('source', 'repos')];
+// Where a server keeps its sites, data, programs, settings and logs
+const SYSTEM = {
+  linux: [['/var/www', 'web'], ['/srv', 'srv'], ['/opt', 'opt'], ['/etc', 'etc'], ['/var/log', 'log']],
+};
+const GIT_LOOK_LIMIT = 300;
+const PROJECTS_IN_HOME = 8;
+
+async function isDir(p) {
+  try { return (await fsp.stat(p)).isDirectory(); } catch (_) { return false; }
+}
+
+async function writable(p) {
+  try { await fsp.access(p, fs.constants.W_OK); return true; } catch (_) { return false; }
+}
+
+async function hasEntries(p) {
+  try { return (await fsp.readdir(p)).length > 0; } catch (_) { return false; }
+}
+
+async function subfolders(dir) {
+  try {
+    return (await fsp.readdir(dir, { withFileTypes: true }))
+      .filter((d) => d.isDirectory() && !d.name.startsWith('.') && d.name !== 'node_modules')
+      .map((d) => path.join(dir, d.name));
+  } catch (_) { return []; }
+}
+
+// Git projects in a folder and one level below; looks at no more than `limit` folders
+async function countGit(dir, limit = GIT_LOOK_LIMIT) {
+  if (await isDir(path.join(dir, '.git'))) return 1;
+  const first = (await subfolders(dir)).slice(0, limit);
+  let n = 0;
+  let looked = first.length;
+  for (const sub of first) {
+    if (await isDir(path.join(sub, '.git'))) { n++; continue; }
+    if (looked >= limit) continue;
+    const second = (await subfolders(sub)).slice(0, limit - looked);
+    looked += second.length;
+    for (const deeper of second) if (await isDir(path.join(deeper, '.git'))) n++;
+  }
+  return n;
+}
+
+// ~/.config/user-dirs.dirs names the desktop, documents and downloads folders, in the
+// computer's language (XDG_DOCUMENTS_DIR="$HOME/Dokumente")
+async function xdgUserDirs(home) {
+  const found = {};
+  try {
+    const text = await fsp.readFile(path.join(home, '.config', 'user-dirs.dirs'), 'utf8');
+    for (const m of text.matchAll(/^XDG_(DESKTOP|DOCUMENTS|DOWNLOAD)_DIR="([^"]+)"/gm)) {
+      found[m[1]] = m[2].startsWith('$HOME/') ? path.join(home, ...m[2].slice(6).split('/')) : m[2];
+    }
+  } catch (_) {}
+  return found;
+}
+
+async function candidates({ platform, home, env, system }) {
+  const list = [];
+  const add = (p, kind) => { if (p) list.push({ path: p, kind }); };
+  for (const d of CODE_DIRS) add(path.join(home, d), 'code');
+  if (platform === 'linux') {
+    const xdg = await xdgUserDirs(home);
+    add(xdg.DOCUMENTS || path.join(home, 'Documents'), 'docs');
+    add(xdg.DESKTOP || path.join(home, 'Desktop'), 'docs');
+    add(xdg.DOWNLOAD || path.join(home, 'Downloads'), 'docs');
+  } else {
+    if (platform === 'win32' && env.OneDrive) add(path.join(env.OneDrive, 'Documents'), 'docs');
+    for (const d of ['Documents', 'Desktop', 'Downloads']) add(path.join(home, d), 'docs');
+  }
+  add(home, 'home');
+  if (platform === 'win32') add(path.join(env.SystemDrive || 'C:', '\\inetpub', 'wwwroot'), 'web');
+  for (const [p, kind] of system) add(p, kind);
+  return list;
+}
+
+// [{ path, kind, git, readOnly }] - kind: code, project, docs, web, srv, opt, home, etc, log
+async function suggestPlaces({ platform = process.platform, home, env = process.env, system = SYSTEM[platform] || [] } = {}) {
+  const seen = new Set();
+  const key = (p) => (platform === 'win32' || platform === 'darwin' ? p.toLowerCase() : p);
+  const out = [];
+  const keep = async (p, kind) => {
+    let real;
+    try { real = await fsp.realpath(p); } catch (_) { return; }
+    if (seen.has(key(real)) || !(await isDir(real))) return;
+    // A server folder that is there but empty helps nobody
+    if ((kind === 'srv' || kind === 'opt') && !(await hasEntries(real))) return;
+    seen.add(key(real));
+    const item = { path: real, kind, git: 0, readOnly: !(await writable(real)) };
+    if (kind === 'code') item.git = await countGit(real);
+    out.push(item);
+  };
+  const list = await candidates({ platform, home, env, system });
+  for (const c of list.filter((x) => x.kind === 'code')) await keep(c.path, c.kind);
+  // Git projects right in the home folder, as on many servers (~/shop, ~/api)
+  let projects = 0;
+  for (const sub of await subfolders(home)) {
+    if (projects >= PROJECTS_IN_HOME) break;
+    if (await isDir(path.join(sub, '.git'))) { await keep(sub, 'project'); projects++; }
+  }
+  for (const c of list.filter((x) => x.kind !== 'code')) await keep(c.path, c.kind);
+  return out;
+}
+
+module.exports = { suggestPlaces, countGit, xdgUserDirs, SYSTEM };

package/src/setup/term.js

@@ -0,0 +1,98 @@
+'use strict';
+// The parts of a terminal the setup screens need: keys in, whole frames out. The
+// screens draw on the alternate screen, so the shell's history stays as it was.
+
+const readline = require('readline');
+
+const CSI = '\x1b[';
+const ANSI_RE = /\x1b\[[0-9;?]*[A-Za-z]/g;
+
+// Colour only where the terminal wants it (https://no-color.org); weight and
+// dimming stay, they carry the layout.
+function styles(color) {
+  const sgr = (open, close, isColor) => (s) => ((isColor && !color) ? String(s) : `${CSI}${open}m${s}${CSI}${close}m`);
+  return {
+    bold: sgr(1, 22), dim: sgr(2, 22), inverse: sgr(7, 27), underline: sgr(4, 24),
+    cyan: sgr(36, 39, true), green: sgr(32, 39, true), yellow: sgr(33, 39, true), red: sgr(31, 39, true), gray: sgr(90, 39, true),
+  };
+}
+
+// Marks that sit on the letter before them, like most Devanagari vowel signs
+const ZERO_WIDTH = /^[\p{Mn}\p{Me}\p{Cf}]$/u;
+
+function charWidth(cp) {
+  if (ZERO_WIDTH.test(String.fromCodePoint(cp))) return 0;
+  // East Asian wide and fullwidth forms take two cells
+  if ((cp >= 0x1100 && cp <= 0x115f) || (cp >= 0x2e80 && cp <= 0xa4cf) || (cp >= 0xac00 && cp <= 0xd7a3)
+    || (cp >= 0xf900 && cp <= 0xfaff) || (cp >= 0xfe30 && cp <= 0xfe4f) || (cp >= 0xff00 && cp <= 0xff60)
+    || (cp >= 0xffe0 && cp <= 0xffe6)) return 2;
+  return 1;
+}
+
+function width(s) {
+  let n = 0;
+  for (const ch of String(s).replace(ANSI_RE, '')) n += charWidth(ch.codePointAt(0));
+  return n;
+}
+
+// Cut a line to the screen width, keeping its escape codes; a cut line ends in "…"
+function fit(line, cols) {
+  if (width(line) <= cols) return line;
+  let out = '';
+  let n = 0;
+  let full = false;
+  for (const part of String(line).split(/(\x1b\[[0-9;?]*[A-Za-z])/)) {
+    if (part.startsWith('\x1b[')) { if (!full) out += part; continue; }
+    for (const ch of part) {
+      const w = charWidth(ch.codePointAt(0));
+      if (full || n + w > cols - 1) { full = true; break; }
+      out += ch;
+      n += w;
+    }
+  }
+  return out + '…' + `${CSI}0m`;
+}
+
+function pad(s, cols) {
+  return s + ' '.repeat(Math.max(0, cols - width(s)));
+}
+
+// Opens the screen: raw keys from `input`, frames to `output`. stop() puts the
+// terminal back the way it was, also after an error.
+function openScreen({ input, output }) {
+  const keyHandlers = [];
+  const onKey = (str, key) => { for (const h of keyHandlers) h(str, key || {}); };
+  const onResize = () => { for (const h of resizeHandlers) h(); };
+  const resizeHandlers = [];
+  let open = false;
+  readline.emitKeypressEvents(input);
+  return {
+    start() {
+      if (input.isTTY && typeof input.setRawMode === 'function') input.setRawMode(true);
+      input.on('keypress', onKey);
+      output.on('resize', onResize);
+      input.resume();
+      output.write(`${CSI}?1049h${CSI}?25l`);
+      open = true;
+    },
+    size() { return { cols: Math.max(40, output.columns || 80), rows: Math.max(12, output.rows || 24) }; },
+    draw(lines) {
+      const { cols, rows } = this.size();
+      const shown = lines.slice(0, rows).map((l) => fit(l, cols) + `${CSI}K`);
+      output.write(`${CSI}H` + shown.join('\r\n') + `${CSI}0m${CSI}J`);
+    },
+    onKey(h) { keyHandlers.push(h); },
+    onResize(h) { resizeHandlers.push(h); },
+    stop() {
+      if (!open) return;
+      open = false;
+      input.removeListener('keypress', onKey);
+      output.removeListener('resize', onResize);
+      if (input.isTTY && typeof input.setRawMode === 'function') input.setRawMode(false);
+      input.pause();
+      output.write(`${CSI}0m${CSI}?25h${CSI}?1049l`);
+    },
+  };
+}
+
+module.exports = { styles, width, fit, pad, openScreen };