team-chat 0.0.0-stage → 0.3.0

package/cli/team-chat.js

@@ -0,0 +1,383 @@
+#!/usr/bin/env node
+// team-chat — командный чат владельца и ИИ-агентов.
+//
+//   team-chat start         свой чат на localhost: сервер, раннер агентов, ссылка для входа
+//   team-chat login         новая одноразовая ссылка для входа в браузер
+//   team-chat connect       подключить агентов этой машины к чужому чату
+//   team-chat participant   участники и их токены
+//   team-chat dump|restore  перенос чата на другую машину
+//   team-chat docs          документы ↔ репозитории
+//   team-chat consent       согласие на отправку опыта агентов автору пакета
+//   team-chat status        что запущено
+//
+// Данные — в ~/.team-chat (или TEAM_CHAT_HOME): база, вложения, логи, конфиг раннера.
+
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import readline from 'node:readline/promises';
+import { detectRuntimes, registerCodexMcp, startRunner, writeRunnerConfig } from './lib/agents.js';
+import { exportDocs, findDocs } from './lib/docs.js';
+import { LocalApi } from './lib/local.js';
+import { defaultHome, legacyData, newSecret, startServer, VERSION } from './lib/server.js';
+import { alive, die, openBrowser, portFree, readJson, say, stop, waitHttp, warn, writeJson } from './lib/util.js';
+
+const HELP = `team-chat ${VERSION} — командный чат владельца и ИИ-агентов
+
+  team-chat start [--port 8600] [--no-open]
+      Поднять свой чат на localhost: сервер, раннер агентов (claude, codex — какие
+      найдутся), ссылку для входа. Работает, пока не нажмёшь Ctrl+C.
+
+  team-chat login [@ник]
+      Новая одноразовая ссылка для входа в браузер (живёт 15 минут).
+
+  team-chat connect <адрес чата> --token <токен раннера>
+      Подключить агентов этой машины к чужому чату. Токен машины выдаёт владелец того
+      чата: «Команда» → «+ машина».
+
+  team-chat participant [--list] | <ник> [--name …] [--role …] [--kind human|ai] [--reissue]
+      Участники: список, завести, перевыпустить токен (показывается один раз).
+
+  team-chat dump [--file chat-dump.json]
+  team-chat restore <файл> [--files <каталог вложений>] [--force]
+      Перенос чата: снимок в файл и восстановление из него (заменяет всё). Дамп PHP-версии
+      (php artisan chat:dump) тоже подходит.
+
+  team-chat docs export|import [--chat <slug>] [--root <каталог>] [--dry-run]
+      Подтверждённые документы и журнал решений — в репозитории; переписка из .md
+      репозиториев — в чат черновиками. Каталог по умолчанию — каталог проекта чата.
+
+  team-chat consent [on|off]
+      Согласие на отправку обезличенного опыта агентов автору пакета: без аргумента —
+      текст согласия и что сейчас; on — помогать, off — не отправлять.
+
+  team-chat status
+      Что запущено и где лежат данные.
+
+  Данные: ${defaultHome()} (переопределить — TEAM_CHAT_HOME).`;
+
+/** Флаги без значения; остальные --ключ берут значение (--port 8600 или --port=8600). */
+const SWITCHES = new Set(['no-open', 'reissue', 'list', 'force', 'dry-run']);
+
+function parseArgs(argv) {
+  const opts = { _: [] };
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (!a.startsWith('--')) opts._.push(a);
+    else {
+      const [k, v] = a.slice(2).split('=', 2);
+      opts[k] = SWITCHES.has(k) ? true : v ?? argv[++i];
+    }
+  }
+  return opts;
+}
+
+const home = defaultHome();
+const configFile = path.join(home, 'config.json');
+const lockFile = path.join(home, 'team-chat.pid');
+
+function loadConfig() {
+  return readJson(configFile, {});
+}
+
+function running() {
+  const pid = Number(fs.existsSync(lockFile) ? fs.readFileSync(lockFile, 'utf8') : 0);
+  return pid && alive(pid) ? pid : null;
+}
+
+/** Служебные пути своего запущенного сервера. */
+function local() {
+  const cfg = loadConfig();
+  if (!cfg.localSecret || !running()) die('чат не запущен на этой машине — сначала team-chat start');
+  return new LocalApi(cfg);
+}
+
+// ---------------------------------------------------------------- start
+
+async function cmdStart(opts) {
+  if (running()) die(`уже запущен (pid ${running()}). Ссылка для входа: team-chat login`);
+  fs.mkdirSync(home, { recursive: true, mode: 0o700 });
+  if (legacyData(home)) {
+    warn('в каталоге данных — база прежней, PHP-версии. Новый сервер её не читает: перенеси её');
+    warn(`  дампом — в ${path.join(home, 'app')}: php artisan chat:dump, затем team-chat restore <файл>.`);
+  }
+
+  const cfg = loadConfig();
+  cfg.port = Number(opts.port ?? cfg.port ?? 8600);
+  cfg.localSecret ??= newSecret();
+  // Порт занят — дальше нельзя: ответ чужого сервера сошёл бы за наш, и ссылка для
+  // входа вела бы в чужой чат.
+  if (!(await portFree(cfg.port))) {
+    die(`порт ${cfg.port} уже занят другой программой. Запусти на другом: team-chat start --port ${cfg.port + 100}`);
+  }
+  writeJson(configFile, cfg);
+  say(`team-chat ${VERSION}: данные — ${home}`);
+
+  fs.writeFileSync(lockFile, String(process.pid));
+  const server = startServer(home, cfg);
+  let runner = null;
+  let stopping = false;
+
+  const shutdown = code => {
+    if (stopping) return;
+    stopping = true;
+    say('\nостанавливаю…');
+    stop(runner);
+    stop(server);
+    fs.rmSync(lockFile, { force: true });
+    setTimeout(() => process.exit(code), 500);
+  };
+  process.on('SIGINT', () => shutdown(0));
+  process.on('SIGTERM', () => shutdown(0));
+  server.on('exit', code => {
+    if (!stopping) { warn(`сервер остановился (код ${code}) — см. ${path.join(home, 'logs', 'server.log')}`); shutdown(1); }
+  });
+
+  const url = `http://localhost:${cfg.port}`;
+  if (!(await waitHttp(`${url}/up`, 60000, server))) {
+    warn(`сервер не поднялся — см. ${path.join(home, 'logs', 'server.log')}`);
+    return shutdown(1);
+  }
+
+  // Владелец, раннер и агенты под найденные движки. Повторный запуск ничего не ломает.
+  const runtimes = detectRuntimes();
+  const api = new LocalApi(cfg);
+  const setup = await api.post('/setup', {
+    name: os.userInfo().username,
+    agents: Object.entries(runtimes).map(([name, r]) => `${name}:${name}:${r.role}`),
+    // Токена раннера у нас нет — нужен новый.
+    rotate_host: !cfg.hostToken,
+  });
+  if (setup.host_token) {
+    cfg.hostToken = setup.host_token;
+    writeJson(configFile, cfg);
+  }
+  if (setup.agents.length) say(`→ агенты: ${setup.agents.map(a => '@' + a).join(', ')}`);
+  if (!Object.keys(runtimes).length) warn('не нашёл ни claude, ни codex — чат работает, но отвечать в нём некому.');
+
+  writeRunnerConfig(home, runtimes);
+  registerCodexMcp(url);
+  await askConsentOnce(api);
+
+  // Раннер упал — поднимаем снова, но не чаще раза в 10 с.
+  const launchRunner = () => {
+    if (stopping) return;
+    runner = startRunner(home, { api: `http://127.0.0.1:${cfg.port}/api`, token: cfg.hostToken });
+    runner.on('exit', code => {
+      if (stopping) return;
+      warn(`раннер остановился (код ${code}) — перезапуск через 10 с, см. ${path.join(home, 'logs', 'runner.log')}`);
+      setTimeout(launchRunner, 10000);
+    });
+  };
+  launchRunner();
+
+  say(`\n✓ чат работает: ${url}`);
+  say(`  вход (одноразовая ссылка, 15 мин): ${setup.login_url}`);
+  say(`  логи: ${path.join(home, 'logs')}   остановить: Ctrl+C\n`);
+  if (!opts['no-open']) openBrowser(setup.login_url);
+
+  // Держим процесс: сервер и раннер — наши дети.
+  await new Promise(() => {});
+}
+
+// ---------------------------------------------------------------- login
+
+async function cmdLogin(opts) {
+  const { url } = await local().post('/login', { handle: opts._[1] ?? null });
+  say(url);
+  openBrowser(url);
+}
+
+// ---------------------------------------------------------------- connect
+
+async function cmdConnect(opts) {
+  const url = (opts._[1] || '').replace(/\/+$/, '');
+  if (!/^https?:\/\//.test(url) || !opts.token) die('нужно: team-chat connect <адрес чата> --token <токен раннера>');
+  if (running()) die('на этой машине уже запущен team-chat start — раннер у него свой.');
+  fs.mkdirSync(home, { recursive: true, mode: 0o700 });
+
+  const ok = await fetch(`${url}/api/runner/agents`, { headers: { Authorization: `Bearer ${opts.token}`, Accept: 'application/json' } })
+    .then(r => r.status).catch(() => 0);
+  if (ok === 401 || ok === 403) die('чат не принял токен: нужен токен машины (участник host) этого чата.');
+  if (ok !== 200) die(`чат по адресу ${url} не отвечает.`);
+
+  const cfg = loadConfig();
+  cfg.remote = { url, token: opts.token };
+  writeJson(configFile, cfg);
+
+  const runtimes = detectRuntimes();
+  if (!Object.keys(runtimes).length) die('на этой машине нет ни claude, ни codex — подключать некого.');
+  writeRunnerConfig(home, runtimes);
+  registerCodexMcp(url);
+
+  fs.writeFileSync(lockFile, String(process.pid));
+  let runner = null;
+  let stopping = false;
+  const shutdown = () => { stopping = true; stop(runner); fs.rmSync(lockFile, { force: true }); setTimeout(() => process.exit(0), 300); };
+  process.on('SIGINT', shutdown);
+  process.on('SIGTERM', shutdown);
+
+  const launch = () => {
+    if (stopping) return;
+    runner = startRunner(home, { api: `${url}/api`, token: opts.token });
+    runner.on('exit', code => { if (!stopping) { warn(`раннер остановился (код ${code}) — перезапуск через 10 с`); setTimeout(launch, 10000); } });
+  };
+  launch();
+
+  say(`✓ агенты этой машины (${Object.keys(runtimes).join(', ')}) подключены к ${url}`);
+  say('  каких агентов запускать, решает владелец того чата: движок агента должен быть здесь.');
+  say(`  логи: ${path.join(home, 'logs')}   остановить: Ctrl+C`);
+  await new Promise(() => {});
+}
+
+// ---------------------------------------------------------------- participant
+
+async function cmdParticipant(opts) {
+  const api = local();
+  const handle = opts._[1]?.replace(/^@/, '');
+  if (opts.list || !handle) {
+    for (const p of (await api.get('/participants')).participants) {
+      say(`${p.handle.padEnd(16)} ${p.name.padEnd(16)} ${p.role.padEnd(12)} ${p.kind.padEnd(6)} токен: ${p.token ? 'есть' : '—'}  был: ${p.last_seen_at ?? 'не заходил'}`);
+    }
+    return;
+  }
+  const r = await api.post('/participants', { handle, name: opts.name, role: opts.role, kind: opts.kind, accent: opts.accent, reissue: !!opts.reissue });
+  if (!r.token) return say(`@${r.handle} обновлён. Токен не тронут (нужен --reissue).`);
+  say(r.created ? `Участник @${r.handle} создан. Токен:` : `Токен перевыпущен для @${r.handle}:`);
+  say(`  ${r.token}`);
+  say('  Показывается один раз — у нас хранится только хеш.');
+}
+
+// ---------------------------------------------------------------- dump / restore
+
+async function cmdDump(opts) {
+  const file = path.resolve(opts.file ?? 'chat-dump.json');
+  const dump = await local().get('/dump');
+  fs.writeFileSync(file, JSON.stringify(dump, null, 2) + '\n', { mode: 0o600 });
+  for (const [table, rows] of Object.entries(dump.tables)) say(`  ${table.padEnd(18)} ${rows.length}`);
+  say(`Выгружено в ${file}. Вложения — файлы в ${path.join(home, 'files')}, переносятся отдельно.`);
+}
+
+async function cmdRestore(opts) {
+  const file = opts._[1];
+  if (!file || !fs.existsSync(file)) die('нужно: team-chat restore <файл дампа> [--files <каталог вложений>]');
+  const dump = JSON.parse(fs.readFileSync(file, 'utf8'));
+  if (!dump.tables) die('файл не похож на дамп чата.');
+
+  say(`Снимок от ${dump.exported_at ?? 'неизвестно'}:`);
+  for (const [table, rows] of Object.entries(dump.tables)) say(`  ${table.padEnd(18)} ${rows.length}`);
+  if (!opts.force) die('текущее содержимое чата будет заменено целиком. Если согласен — повтори с --force.');
+
+  const { restored } = await local().post('/restore', dump);
+  say(`✓ восстановлено: ${Object.values(restored).reduce((a, b) => a + b, 0)} строк`);
+  // Раннер этой машины пришёл из дампа со своим токеном — наш сохранённый больше не годится:
+  // следующий start выпустит новый.
+  const cfg = loadConfig();
+  delete cfg.hostToken;
+  writeJson(configFile, cfg);
+
+  // Файлы вложений: у PHP-версии — storage/app/private/attachments, здесь — files/attachments.
+  if (opts.files) {
+    const from = path.resolve(opts.files);
+    const to = path.join(home, 'files', 'attachments');
+    if (!fs.existsSync(from)) die(`каталога ${from} нет.`);
+    fs.mkdirSync(to, { recursive: true, mode: 0o700 });
+    fs.cpSync(from, to, { recursive: true });
+    say(`✓ вложения скопированы в ${to}`);
+  }
+  say('Токены раннеров и браузеров не переносятся: перезапусти team-chat start — раннер возьмёт новый токен;');
+  say('в браузер — войти заново (team-chat login).');
+}
+
+// ---------------------------------------------------------------- docs
+
+async function cmdDocs(opts) {
+  const action = opts._[1];
+  if (!['export', 'import'].includes(action)) die('нужно: team-chat docs export|import [--chat <slug>] [--root <каталог>] [--dry-run]');
+  const api = local();
+  const data = await api.get(`/export${opts.chat ? `?chat=${encodeURIComponent(opts.chat)}` : ''}`);
+  const root = path.resolve(opts.root ?? data.chat.workdir ?? die(`у чата «${data.chat.slug}» не задан каталог проекта — укажи --root.`));
+  const dryRun = Boolean(opts['dry-run']);
+
+  if (action === 'export') {
+    const written = exportDocs(data, root, dryRun);
+    return say(dryRun ? `${written} файл(ов) было бы записано (--dry-run).` : `${written} файл(ов) записано. Не забудь закоммитить в репозиториях.`);
+  }
+
+  const documents = findDocs(root);
+  for (const d of documents) say(`  ${d.origin.padEnd(50)} ${d.kind.padEnd(10)} ${d.slug}`);
+  if (documents.length === 0) return warn(`в ${root} не нашлось документов для переноса.`);
+  if (dryRun) return say(`${documents.length} документ(ов) — ничего не записано (--dry-run).`);
+  const { imported } = await api.post('/documents', { chat: data.chat.slug, documents });
+  say(`${imported} документ(ов) перенесено черновиками. Файлы в репозиториях НЕ удалены — удаляй сам, когда сверишь.`);
+}
+
+// ---------------------------------------------------------------- consent
+
+/**
+ * Спросить согласие, если его не давали (или текст с тех пор изменился). Без терминала
+ * спросить некого — не спрашиваем и ничего не отправляем.
+ */
+async function askConsentOnce(api) {
+  const status = await api.get('/consent');
+  if (status.answer !== null) return;
+  if (!process.stdin.isTTY) return say('опыт агентов автору пакета не отправляется — согласие: team-chat consent on');
+
+  say(`\n${status.text}\n`);
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  let answer = null;
+  while (answer === null) {
+    const reply = (await rl.question('Помогать? (да/нет) ')).trim().toLowerCase();
+    answer = ['да', 'д', 'yes', 'y'].includes(reply) ? true : ['нет', 'н', 'no', 'n'].includes(reply) ? false : null;
+  }
+  rl.close();
+  await api.post('/consent', { answer });
+  say(answer ? '✓ спасибо! Передумаешь — team-chat consent off\n' : '✓ ничего не отправляется. Передумаешь — team-chat consent on\n');
+}
+
+async function cmdConsent(opts) {
+  const api = local();
+  const action = opts._[1];
+  if (action && !['on', 'off'].includes(action)) die('нужно: team-chat consent [on|off]');
+
+  const status = action ? await api.post('/consent', { answer: action === 'on' }) : await api.get('/consent');
+  if (!action) say(`${status.text}\n`);
+  say(`согласие: ${status.answer === null ? 'не спрашивали' : status.answer ? `да (${status.answered_at})` : `нет (${status.answered_at})`}`);
+  say(`карточек опыта ждут отправки: ${status.pending}`);
+  if (!status.answer) return;
+  if (!status.collector) return say('сборщика у автора пакета пока нет — карточки уйдут, когда он появится.');
+  if (action !== 'on') return say('отправка — сама, раз в 5 минут.');
+  const { sent } = await api.post('/share');
+  say(`отправлено сейчас: ${sent}; дальше — само, раз в 5 минут.`);
+}
+
+// ---------------------------------------------------------------- status
+
+async function cmdStatus() {
+  const cfg = loadConfig();
+  const pid = running();
+  say(`данные: ${home}`);
+  if (!cfg.port && !cfg.remote) return say('ещё не запускался: team-chat start');
+  say(pid ? `запущен (pid ${pid})` : 'не запущен');
+  if (cfg.remote) say(`подключён к: ${cfg.remote.url}`);
+  if (cfg.port) {
+    const up = await waitHttp(`http://localhost:${cfg.port}/up`, 1500);
+    say(`свой чат: http://localhost:${cfg.port} — ${up ? 'отвечает' : 'не отвечает'}`);
+  }
+  const runtimes = Object.keys(readJson(path.join(home, 'runner.json'), { runtimes: {} }).runtimes);
+  say(`движки агентов: ${runtimes.join(', ') || 'нет'}  (${path.join(home, 'runner.json')})`);
+}
+
+// ----------------------------------------------------------------
+
+const opts = parseArgs(process.argv.slice(2));
+const commands = {
+  start: cmdStart, login: cmdLogin, connect: cmdConnect, participant: cmdParticipant,
+  dump: cmdDump, restore: cmdRestore, docs: cmdDocs, consent: cmdConsent, status: cmdStatus,
+};
+const command = commands[opts._[0]];
+if (!command) {
+  say(HELP);
+  process.exit(opts._[0] && !['help', '--help', '-h'].includes(opts._[0]) ? 1 : 0);
+}
+await command(opts);

package/host/bridge/attempts.js

@@ -0,0 +1,43 @@
+// Счётчики неудачных попыток по обращениям — файл .bridge-state-<handle>.json.
+//
+// Без них дежурный цикл перезапускал бы агента на стабильно падающем обращении каждые
+// десять секунд и молча жёг лимиты. Файл читается заново на каждом проходе: снять
+// отложенное обращение можно, удалив его ключ руками.
+
+import fs from 'node:fs';
+
+export class AttemptStore {
+  #file;
+  #counts;
+
+  constructor(file, counts = {}) {
+    this.#file = file;
+    this.#counts = counts;
+  }
+
+  static load(file) {
+    try {
+      return new AttemptStore(file, JSON.parse(fs.readFileSync(file, 'utf8')));
+    } catch {
+      return new AttemptStore(file);
+    }
+  }
+
+  count(mentionId) {
+    return this.#counts[mentionId] ?? 0;
+  }
+
+  /** Ещё одна неудача. → сколько их теперь. */
+  fail(mentionId) {
+    this.#counts[mentionId] = this.count(mentionId) + 1;
+    return this.#counts[mentionId];
+  }
+
+  forget(mentionId) {
+    delete this.#counts[mentionId];
+  }
+
+  save() {
+    fs.writeFileSync(this.#file, JSON.stringify(this.#counts, null, 1));
+  }
+}