chatflux-gestao-agente 0.2.0 → 0.2.2

package/README.md

@@ -50,7 +50,7 @@ gestao login
   └─ guarda no Keychain (macOS) ou em ~/.config/gestao/token.json (0600)
 ```
 
-Vale **até 6 horas** (a validade real aparece no login e no `gestao status`). E na prática você não faz nada disso à mão: o próprio agente
+Vale **1 ano** (decisão de 10/11; a validade real aparece no login e no `gestao status`). E na prática você não faz nada disso à mão: o próprio agente
 chama a tool `gestao_conectar` quando precisa, o navegador abre, você clica em
 **Autorizar** e ele refaz a ação. O `gestao login` no terminal existe como
 alternativa, não como o caminho normal.
@@ -143,7 +143,7 @@ continuam disponíveis; não contam como prova da abertura assistida.
 
 ### Reconectar, trocar ambiente ou conta
 
-O login vence (normalmente até 6 h). O residente pausa os pedidos e orienta
+O login vence (1 ano desde o último `gestao login`). O residente pausa os pedidos e orienta
 `gestao login` ou `gestao_conectar`; ele não renova o token silenciosamente.
 `gestao status` mostra ambiente, startup, computador e a causa local mesmo sem
 rede/login. O indicador do portal pode levar até 180 s para perder a conexão.

package/lib/computador-adaptadores.mjs

@@ -31,7 +31,7 @@ export async function createComputerAdapters(deps = {}) {
     const unavailable = async () => { throw new Error('Receita Windows sem ensaio de campo.'); };
     return { editor: createEditorAdapter({ platform, spawnImpl }), reply: createReplyAdapter({ platform }),
       history: { capabilities: { lerHistoricoClaude: false, lerHistoricoCodex: false }, read: unavailable },
-      folders: { ...folders, capabilities: { seletorPasta: false }, chooseFolder: unavailable },
+      folders: { ...folders, openLinkedFolder: options => folders.openLinkedFolder({ ...options, platform, fsImpl, execFileImpl }), capabilities: { seletorPasta: false }, chooseFolder: unavailable },
       git: {}, plugins: {}, capabilityDetails };
   }
   // launchd does not inherit the login-shell PATH. Keep personal credentials,
@@ -245,7 +245,8 @@ export async function createComputerAdapters(deps = {}) {
     if (!executable) throw Object.assign(new Error('CLI local ausente.'), { code: 'ENOENT' });
     return spawnImpl(executable, argv, { ...options, env: commandEnv });
   };
-  return { editor, reply, history, folders: { ...folders, capabilities: { seletorPasta: true },
+  return { editor, reply, history, folders: { ...folders,
+    openLinkedFolder: options => folders.openLinkedFolder({ ...options, platform, fsImpl, execFileImpl }), capabilities: { seletorPasta: true },
     chooseFolder: options => folders.chooseFolder({ ...options, platform, fsImpl, spawnImpl }),
     adoptKnownFolder: options => folders.adoptKnownFolder({ ...options, platform, fsImpl, home, execFileImpl }) },
     git: { ...createGitAdapter({ platform, fsImpl, spawnImpl: (binary, argv, options) =>

package/lib/computador-cli.mjs

@@ -257,6 +257,7 @@ export function createComputerCli(options = {}) {
         const state = await startup.installStartup(startupOptions);
         if (!state.installed || !state.healthy) throw fail('Startup não confirmado.');
         await startResident(identity);
+        if (state.correctedEntryPath) announce('Caminho do início automático corrigido.');
       } catch {
         journal.transition({ kind: 'stop', computerId: identity.computerId, generation: registration.generation });
         let rollbackFailed = false;

package/lib/computador-estado.mjs

@@ -44,6 +44,7 @@ const plugin = x => ({
 const opening = { git: optional(git), openingSent: optional(bool),
   sessaoNaPasta: optional(bool), atualizarPelaIaIndisponivel: optional(bool) };
 const privateResult = x => ({
+  abrir_pasta: shape({ kind: oneOf('abrir_pasta') }),
   abrir_sessao: shape({ kind: oneOf('abrir_sessao'), canonicalPath: optional(text), ...opening }),
   baixar_abrir: shape({ kind: oneOf('baixar_abrir'), canonicalPath: text, ...opening }),
   escolher_pasta_projeto: shape({ kind: oneOf('escolher_pasta_projeto'), canonicalPath: text, ...opening }),

package/lib/computador-executor.mjs

@@ -12,7 +12,7 @@ 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_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', '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';
@@ -508,6 +508,18 @@ export async function runComputer({ identity, portal, journal, paths, folders, e
       check(r);
       deadlineTimer = later(() => controller.abort(), Math.max(0, r.expiresAt - now()));
       renew();
+      if (r.action === 'abrir_pasta') {
+        await phase('conferindo_pasta');
+        const link = await portal.call('ops.computers.projectPath', { projectId: r.projectId }, { deadlineAt: budget() }); check(r);
+        if (!link) throw fail('FOLDER_REQUIRED');
+        if (link.computerId !== identity.computerId || link.projectId !== r.projectId || link.repoFullName !== r.repoFullName) throw fail('PATH_NOT_AUTHORIZED');
+        await phase('abrindo_pasta');
+        await effect('abrindo_pasta', () => {
+          const local = authorized(link.canonicalPath);
+          return folders.openLinkedFolder({ path: local.path, registeredPath: link.canonicalPath, signal: operationSignal });
+        }, () => ({ kind: 'concluir', privateResult: { kind: 'abrir_pasta' } }));
+        return r;
+      }
       if (r.action === 'atualizar_plugin') {
         if (!capabilities.atualizarPlugin) throw fail('EDITOR_RECIPE_UNVERIFIED');
         await phase('atualizando_plugin');

package/lib/computador-pastas.mjs

@@ -155,3 +155,14 @@ export async function adoptKnownFolder(options) {
   }
   return null;
 }
+
+/** Only the resident supplies this path after resolving the project binding. */
+export async function openLinkedFolder({ path: candidate, registeredPath, platform = process.platform, fsImpl = fs, execFileImpl = execFile, signal }) {
+  const canonicalPath = validatePath({ candidate, registeredPath, platform, fsImpl });
+  if (canonicalPath !== registeredPath || !fsImpl.statSync(canonicalPath).isDirectory()) throw pathError();
+  const binary = platform === 'darwin' ? '/usr/bin/open' : platform === 'win32' ? 'explorer.exe' : null;
+  if (!binary) throw fail('FOLDER_PLATFORM_UNSUPPORTED');
+  await new Promise((resolve, reject) => execFileImpl(binary, [canonicalPath], {
+    shell: false, windowsHide: true, timeout: 10000, ...(signal ? { signal } : {}),
+  }, error => error ? reject(error) : resolve()));
+}

package/lib/computador-startup.mjs

@@ -116,7 +116,16 @@ export function createStartupManager({
     const content = read(l.path);
     const entry = l.platform === 'darwin' ? content !== null : win().get(l.name) !== null;
     if (entry && !c) throw conflict();
-    if (c && l.platform === 'darwin' && content && content.toString() !== plist(l, c)) throw conflict();
+    if (c && l.platform === 'darwin' && content && content.toString() !== plist(l, c)) {
+      try {
+        const parsed = JSON.parse(command('/usr/bin/plutil', ['-convert', 'json', '-o', '-', l.path]));
+        const args = parsed.ProgramArguments;
+        if (parsed.Label !== l.label || !Array.isArray(args) || args.length !== 4 ||
+          typeof args[1] !== 'string' || !args[1].endsWith('/bin/gestao.mjs') ||
+          args[2] !== 'computador' || args[3] !== 'executar' || parsed.EnvironmentVariables?.GESTAO_ENV !== l.env) throw conflict();
+        return true;
+      } catch { throw conflict(); }
+    }
     if (c && l.platform === 'win32') {
       const value = win().get(l.name);
       if (value !== null && value !== c.command) throw conflict();
@@ -155,7 +164,7 @@ export function createStartupManager({
     const c = { version: 1, env: l.env, platform: l.platform, nodePath: validateFile(options.nodePath, l.platform), entryPath: validateFile(options.entryPath, l.platform), identityPath: validateFile(options.identityPath, l.platform), command: null };
     ensureUserDirectory(l.root, protect); ensureUserDirectory(l.directory, protect);
     return withFileGate(l.directory, () => {
-      const previous = metadata(l); owned(l, previous);
+      const previous = metadata(l), changedPlist = owned(l, previous);
       const files = [l.path, l.configPath, ...(l.platform === 'win32' ? [l.launchConfig] : [])];
       const backup = files.map(file => [file, read(file)]);
       const oldService = l.platform === 'darwin' ? serviceState(l) : null;
@@ -172,7 +181,7 @@ export function createStartupManager({
           c.command = `${quoteWindows(path.win32.join(windowsDirectory || 'C:\\Windows', 'System32/wscript.exe'))} //B //Nologo ${quoteWindows(launcher)}`;
           if (c.command.length > 260) throw failure();
         }
