@danhachuel/leadmaster 0.1.14 → 0.1.16

package/CHANGELOG.md

@@ -37,6 +37,74 @@ normaliza para a forma canônica (ex.: `0.1.0`).
    falha se `process.stdin.resume();` desaparecer, se `.unref()` aparecer, se o
    ciclo de vida vinculado for removido ou se os handlers globais sumirem.
 
+## [0.1.16] — 2026-11-09
+
+### Adicionado
+
+- **Módulo de Disparos (Campanhas) revisado conforme especificação:**
+  - Rota `PUT /api/campaigns/{id}/status` — altera status
+    (`rascunho`/`ativa`/`pausada`/`concluida`; `ativa` normalize para
+    `em_andamento`; status inválido → 400, campanha inexistente → 404).
+  - `POST /api/campaigns` agora aceita **`filtro_etapa`**: sem `lead_ids`
+    explícitos, seleciona automaticamente os leads da etapa do CRM escolhida
+    (ex.: "Novos Leads"), e **`mensagem`** (texto do template) — usada pelo
+    agente de disparo quando presente.
+  - Página `frontend/src/pages/Disparos.tsx` reformulada em **tabela**
+    (Nome · Status · Total de Leads · Data de Criação · Ações), botão
+    **"Nova Campanha"** grande no topo (Fitts + von Restorff) e modal com nome,
+    **template da mensagem** (textarea), canal e **dropdown de filtro por etapa
+    do CRM**. Ações na tabela: **Iniciar** (gradiente), **Pausar** e **Parar**.
+  - UX: badges de status vibrantes (verde "Ativa", amarelo "Pausada", cinza
+    "Rascunho" — von Restorff) e **barra de progresso + spinner** para
+    campanhas ativas (Zeigarnik, com polling react-query a cada 4s).
+- **5 novos testes pytest** (`backend/tests/test_campaigns_routes.py`):
+  listagem, criação com filtro de etapa + persistência, payload inválido,
+  alteração de status (ativa/pausada) e erros (status inválido 400 /
+  inexistente 404).
+
+### Corrigido
+
+- **Launcher — kill switch (6ª regra inviolável):** o launcher NUNCA mais
+  ignora uma porta ocupada por instância anterior do LeadMaster — antes de
+  subir, encerra a instância antiga confirmada (PID dono da porta via
+  `netstat -ano` no Windows / `lsof -ti:porta -sTCP:LISTEN` no Unix, com
+  fallback `ps`), `taskkill /F /T /PID` ou `kill -9`, aguardando até 5s a
+  liberação. A mensagem "já está rodando" foi **removida** (impedia
+  atualizações e causava `EBUSY` no npx). Processos de outros projetos nunca
+  são tocados (avança para a próxima porta). Roda no `install` (libera
+  arquivos) e no `start`. Gate de regressão reforçado com as asserções do
+  kill switch.
+
+## [0.1.15] — 2026-11-08
+
+### Corrigido
+
+- **Launcher — kill switch: a versão nova SEMPRE assume o controle** — o
+   bloqueio de porta foi eliminado. Antes, ao detectar a porta ocupada, o
+   `cli.mjs` apenas imprimia "LeadMaster já está rodando" e encerrava: a versão
+   antiga continuava no ar, o usuário não conseguia testar a nova e o `npx`
+   falhava com `EBUSY` (arquivos travados no Windows). Agora:
+   - **`encerrarInstanciaAnterior()`** roda no início do `install` (libera os
+     arquivos antes de instalar — fim do `EBUSY`) e do `start`;
+   - descoberta do PID dono da porta via `netstat -ano` (Windows) /
+     `lsof -ti:porta` (Linux/macOS, com fallback `ps`), seguida de
+     `taskkill /F /T /PID` ou `kill -9`;
+   - espera de até 5s pela liberação da porta antes de subir o novo servidor;
+   - **higiene preservada:** só mata processos **confirmados** como LeadMaster
+     (`/api/health` com payload próprio + PID dono da porta). Portas ocupadas
+     por outros projetos são respeitadas — o launcher avança para a próxima
+     porta livre, como sempre;
+   - ciclo de vida vinculado mantido: com o Python antigo morto, o Node antigo
+     encerra sozinho (`child.on('exit')`/`close`).
+- **AGENTS.md:** 6ª regra inviolável do launcher — *Kill switch*: nunca ignorar
+   porta ocupada por instância do LeadMaster; mensagem de reuso **proibida**.
+- **Gate de regressão:** `test_launcher_protections.py` falha se o kill switch
+   desaparecer (`encerrarInstanciaAnterior`/`taskkill`/`netstat`/`lsof`) ou se a
+   mensagem proibida voltar. Suíte completa: **32 passed**.
+- **Testado ao vivo:** instância anterior na mesma porta detectada, encerrada
+   (PID confirmado) e nova instância assumida com PID novo; node antigo caiu
+   pelo ciclo de vida; instância de outros projetos preservada.
+
 ## [0.1.14] — 2026-11-08
 
 ### Adicionado

