@danhachuel/leadmaster 0.1.15 → 0.1.17

package/CHANGELOG.md

@@ -37,6 +37,69 @@ 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.17] — 2026-11-09
+
+### Corrigido
+
+- **Erro `EBUSY` do npx — migração para Runtime Permanente.** A 0.1.15 tentou
+  resolver com kill switch dentro do launcher, o que é impossível: o `EBUSY`
+  acontece no gerenciador de arquivos do `npx` (`_npx\...`) **antes** de o
+  `cli.mjs` ser carregado, então o kill switch nunca rodava. Causa raiz: o
+  `uvicorn` era spawnado com `cwd` dentro do cache do npx, segurando o
+  diretório. Nova arquitetura:
+  - Pasta permanente **`<home>/.runtime`** guarda `backend/` + `frontend/dist/`.
+  - `install`: kill switch (libera arquivos) → apaga o `.runtime` anterior →
+    copia esta versão do pacote para ele. O cache do npx nunca mais é tocado
+    por processos nossos.
+  - `start`: spawna o Python a partir de **`<home>/.runtime/backend`** (nunca
+    de `__dirname`); sem `.runtime` pronto, auto-aprovisiona; com pronto,
+    reutiliza sem recopiar.
+  - Launcher faz `process.chdir(home)` na entrada — cwd fora do cache.
+  - Regra inviolável documentada no AGENTS.md ("terminantemente proibido
+    executar o servidor a partir da pasta temporária do npx") + gate de
+    regressão (`.runtime`, `copiarParaRuntime`, `cpSync`, `rmSync`,
+    `path.join(runtime, 'backend')`, `process.chdir(homeLauncher)`).
+  - `.runtime/` adicionado ao `.gitignore`; `doctor` reporta o status do
+    runtime.
+
+## [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

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

@@ -66,6 +66,31 @@ 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_runtime_permanente(self):
+        # Arquitetura anti-EBUSY: executar de <home>/.runtime, nunca do cache npx.
+        c = _conteudo()
+        assert ".runtime" in c
+        assert "copiarParaRuntime" in c
+        assert "runtimeDir" in c
+        assert "cpSync" in c  # cópia recursiva para o runtime
+        assert "rmSync" in c  # limpeza do runtime anterior
+        # O spawn do servidor usa o runtime, não o PKG_ROOT.
+        assert "path.join(runtime, 'backend')" in c
+        # O launcher sai do cache do npx logo na entrada.
+        assert "process.chdir(homeLauncher)" in c
+
     def test_sigterm_nao_absorvido(self):
         # SIGTERM/SIGBREAK são paradas legítimas: sempre encerram.
         c = _conteudo()