chatflux-gestao-agente 0.2.3 → 0.2.4

package/README.md

@@ -8,6 +8,19 @@ faz na tela, e tudo no histórico com o seu nome.
 > nova, o que exige (e o que não exige) republicar, como testar sem browser, e as
 > armadilhas que já custaram tempo. Ele fica só no repo — não vai no npm.
 
+## Atualizar pelo portal
+
+No aviso “Atualize o ChatFlux neste computador”, clique **Atualizar**. Com o
+computador conectado e o programa 0.2.4 ou mais recente, o portal acompanha a
+configuração completa, sem terminal. Se precisar renovar o login, o navegador
+abre. Ao aparecer **Pronto ✓**, reinicie o VS Code; o aviso some sozinho.
+
+Sem conexão, o botão mostra um pedido para copiar no Claude Code ou no Codex.
+Cole, aprove quando a IA pedir e acompanhe: ela executa o comando abaixo. Em
+programas antigos, o botão atualiza os plugins e mostra esse mesmo painel para
+completar a preparação. “Ver detalhes” explica o motivo do aviso e “Agora não”
+o dispensa nesta sessão.
+
 ## Instalar (equipe — um comando, sem clonar nada)
 
 ```sh

package/lib/computador-estado.mjs

@@ -49,6 +49,7 @@ const privateResult = x => ({
   baixar_abrir: shape({ kind: oneOf('baixar_abrir'), canonicalPath: text, ...opening }),
   escolher_pasta_projeto: shape({ kind: oneOf('escolher_pasta_projeto'), canonicalPath: text, ...opening }),
   escolher_pasta_padrao: shape({ kind: oneOf('escolher_pasta_padrao'), canonicalPath: text }),
+  configurar: shape({ kind: oneOf('configurar'), items: x => Array.isArray(x) && x.length > 0 && x.length <= 20 && x.every(shape({ status: oneOf('ok', 'erro', 'aviso'), item: x => text(x) && x.length <= 100, text: x => text(x) && x.length <= 600 })), restartRequired: bool }),
   atualizar_plugin: shape({ kind: oneOf('atualizar_plugin'), claude: plugin, codex: plugin, restartRequired: bool }),
   responder_sessao: shape({ kind: oneOf('responder_sessao'), turnStatus: oneOf('encerrado', 'cancelado', 'timeout', 'incerto'), resposta: optional(x => typeof x === 'string' && x.length <= 4000), motivo: optional(oneOf('conversa_em_uso', 'editor_aberto', 'pasta_invalida', 'outro')) }),
   ler_historico: shape({ kind: oneOf('ler_historico'), count: x => uint(x) && x <= 30, partial: bool, digest }),

package/lib/computador-executor.mjs

@@ -6,13 +6,14 @@
  * F02/Windows/Codex continuam atrás de capabilities e das receitas injetadas A4.
  */
 import path from 'node:path';
+import { configurar } from './configurar.mjs';
 import { readFileSync } from 'node:fs';
 import { acquireInstanceLock } from './computador-estado.mjs';
 import { readUserJson } from './computador-identidade.mjs';
 import { createReplyAdapter } from './computador-resposta.mjs';
 
 const VERSION = JSON.parse(readFileSync(new URL('../package.json', import.meta.url))).version;
-const ACTIONS = ['abrir_pasta', 'abrir_sessao', 'baixar_abrir', 'escolher_pasta_projeto', 'escolher_pasta_padrao', 'atualizar_plugin', 'responder_sessao', 'ler_historico'];
+const ACTIONS = ['abrir_pasta', 'abrir_sessao', 'baixar_abrir', 'escolher_pasta_projeto', 'escolher_pasta_padrao', 'atualizar_plugin', 'configurar', 'responder_sessao', 'ler_historico'];
 const OPENING = ['abrindo_pasta', 'aguardando_editor', 'abrindo_conversa'];
 const RETRIES = [2000, 5000, 15000, 30000, 60000, 120000];
 const CLAIM = 'ops.computerRequestActions.claim', REPORT = 'ops.computerRequestActions.report';
@@ -48,7 +49,7 @@ function errorType(e) {
   return 'outro';
 }
 
-export async function runComputer({ identity, portal, journal, paths, folders, editor, git, plugins, diagnostics, history, reply = createReplyAdapter(), clock = {}, signal }) {
+export async function runComputer({ identity, portal, journal, paths, folders, editor, git, plugins, diagnostics, history, configure = configurar, reply = createReplyAdapter(), clock = {}, signal }) {
   const now = clock.now?.bind(clock) ?? Date.now;
   const later = clock.setTimeout?.bind(clock) ?? setTimeout, cancel = clock.clearTimeout?.bind(clock) ?? clearTimeout;
   const random = clock.random?.bind(clock) ?? Math.random;
@@ -520,6 +521,21 @@ export async function runComputer({ identity, portal, journal, paths, folders, e
         }, () => ({ kind: 'concluir', privateResult: { kind: 'abrir_pasta' } }));
         return r;
       }
+      if (r.action === 'configurar') {
+        await phase('atualizando_plugin');
+        await effect('atualizando_plugin', () => configure(['--sim'], {
+          nonInteractive: true, signal: operationSignal, announce: () => {},
+        }), result => {
+          const short = (value, limit) => String(value ?? '').replace(/[\x00-\x1f\x7f]/g, ' ').trim().slice(0, limit);
+          const items = result.results.map(row => ({ status: row.ok === true ? 'ok' : row.ok === 'warn' ? 'aviso' : 'erro',
+            item: short(row.item, 100), text: short(row.message, 600) }));
+          const privateResult = { kind: 'configurar', items, restartRequired: result.restartRequired === true };
+          return items.some(row => row.status !== 'ok')
+            ? { kind: 'aguardar', choices: ['tentar_novamente', 'cancelar'], privateResult }
+            : { kind: 'concluir', privateResult };
+        });
+        return r;
+      }
       if (r.action === 'atualizar_plugin') {
         if (!capabilities.atualizarPlugin) throw fail('EDITOR_RECIPE_UNVERIFIED');
         await phase('atualizando_plugin');

package/lib/configurar.mjs

@@ -1,4 +1,4 @@
-/** Preparação pessoal, sem comandos recebidos do portal. Efeitos só fora de --verificar. */
+/** Preparação pessoal com receita fixa, também usada pelo botão do portal. Efeitos só fora de --verificar. */
 import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
@@ -29,6 +29,8 @@ async function ask(question) {
 export async function configurar(flags = [], options = {}) {
   if (flags.some(flag => !['--sim', '--verificar'].includes(flag))) throw new Error('Use gestao configurar [--sim] [--verificar].');
   const verify = flags.includes('--verificar'), yes = flags.includes('--sim');
+  const signal = options.signal;
+  signal?.throwIfAborted();
   const platform = options.platform ?? process.platform;
   if (!['darwin', 'win32'].includes(platform)) throw new Error('Configurar está disponível para Mac e Windows.');
   const p = platform === 'win32' ? path.win32 : path.posix;
@@ -43,6 +45,7 @@ export async function configurar(flags = [], options = {}) {
   const results = [];
   let restart = false;
   function result(item, ok, message) {
+    signal?.throwIfAborted();
     const line = `${item}: ${message} ${ok === 'warn' ? '⚠' : ok ? '✓' : '✗'}`;
     results.push({ item, ok, message }); announce(line);
   }
@@ -72,16 +75,20 @@ export async function configurar(flags = [], options = {}) {
   }
   const commands = {};
   function start(command, argv, spawnOptions = {}) {
+    signal?.throwIfAborted();
     if (!command) throw new Error('Programa não encontrado.');
     return spawnImpl(command.binary, [...command.prefix, ...argv], { ...spawnOptions, ...(command.cwd ? { cwd: command.cwd } : {}), env: commandEnv, shell: false, windowsHide: true });
   }
   async function run(command, argv, interactive = false) {
     return new Promise((resolve, reject) => {
       let child, timer, bytes = 0, stdout = '', stderr = '', done = false;
-      const finish = (error, value) => { if (done) return; done = true; clearTimeout(timer); error ? reject(error) : resolve(value); };
+      const finish = (error, value) => { if (done) return; done = true; clearTimeout(timer); signal?.removeEventListener('abort', abort); error ? reject(error) : resolve(value); };
+      const abort = () => { try { child?.kill('SIGKILL'); } catch { /* somente filho próprio */ } finish(signal.reason ?? new Error('Cancelado.')); };
       const stop = () => { try { child?.kill('SIGKILL'); } catch { /* somente filho próprio */ } finish(new Error('O comando demorou demais; tente novamente.')); };
       try {
-        child = start(command, argv, { stdio: interactive ? 'inherit' : ['ignore', 'pipe', 'pipe'] });
+        child = start(command, argv, { stdio: interactive && !options.nonInteractive ? 'inherit' : ['ignore', 'pipe', 'pipe'] });
+        signal?.addEventListener('abort', abort, { once: true });
+        if (signal?.aborted) { abort(); return; }
         for (const stream of ['stdout', 'stderr']) child[stream]?.on('data', chunk => {
           bytes += Buffer.byteLength(chunk); if (bytes > 1024 * 1024) return stop();
           if (stream === 'stdout') stdout += chunk; else stderr += chunk;
@@ -225,7 +232,7 @@ export async function configurar(flags = [], options = {}) {
     }
   } else {
     const bridge = (tool, argv, spawnOptions) => start(commands[tool], argv, spawnOptions);
-    const updated = await updatePlugins({ platform, tools: ready, marketplaceUpdated: ready,
+    const updated = await updatePlugins({ platform, signal, tools: ready, marketplaceUpdated: ready,
       ...(platform === 'win32' ? { windowsAdapter: bridge } : { spawnImpl: (binary, argv, spawnOptions) => bridge(binary.endsWith('/claude') ? 'claude' : 'codex', argv, spawnOptions) }) });
     restart ||= updated.restartRequired;
     for (const tool of ['claude', 'codex']) if (commands[tool]) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chatflux-gestao-agente",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "type": "module",
   "description": "Opere o portal Gestão da ChatFlux pelo Claude Code, Claude Desktop ou qualquer harness MCP — com a sua identidade e o seu papel.",
   "keywords": [