package/backend/main.py

@@ -104,7 +104,9 @@ class CampaignIn(BaseModel):
     nome: str = Field(min_length=1)
     canal: str = "texto"
     template: str = "texto"
+    mensagem: str = ""
     lead_ids: list[str] = []
+    filtro_etapa: str | None = None
 
 
 class InstagramIn(BaseModel):
@@ -354,12 +356,34 @@ def listar_campanhas():
 @app.post("/api/campaigns", status_code=201)
 def criar_campanha(campaign_in: CampaignIn):
     campaign = campaign_in.model_dump()
+    # Filtro por etapa do CRM: sem lead_ids explícitos, seleciona os leads da
+    # etapa escolhida (ex.: "Novos Leads").
+    if not campaign["lead_ids"] and campaign.get("filtro_etapa"):
+        _validar_etapa(campaign["filtro_etapa"])
+        campaign["lead_ids"] = [l["id"] for l in storage.list_leads() if l.get("etapa") == campaign["filtro_etapa"]]
     campaign["id"] = storage._novo_id()
     campaign.update({"status": "rascunho", "total": len(campaign["lead_ids"]), "enviadas": 0, "erros": 0, "eventos": [], "criado_em": storage.now_iso()})
     storage.upsert_campaign(campaign)
     return campaign
 
 
+@app.put("/api/campaigns/{campaign_id}/status")
+def alterar_status_campanha(campaign_id: str, dados: dict):
+    """Altera o status de uma campanha (rascunho/ativa/pausada/concluida)."""
+    status = (dados.get("status") or "").strip().lower()
+    # Aliases aceitos: "ativa" equivale a "em_andamento" no ciclo interno.
+    aliases = {"ativa": "em_andamento", "em_andamento": "em_andamento", "pausada": "pausada", "pausado": "pausada", "rascunho": "rascunho", "concluida": "concluida"}
+    interno = aliases.get(status)
+    if not interno:
+        raise HTTPException(400, 'Status inválido. Use: rascunho, ativa, pausada ou concluida.')
+    campaign = storage.get_campaign(campaign_id)
+    if not campaign:
+        raise HTTPException(404, "Campanha não encontrada.")
+    campaign["status"] = interno
+    storage.upsert_campaign(campaign)
+    return campaign
+
+
 @app.post("/api/campaigns/{campaign_id}/start")
 def iniciar_campanha(campaign_id: str):
     resultado = agents.iniciar_campanha(campaign_id)

package/backend/services/agents.py

@@ -152,7 +152,10 @@ def _executar_campanha(campaign_id: str) -> None:
             storage.upsert_campaign(campaign)
             continue
 
