Skip to content

HANDOFF-operacao-visivel.md

Latest commit

 

History

History
49 lines (37 loc) · 5.48 KB

HANDOFF-operacao-visivel.md

File metadata and controls

49 lines (37 loc) · 5.48 KB
Raw

HANDOFF — Épico "Operação Visível" (telas de transparência do agente)

⚠️ INSTRUÇÃO PERMANENTE (não remover): ler no INÍCIO de toda sessão que trabalhe neste épico; ATUALIZAR + COMMITAR ao final de CADA avanço. Regra do Rafael: progresso só conta com PROVA VISÍVEL (screenshot Playwright, output de teste). Cada feature provada DUAS vezes: localhost (dev) E VPS após publicar. Maker≠checker: cada feature reportada ao Maestro com evidência.

Contexto fixo

  • Épico: Operação Visível — dar tela ao que o motor do agente já faz no escuro. Ordem: F2(i) transparência anti-ban → F2(ii) knobs → F1 central de avisos → F3 propostas flywheel.
  • Dono das telas: Terminal C (FRONTEND). Backend: Terminal B (knobs read/write, apply-proposal).
  • Onde: branch feat/operacao-visivel (base main pós-fusão b1003cf).
  • VPS de prova: http://129.121.45.100:18080 (compose deskcomm-fusion, deploy por git bundle — ver docs/vendaval-vps-deploy-comandos.md).
  • Dados do motor: before_send_traces (vetos por tentativa), channel_knobs (+ channel_sessions.daily_message_limit), agent_inbox_items, flywheel_distiller_proposals.

Estado atual

Feature Status Prova
F2(i) motivo da retenção na conversa ✅ local endpoint GET /api/v1/conversations/[id]/retention + lib/inbox/retention-copy.ts (código→pt-br leigo) + RetentionNotice acima do composer. Typecheck+lint zero no diff. Playwright localhost: .superpowers/evidence/operacao-visivel-f2i-localhost.png (veto outside_window seedado → "Fora da janela de envio (7h–22h, sem domingo)…"). Falta: prova VPS.
F2(ii) knobs ✅ local backend do Terminal B (GET/PUT /api/v1/ai/pacing, branch epic/op-visivel-backend mergeada); UI = botão "Proteção de envio" no card de Conexões → AntiBanSheet (janela, domingo, ritmo+jitter em segundos, teto diário, fuso, escada de warm-up explicada; campo vazio = default do engine). Playwright localhost: salvou janela 8–21 → SQL channel_knobs = `8
F1 central de avisos ✅ local GET /api/v1/ai/inbox (+open_count) e PATCH /api/v1/ai/inbox/[id] (agent+, audit ai.inbox_item_updated); página /app/ai/inbox (abas Abertos/Resolvidos, badge severidade, marcar resolvido/reabrir); sino AlertsBell no TopBar com contador. Playwright localhost: .superpowers/evidence/operacao-visivel-f1-localhost.png (3 avisos seedados → resolve 1 → sino 3→2 ao vivo). Falta: prova VPS.
F3 propostas flywheel ✅ local backend do B (GET /api/v1/ai/agents/[id]/proposals + POST apply, migration 0053 aplicada no remoto via Management API); UI = aba "Propostas" no AgentTabs (ProposalsPanel: badge pendente/aplicada, botão admin "Aplicar como versão nova"). Playwright localhost: apply → versão 4 published, ponteiro movido, proposta com applied_version_id (SQL provado). Caminho de veto TESTADO: sessão offline → 422 channel_session_offline, proposta segue pendente. Evidência operacao-visivel-f3-localhost.png. Falta: prova VPS.

STATUS: 4/4 FEATURES PROVADAS EM PARIDADE LOCAL↔VPS ✅

Todas com screenshot Playwright local E na VPS (http://129.121.45.100:18080), + prova SQL onde há mutação:

  • F2(i) aviso do veto na conversa: local + VPS (conversa REAL do agente SDR "Gabriel", veto outside_window → "Fora da janela de envio (7h–22h)…").
  • F1 central de avisos + sino: local (6→2 resolvendo) + VPS (6 avisos reais, incl. handoff genuíno do agente; resolver 6→5, sino atualizado).
  • F2(ii) proteção anti-ban: local (SQL 8|21) + VPS (SQL 9|20).
  • F3 propostas do flywheel: local (v4 published) + VPS (12 propostas REAIS do distiller; apply → v3 published, ponteiro movido; SQL provado). Migration 0053 aplicada na VPS pelo Terminal B.

Evidências: .superpowers/evidence/operacao-visivel-{f1,f2i,f2ii,f3}-{localhost,vps}.png (8 arquivos, gitignored — local).

Paridade VPS (2ª prova — CONCLUÍDA)

  • VPS = http://129.121.45.100:18080, compose deskcomm-fusion, banco Supabase cloud cnbzyadxiwrfrylywejj (role agent_worker no .env).
  • Branch feat/operacao-visivel (commit 551ca1f) publicada por git bundle + git reset --hard; rebuild da imagem app em curso (VPS tinha 7.6G RAM sem swap → o tsc do build estourava e derrubava a conexão; criei swapfile 4G, build voltou a passar do tsc).
  • Bloqueio F3 na VPS: migration 0053 (colunas applied_* em flywheel_distiller_proposals) não está no banco da VPS (applied_cols=0) e o agent_worker não é dono da tabela; projeto está fora do meu token de Management API. Delegado ao Terminal B (dono das credenciais do deploy) aplicar o ALTER idempotente. F1/F2i/F2ii não dependem da 0053.

Decisões e problemas

  • Tradução dos vetos é módulo puro (lib/inbox/retention-copy.ts): 3 famílias — proteção (pacing/spinning, tom âmbar), conformidade (stop/LGPD, tom destructive), qualidade (promise/disclosure, tom neutro; o assistente corrige sozinho).
  • Endpoint de retenção é read-only via client de sessão (RLS cobre before_send_traces); knobs NULL resolvidos com PACING_DEFAULTS (import sancionado — doutrina lint-pacing).
  • Polling 30s no hook (veto nasce no worker, fora do realtime de mensagens).
  • Seed de prova local: linha before_send_traces com payload.seed='operacao-visivel-f2i' no job — limpar após o épico.
  • 401 de crm_leads no console do inbox é pré-existente (CRMSidePanel), não deste épico.