-        if (JSON.stringify(previous) === JSON.stringify(c) && startupStatus(options).healthy && (l.platform === 'win32' || wasRunning)) return startupStatus(options);
+        if (!changedPlist && JSON.stringify(previous) === JSON.stringify(c) && startupStatus(options).healthy && (l.platform === 'win32' || wasRunning)) return startupStatus(options);
         touched = true;
         if (l.platform === 'darwin') {
           fs.mkdirSync(path.dirname(l.path), { recursive: true });
@@ -187,7 +196,7 @@ export function createStartupManager({
           if (win().get(l.name) !== c.command) throw failure();
         }
         write(l.configPath, JSON.stringify(c));
-        return startupStatus(options);
+        return { ...startupStatus(options), correctedEntryPath: l.platform === 'darwin' && !!previous && (changedPlist || previous.entryPath !== c.entryPath || previous.nodePath !== c.nodePath) };
       } catch {
         if (touched) {
           try {

package/lib/config.mjs

@@ -39,7 +39,7 @@ export function ambiente() {
 //
 // Keychain do macOS quando houver (é onde o SO já guarda segredo e o usuário
 // controla o acesso); arquivo 0600 como fallback nos outros sistemas. O token
-// vale até 6h (template `convex-agente`) — por isso não fica em texto puro no
+// vale 1 ano (template `convex-agente`) — por isso não fica em texto puro no
 // macOS, que é a máquina real da equipe. Revogação antes do `exp`: arquivar a
 // conta (`active:false`); `gestao logout` só apaga a cópia local.
 
@@ -113,6 +113,12 @@ export function descreverValidade(jwt, agora = Date.now()) {
   const exp = expiraEm(jwt);
   const restaMin = Math.max(0, Math.round((exp - agora) / 60000));
   if (!exp || restaMin === 0) return "validade desconhecida";
+  // Acima de um dia, hora sem data engana ("87599h59 (até 18:40)"): mostra dias e data.
+  if (restaMin > 24 * 60) {
+    const dias = Math.floor(restaMin / (24 * 60));
+    const data = new Date(exp).toLocaleDateString("pt-BR", { day: "2-digit", month: "2-digit", year: "numeric" });
+    return `${dias} dia${dias === 1 ? "" : "s"} (até ${data})`;
+  }
   const h = Math.floor(restaMin / 60);
   const m = restaMin % 60;
   const dur = h === 0 ? `${m} min` : m === 0 ? `${h}h` : `${h}h${String(m).padStart(2, "0")}`;
@@ -120,6 +126,20 @@ export function descreverValidade(jwt, agora = Date.now()) {
   return `${dur} (até ${hora})`;
 }
 
+/** Aviso para o modelo repassar à pessoa quando faltam 15 dias ou menos para o
+ *  login vencer. Com validade de 1 ano, sem isso o vencimento pega de surpresa.
+ *  "" fora da janela, com token inválido ou já vencido (aí a chamada falha e o
+ *  modelo chama `gestao_conectar` por conta própria). */
+export function avisoVencimento(jwt, agora = Date.now()) {
+  const exp = expiraEm(jwt);
+  if (!exp || exp <= agora || exp - agora > 15 * 86_400_000) return "";
+  return (
+    `AVISO: o login do Gestão desta máquina vence em ${descreverValidade(jwt, agora)}. ` +
+    "Diga isso à pessoa em uma frase e ofereça renovar agora com a tool `gestao_conectar` " +
+    "(abre o navegador; vale mais 1 ano)."
+  );
+}
+
 export function tokenValido(dados, margemMs = 60_000) {
   return Boolean(dados?.token) && expiraEm(dados.token) - margemMs > Date.now();
 }

package/lib/gestao.mjs

@@ -73,7 +73,7 @@ let cache = null;
  * disco — é cache, não fonte: só serve pra listar tools quando a credencial
  * expirou, e qualquer chamada de verdade continua exigindo login.
  *
- * Isso existe porque o token vence (6h): sem o cache, a pessoa veria o servidor
+ * Isso existe porque o token vence (1 ano): sem o cache, a pessoa veria o servidor
  * MCP "falhar ao conectar" a cada expiração, sem pista do motivo.
  */
 export async function contrato({ permitirCache = false } = {}) {

package/lib/login.mjs

@@ -1,7 +1,7 @@
 // `gestao login` — o handshake de identidade.
 //
 // Sobe um listener em 127.0.0.1 numa porta efêmera, abre o portal com `port` e
-// `state`, e espera a página devolver o JWT do template `convex-agente` (6h). O browser já
+// `state`, e espera a página devolver o JWT do template `convex-agente` (1 ano). O browser já
 // tem a sessão do Clerk; nós nunca vemos senha, e o backend não ganha rota nova.
 //
 // Por que NÃO OAuth: o Clerk não documenta caminho de credencial OAuth → JWT com

package/lib/mcp.mjs

@@ -13,7 +13,7 @@ import path from "node:path";
 import { contrato, chamar, euSou } from "./gestao.mjs";
 import { loginVerificado } from "./login.mjs";
 import { nomeServico } from "./servico.mjs";
-import { ambiente, descreverValidade } from "./config.mjs";
+import { ambiente, avisoVencimento, descreverValidade, lerToken } from "./config.mjs";
 import { montarTools } from "./tools.mjs";
 
 const PROTOCOLO = "2024-11-05";
@@ -41,7 +41,7 @@ let tools = null;
 /**
  * A tool que CONECTA — não a que pede pra pessoa digitar comando.
  *
- * Fica SEMPRE na lista, autenticado ou não, porque a sessão vence (6h no
+ * Fica SEMPRE na lista, autenticado ou não, porque a sessão vence (1 ano no
  * template `convex-agente`): quando qualquer ação falhar por sessão, o modelo chama esta e a pessoa
  * só clica no navegador. Ela nunca precisa saber que existe uma CLI.
  */
@@ -49,7 +49,7 @@ const TOOL_CONECTAR = {
   name: "gestao_conectar",
   description:
     "Conecta esta máquina ao Gestão. ABRE O NAVEGADOR para a pessoa autorizar com " +
-    "o login dela (leva segundos) e vale algumas horas (6h no padrão).\n\n" +
+    "o login dela (leva segundos) e vale 1 ano.\n\n" +
     "CHAME ISTO SEM PEDIR PERMISSÃO sempre que uma ação do Gestão falhar por " +
     "sessão expirada ou ausente, ou quando não houver nenhuma outra tool do Gestão " +
     "disponível. Depois de conectar, refaça a ação que falhou.\n\n" +
@@ -60,6 +60,20 @@ const TOOL_CONECTAR = {
   _endpoint: null,
 };
 
+/** Uma vez por processo (= por sessão do harness), na primeira chamada que deu
+ *  certo: se o login vence em até 15 dias, devolve o aviso para ir junto da
+ *  resposta. Modo serviço não tem login de pessoa. */
+let vencimentoConferido = false;
+function conferirVencimento() {
+  if (vencimentoConferido || nomeServico()) return "";
+  vencimentoConferido = true;
+  try {
+    return avisoVencimento(lerToken()?.token);
+  } catch {
+    return "";
+  }
+}
+
 /** Estamos no estado degradado (só a tool de conectar)? */
 const soConectar = (t) => t?.length === 1 && t[0]._endpoint === null;
 
@@ -167,7 +181,10 @@ async function tratar(msg) {
     }
     try {
       const valor = await chamar(tool._endpoint, params.arguments ?? {}, tool._kind);
-      return ok(id, texto(valor ?? { ok: true }));
+      const resultado = texto(valor ?? { ok: true });
+      const aviso = conferirVencimento();
+      if (aviso) resultado.content.push({ type: "text", text: aviso });
+      return ok(id, resultado);
     } catch (e) {
       // Erro de REGRA (ex.: "Empresa arquivada…") volta como conteúdo, não como
       // erro de protocolo: é informação que o modelo deve ler e agir em cima.
@@ -179,7 +196,7 @@ async function tratar(msg) {
 }
 
 export async function servir() {
-  // NUNCA sai por falta de credencial. O token vence (6h); se o servidor morresse
+  // NUNCA sai por falta de credencial. O token vence (1 ano); se o servidor morresse
   // ao expirar, a pessoa veria "Failed to connect — Connection closed" a cada
   // expiração, sem pista do motivo. Aqui ele sobe sempre, e a falta de sessão
   // aparece como uma tool que EXPLICA o que fazer.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chatflux-gestao-agente",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "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": [