-        mensagem = render_template(templates.get(campaign.get("canal", "texto"), templates.get("texto", "")), lead)
+        mensagem = render_template(
+            campaign.get("mensagem") or templates.get(campaign.get("canal", "texto"), templates.get("texto", "")),
+            lead,
+        )
         try:
             r = httpx.post(
                 f"{base}/{send_path}",

package/backend/tests/test_campaigns_routes.py

@@ -0,0 +1,71 @@
+"""Testes do módulo de Campanhas/Disparos (backend/main.py).
+
+Cobrem listagem, criação (com filtro por etapa do CRM) e alteração de status
+via PUT /api/campaigns/{id}/status. LEADMASTER_HOME em diretório temporário.
+"""
+
+import pytest
+from fastapi.testclient import TestClient
+
+import main
+
+
+@pytest.fixture()
+def client(tmp_path, monkeypatch):
+    monkeypatch.setenv("LEADMASTER_HOME", str(tmp_path))
+    with TestClient(main.app) as c:
+        yield c
+
+
+def test_listar_campanhas(client):
+    r = client.get("/api/campaigns")
+    assert r.status_code == 200
+    assert isinstance(r.json(), list)
+    assert len(r.json()) >= 1  # seeds de demonstração
+
+
+def test_criar_campanha_com_filtro_etapa(client):
+    # Total de leads na etapa "leads" (seeds).
+    leads_leads = [l for l in client.get("/api/crm/leads").json() if l["etapa"] == "leads"]
+    r = client.post(
+        "/api/campaigns",
+        json={
+            "nome": "Campanha Filtro",
+            "canal": "texto",
+            "template": "texto",
+            "mensagem": "Olá {{primeiro_nome}}, tudo bem?",
+            "filtro_etapa": "leads",
+        },
+    )
+    assert r.status_code == 201
+    campanha = r.json()
+    assert campanha["nome"] == "Campanha Filtro"
+    assert campanha["status"] == "rascunho"
+    assert campanha["total"] == len(leads_leads)
+    assert len(campanha["lead_ids"]) == len(leads_leads)
+    # Persistida
+    lista = client.get("/api/campaigns").json()
+    assert any(c["id"] == campanha["id"] for c in lista)
+
+
+def test_criar_campanha_payload_invalido(client):
+    r = client.post("/api/campaigns", json={"canal": "texto"})
+    assert r.status_code == 422  # nome obrigatório
+
+
+def test_alterar_status_ativa_e_pausada(client):
+    criada = client.post("/api/campaigns", json={"nome": "Status Teste", "lead_ids": []}).json()
+    r = client.put(f"/api/campaigns/{criada['id']}/status", json={"status": "ativa"})
+    assert r.status_code == 200
+    assert r.json()["status"] == "em_andamento"
+    r2 = client.put(f"/api/campaigns/{criada['id']}/status", json={"status": "pausada"})
+    assert r2.status_code == 200
+    assert r2.json()["status"] == "pausada"
+
+
+def test_alterar_status_invalido_e_inexistente(client):
+    criada = client.post("/api/campaigns", json={"nome": "Status X", "lead_ids": []}).json()
+    r = client.put(f"/api/campaigns/{criada['id']}/status", json={"status": "nao_existe"})
+    assert r.status_code == 400
+    r2 = client.put("/api/campaigns/nao-existe/status", json={"status": "ativa"})
+    assert r2.status_code == 404

package/backend/tests/test_launcher_protections.py

@@ -6,9 +6,11 @@ Windows (MobaXterm) for removida:
 1. Keep-alive com setInterval (event loop ativo sem I/O de console);
 2. Terminal preso: `process.stdin.resume();` (PTY do MobaXterm nunca fecha);
    sem `process.exit(0)` no caminho de sucesso e sem `.unref()` no worker;
-3. Absorção de SIGINT/SIGHUP no Windows (apenas log, sem encerrar);
-4. Função guardConsoleStream (anti-EPIPE com espelho em arquivo de log);
-5. Isolamento do worker Python (detached: true / CREATE_NEW_PROCESS_GROUP).
+3. Kill switch: instância anterior do LeadMaster encerrada antes de subir a
+   nova versão (taskkill/lsof pelo PID da porta) — nunca reuso de instância;
+4. Absorção de SIGINT/SIGHUP no Windows (apenas log, sem encerrar);
+5. Função guardConsoleStream (anti-EPIPE com espelho em arquivo de log);
+6. Isolamento do worker Python (detached: true / CREATE_NEW_PROCESS_GROUP).
 """
 
 from pathlib import Path
@@ -31,6 +33,17 @@ class TestLauncherProtections:
     def test_worker_nunca_unref(self):
         assert ".unref()" not in _conteudo()
 
+    def test_kill_switch_mata_instancia_anterior(self):
+        # Regra inviolável: nunca ignorar uma porta ocupada por outra instância
+        # do LeadMaster — matar o processo antigo antes de subir o novo. Sem
+        # isso a versão antiga trava arquivos (EBUSY no npx) e a nova não sobe.
+        c = _conteudo()
+        assert "encerrarInstanciaAnterior" in c
+        assert "taskkill" in c  # Windows: mata a árvore do PID da porta
+        assert "netstat" in c or "lsof" in c  # descoberta do PID pela porta
+        # Avisar que já existe instância no ar é proibido (impede atualizações).
+        assert "já está rodando" not in c
+
     def test_ciclo_de_vida_vinculado(self):
         c = _conteudo()
         assert "child.on('exit'" in c or "child.on(\"exit\"" in c
@@ -53,6 +66,18 @@ class TestLauncherProtections:
         assert "detached: true" in c
         assert "windowsHide: true" in c
 
+    def test_kill_switch_presente(self):
+        c = _conteudo()
+        assert "encerrarInstanciaAnterior" in c
+        assert "netstat" in c  # descoberta do PID no Windows
+        assert "lsof" in c  # descoberta do PID no Linux/macOS
+        assert "taskkill" in c and "/F" in c  # kill switch Windows
+
+    def test_nunca_avisa_ja_esta_rodando(self):
+        # Mensagem proibida: impede atualizações e deixa a versão antiga no ar.
+        assert "já está rodando" not in _conteudo().lower()
+        assert "ja esta rodando" not in _conteudo().lower()
+
     def test_sigterm_nao_absorvido(self):
         # SIGTERM/SIGBREAK são paradas legítimas: sempre encerram.
         c = _conteudo()