docs: protocolo SESSION-CHECKPOINT em todas as specs + Rule Cursor

Handoff entre agentes/sessões: template, checkpoints idle, 043 in_progress
actualizado, spec-session-handoff.mdc e checklist spec-driver-sync.

.cursor/rules/spec-driver-sync.mdc

@@ -74,6 +74,8 @@ GitHub **não substitui** Forgejo; é réplica read-only ou bidirecional acordad
 
 ## 6. Checklist de saída (não dispensar)
 
+- [ ] `SESSION-CHECKPOINT.md` actualizado (ver `spec-session-handoff.mdc`)
+- [ ] `tasks.md` sincronizado (`[x]` / `[ ]`)
 - [ ] Spec reflete decisões do chat
 - [ ] Chat bruto salvo e linkado (se houve discussão)
 - [ ] `refresh-spec-driver.sh` executado no CT130

.cursor/rules/spec-session-handoff.mdc

@@ -0,0 +1,50 @@
+---
+description: Protocolo SESSION-CHECKPOINT — handoff entre agentes e sessões (todas as specs Ligbox)
+globs: specs/**/*,**/ligbox-ops-platform/specs/**,**/SESSION-CHECKPOINT*.md
+alwaysApply: true
+---
+
+# Spec Session Handoff — Roger / Ligbox
+
+**Problema:** agentes Cursor não partilham memória de chat.  
+**Solução:** estado vivo em `SESSION-CHECKPOINT.md` por spec (vault VM130 = fonte de verdade).
+
+## Entrada (OBRIGATÓRIO antes de implementar)
+
+1. Identificar a spec activa (Roger indica ou `tasks.md` com `[ ]` críticos).
+2. Ler **`specs/NNN-*/SESSION-CHECKPOINT.md`** — status, bloqueios, smoke tests.
+3. Ler **`spec.md`** + **`tasks.md`** + **`contracts/`** se existir.
+4. Correr **smoke test** listado no checkpoint (ou health mínimo da VM da spec).
+5. Se `status: in_progress` e outro agente listado → **não sobrescrever**; actualizar secção Histórico ou pedir confirmação a Roger.
+
+## Durante o trabalho
+
+- Uma spec **in_progress** de cada vez em VMs críticas (VM112, VM122, VM123).
+- Decisões novas → `spec.md` (Decisões/Histórico) + checkpoint.
+- Código deploy → nota no checkpoint (path, container, versão).
+
+## Saída (OBRIGATÓRIO antes de encerrar)
+
+1. Actualizar **`SESSION-CHECKPOINT.md`**:
+   - `status`, data, resumo feito/bloqueio/próximo passo
+   - linha em **Histórico de sessões**
+2. Actualizar **`tasks.md`** (`[x]` / `[ ]`).
+3. Se spec nova ou template mudou → seguir também **`spec-driver-sync.mdc`** (portal Forgejo).
+4. **Nunca** deixar secrets no checkpoint (só referências: «ver .env VM122»).
+
+## Status permitidos
+
+| Status | Significado |
+|--------|-------------|
+| `idle` | Spec documentada; sem trabalho activo |
+| `in_progress` | Agente a implementar/deploy/testar |
+| `blocked` | Parado — bloqueio explícito na secção Bloqueios |
+| `done` | Entregue; smoke OK; tasks críticas `[x]` |
+
+## Template
+
+Copiar de `specs/SESSION-CHECKPOINT-TEMPLATE.md` ao criar spec nova.
+
+## Spec activa (referência rápida)
+
+Consultar sempre o checkpoint **com `status: in_progress`** mais recente — tipicamente a spec que Roger mencionou na mensagem.

specs/001-webhook-vm112-integration/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 001 — Webhook VM112 → Ops Platform
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+Webhook VM112 → Ops Platform
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md` e `tasks.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | \`./tasks.md\` |
+| **contracts/** | \`./contracts/\` |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/002-wazuh-integration/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 002 — Integrações externas — Wazuh (002)
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+Integrações externas — Wazuh (002)
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md` e `tasks.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | \`./tasks.md\` |
+| **contracts/** | _não existe_ |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/003-desk-auth-rbac/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 003 — Desk Auth & RBAC (003)
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+Desk Auth & RBAC (003)
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md` e `tasks.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | \`./tasks.md\` |
+| **contracts/** | \`./contracts/\` |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/004-desk-account-management/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 004 — Desk Account Management & Registration (004)
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+Desk Account Management & Registration (004)
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md` e `tasks.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | \`./tasks.md\` |
+| **contracts/** | _não existe_ |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/004-onboard-funnel-events/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 004 — Funil de Onboarding Completo (004)
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+Funil de Onboarding Completo (004)
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md` e `tasks.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | \`./tasks.md\` |
+| **contracts/** | \`./contracts/\` |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/007-mobile-push-notifications/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 007 — Push Mobile & Web — Ligbox Ops (007)
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+Push Mobile & Web — Ligbox Ops (007)
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md` e `tasks.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | \`./tasks.md\` |
+| **contracts/** | _não existe_ |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/009-ops-audit-overview/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 009 — Audit Overview Dashboard (009)
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+Audit Overview Dashboard (009)
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md` e `tasks.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | \`./tasks.md\` |
+| **contracts/** | \`./contracts/\` |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/010-admin-domain-validation/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 010 — SPEC — Integração Validação Admin Domínios Virtuais (Wizard VM112 + Desk VM122)
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+SPEC — Integração Validação Admin Domínios Virtuais (Wizard VM112 + Desk VM122)
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | _não existe_ |
+| **contracts/** | _não existe_ |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/010-desk-assist-takeover/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 010 — Desk Assist & Takeover — Intervenção Técnica (010)
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+Desk Assist & Takeover — Intervenção Técnica (010)
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md` e `tasks.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | \`./tasks.md\` |
+| **contracts/** | _não existe_ |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/011-integration-otrs/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 011 — Integração OTRS — VM112 ↔ OTRS (011)
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+Integração OTRS — VM112 ↔ OTRS (011)
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | _não existe_ |
+| **contracts/** | _não existe_ |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/011-mail-tls-wizard-validation/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 011 — SPEC / BACKLOG — Validação Mail TLS no Wizard (IMAP :993 + Cert Multi-SAN)
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+SPEC / BACKLOG — Validação Mail TLS no Wizard (IMAP :993 + Cert Multi-SAN)
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | _não existe_ |
+| **contracts/** | _não existe_ |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/012-abandoned-onboarding-lead/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 012 — Onboarding Abandonado → Lead CRM (012)
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+Onboarding Abandonado → Lead CRM (012)
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md` e `tasks.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | \`./tasks.md\` |
+| **contracts/** | _não existe_ |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/013-email-server-migration/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 013 — Migração de E-mail entre Servidores (013)
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+Migração de E-mail entre Servidores (013)
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md` e `tasks.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | \`./tasks.md\` |
+| **contracts/** | _não existe_ |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/014-funnel-phase-timing/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 014 — Relógio por fase — Onboarding VM112 (014)
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+Relógio por fase — Onboarding VM112 (014)
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | _não existe_ |
+| **contracts/** | _não existe_ |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/015-desk-module-registry/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 015 — Registry de Módulos Desk (015)
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+Registry de Módulos Desk (015)
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | _não existe_ |
+| **contracts/** | _não existe_ |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/016-onboard-self-service-prefill/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 016 — Pré-preenchimento Self-Service → Wizard (016)
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+Pré-preenchimento Self-Service → Wizard (016)
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md` e `tasks.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | \`./tasks.md\` |
+| **contracts/** | _não existe_ |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/017-vm112-domain-orchestration/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 017 — Domínios VM112 — Purge & Histórico (017)
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+Domínios VM112 — Purge & Histórico (017)
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | _não existe_ |
+| **contracts/** | _não existe_ |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/018-service-orchestration/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 018 — Orquestração de Serviços — Cliente & Catálogo (018)
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+Orquestração de Serviços — Cliente & Catálogo (018)
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | _não existe_ |
+| **contracts/** | _não existe_ |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/019-email-migration-vm122-execution/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 019 — Migração E-mail Legado — Execução VM122 (019)
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+Migração E-mail Legado — Execução VM122 (019)
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md` e `tasks.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | \`./tasks.md\` |
+| **contracts/** | _não existe_ |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/019-ops-console-active-operations/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 019 — Ligbox Ops Console — Operação Activa (019)
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+Ligbox Ops Console — Operação Activa (019)
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md` e `tasks.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | \`./tasks.md\` |
+| **contracts/** | \`./contracts/\` |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/020-purge-history-desk/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 020 — ~~Spec 020~~ — Consolidada na Spec 017 v2
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+~~Spec 020~~ — Consolidada na Spec 017 v2
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | _não existe_ |
+| **contracts/** | _não existe_ |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/021-wizard-cybersecurity-telemetry/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 021 — Cibersegurança do Wizard — Telemetria em Tempo Real (021)
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+Cibersegurança do Wizard — Telemetria em Tempo Real (021)
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md` e `tasks.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | \`./tasks.md\` |
+| **contracts/** | _não existe_ |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/022-carbonio-account-exists-release/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 022 — Libertar e-mail bloqueado (ACCOUNT_EXISTS)
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+Libertar e-mail bloqueado (ACCOUNT_EXISTS)
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md` e `tasks.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | \`./tasks.md\` |
+| **contracts/** | _não existe_ |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/023-billing-recurrence-desk-visibility/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 023 — Cobrança recorrente & visibilidade Desk (empresa / billing)
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+Cobrança recorrente & visibilidade Desk (empresa / billing)
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md` e `tasks.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | \`./tasks.md\` |
+| **contracts/** | _não existe_ |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/024-openpanel-fossbilling/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 024 — FOSSBilling + OpenPanel + Odoo 16 (VM123)
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+FOSSBilling + OpenPanel + Odoo 16 (VM123)
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md` e `tasks.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | \`./tasks.md\` |
+| **contracts/** | _não existe_ |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/025-wizard-onboarding-continuity/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 025 — Onboarding contínuo (sem gaps)
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+Onboarding contínuo (sem gaps)
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md` e `tasks.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | \`./tasks.md\` |
+| **contracts/** | _não existe_ |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/026-purge-traefik-validation/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 026 — Purge VM112: validação Traefik pós-remoção (CT114)
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+Purge VM112: validação Traefik pós-remoção (CT114)
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | _não existe_ |
+| **contracts/** | _não existe_ |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/027-desk-rbac-function-matrix/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 027 — Matriz de Acesso por Função (Time Ligbox)
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+Matriz de Acesso por Função (Time Ligbox)
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | _não existe_ |
+| **contracts/** | \`./contracts/\` |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/028-openpanel-ce-ligbox-reengineering/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 028 — OpenPanel CE Ligbox Re-engenharia (Enterprise Local)
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+OpenPanel CE Ligbox Re-engenharia (Enterprise Local)
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md` e `tasks.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | \`./tasks.md\` |
+| **contracts/** | \`./contracts/\` |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/029-agentic-ops-runbooks/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 029 — Agentic Ops Runbooks (T0 → T1)
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+Agentic Ops Runbooks (T0 → T1)
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md` e `tasks.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | \`./tasks.md\` |
+| **contracts/** | \`./contracts/\` |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/029-tickets-workspace/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 029 — Tickets Workspace (Motor de Tickets)
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+Tickets Workspace (Motor de Tickets)
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | _não existe_ |
+| **contracts/** | _não existe_ |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/030-agentic-ops-ui/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 030 — Agentic Ops UI (Mission Board)
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+Agentic Ops UI (Mission Board)
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md` e `tasks.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | \`./tasks.md\` |
+| **contracts/** | \`./contracts/\` |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/031-spec-hub-portal/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 031 — Ligbox Spec Hub Portal (CT130)
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+Ligbox Spec Hub Portal (CT130)
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | _não existe_ |
+| **contracts/** | _não existe_ |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/032-purge-domain-extra-auth/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 032 — Purge domínio: autorização extra (códigos Infra)
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+Purge domínio: autorização extra (códigos Infra)
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | _não existe_ |
+| **contracts/** | _não existe_ |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/033-desk-infra-console-ui/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 033 — Desk Infra Console UI (process cards)
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+Desk Infra Console UI (process cards)
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | _não existe_ |
+| **contracts/** | _não existe_ |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/034-nextcloud-carbonio-vm112-integration/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 034 — Nextcloud + E-mail VM112 (ampliar capacidade Carbonio)
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+Nextcloud + E-mail VM112 (ampliar capacidade Carbonio)
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md` e `tasks.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | \`./tasks.md\` |
+| **contracts/** | \`./contracts/\` |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/035-ligbox-mail-bundles-foss-openpanel/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 035 — Bundles Ligbox Mail (FOSSBilling + OpenPanel + Nextcloud)
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+Bundles Ligbox Mail (FOSSBilling + OpenPanel + Nextcloud)
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md` e `tasks.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | \`./tasks.md\` |
+| **contracts/** | _não existe_ |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/035-ligbox-watchman/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 035 — Ligbox Watchman (vigilância contínua + alertas)
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+Ligbox Watchman (vigilância contínua + alertas)
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md` e `tasks.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | \`./tasks.md\` |
+| **contracts/** | \`./contracts/\` |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/036-backstage-techdocs-speckit-companion/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 036 — Backstage TechDocs + Spec Kit Companion (stack duplo)
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+Backstage TechDocs + Spec Kit Companion (stack duplo)
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md` e `tasks.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | \`./tasks.md\` |
+| **contracts/** | _não existe_ |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/037-dns-multi-cloudflare-orchestration/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 037 — DNS multi-conta Cloudflare + BYO + Registrador
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+DNS multi-conta Cloudflare + BYO + Registrador
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md` e `tasks.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | \`./tasks.md\` |
+| **contracts/** | _não existe_ |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/038-nutranik-mail-proxy-vm108/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 038 — Proxy mail.nutranik.com (VM108 via VM112)
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+Proxy mail.nutranik.com (VM108 via VM112)
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md` e `tasks.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | \`./tasks.md\` |
+| **contracts/** | \`./contracts/\` |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/039-ligbox-ops-authorization-catalog/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 039 — Catálogo Mestre de Autorização Ligbox OPS
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+Catálogo Mestre de Autorização Ligbox OPS
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | _não existe_ |
+| **contracts/** | \`./contracts/\` |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/040-desk-design-system-v013/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 040 — Desk Design System v0.13 (UI Operacional)
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+Desk Design System v0.13 (UI Operacional)
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md` e `tasks.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | \`./tasks.md\` |
+| **contracts/** | \`./contracts/\` |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/041-desk-operational-feed/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 041 — Central Operacional (Operational Feed)
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+Central Operacional (Operational Feed)
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md` e `tasks.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | \`./tasks.md\` |
+| **contracts/** | \`./contracts/\` |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/042-ligbox-nettools-portal/SESSION-CHECKPOINT.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec 042 — Ligbox NetTools Portal (`nettools.ligbox.com.br`)
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | — |
+| **Prioridade** | — |
+
+---
+
+## Objetivo (1 linha)
+
+Ligbox NetTools Portal (`nettools.ligbox.com.br`)
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md` e `tasks.md`
+2. Quando Roger activar esta spec → mudar status para `in_progress`
+
+---
+
+## Smoke tests
+
+```bash
+# Definir quando spec entrar em implementação
+# Ver VMs em docs/vms/ ou spec.md
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | \`./tasks.md\` |
+| **contracts/** | \`./contracts/\` |
+| **Rollback** | _não existe_ |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | — | Checkpoint inicial (protocolo handoff) |
+

specs/043-desk-client-activation-sync/SESSION-CHECKPOINT.md

@@ -0,0 +1,95 @@
+# SESSION-CHECKPOINT — Spec 043 — Desk Client Activation Sync
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `in_progress` |
+| **Última actualização** | 2026-07-01 |
+| **Agente / sessão** | Agente B (043/035) + checkpoint protocolo |
+| **Prioridade** | P0 |
+
+---
+
+## Objetivo (1 linha)
+
+Wizard → Desk Activar conta → FOSS → OpenPanel → Odoo → mail-bundle VM112.
+
+---
+
+## Feito (agente anterior — commit 884321c)
+
+- [x] Produto FOSS `ligbox-mail-business` (product_id=3, hp_id=2)
+- [x] Script `deploy/vm123-finance-stack/create-foss-mail-business.sh`
+- [x] Código mail-bundle VM112 (`mail_bundle.py`, `internal_provision.py`) no repo
+- [x] Deploy código mail-bundle na VM112 (router activo — HTTP 401 sem token)
+- [x] Contrato `contracts/mail-bundle-api.md`
+- [x] Runbook `deploy/vm112-wizard/MAIL-BUNDLE-DEPLOY.md`
+- [x] Desk Spec 043 código no container (264 linhas billing_routes) — deploy temporário
+
+---
+
+## Feito (sessão anterior Roger)
+
+- [x] Webhooks VM112 `company.validated` + `webmail.released`
+- [x] E2E parcial dratcoin: OpenPanel `dratcoix` + Odoo #9 → `billing_active`
+- [x] Token FOSS API admin (VM123)
+- [x] Protocolo SESSION-CHECKPOINT todas as specs + Rule Cursor
+
+---
+
+## Bloqueios / falta fechar
+
+1. **`OPS_INTERNAL_TOKEN` VM112** — wizard `.env` sem token; mail-bundle retorna 401
+2. **FOSS client/order dratcoin** — `external_customer_id` ainda `null`; bug `create_client` client_id
+3. **Deploy permanente VM122** — Spec 043 ainda via `docker cp`, não rebuild imagem
+4. **Planos OpenPanel** — só business FOSS; starter/enterprise/custom + planos OP espelho
+5. **E2E Fase 6** — `tasks.md` linha Roger ainda `[ ]`
+
+---
+
+## Próximo passo
+
+1. Sincronizar `OPS_INTERNAL_TOKEN` VM122 → VM112 `.env` + restart wizard
+2. Re-activar ou patch dratcoin com FOSS order + mail-bundle
+3. Deploy permanente VM122 (`git pull` + rebuild api)
+4. E2E Roger completo → marcar Fase 6 `[x]`
+
+---
+
+## Smoke tests
+
+```bash
+curl -s http://10.10.10.122:8080/health
+curl -s http://10.10.10.112:8090/api/health 2>/dev/null || curl -s -o /dev/null -w "%{http_code}" http://10.10.10.112:8090/docs
+# mail-bundle (requer token):
+curl -s -X POST http://10.10.10.112:8090/api/internal/provision/mail-bundle \
+  -H "X-Ops-Internal-Token: $OPS_INTERNAL_TOKEN" -H "Content-Type: application/json" \
+  -d "{\"domain\":\"dratcoin.com\",\"admin_email\":\"001@dratcoin.com\",\"seats\":25}"
+curl -s "https://financeiro.ligbox.com.br/api/admin/product/get_list" -u "admin:$FOSS_TOKEN" -d "{\"per_page\":10}"
+```
+
+---
+
+## Referências
+
+| Item | Path |
+|------|------|
+| tasks.md | `./tasks.md` |
+| mail-bundle API | `./contracts/mail-bundle-api.md` |
+| Deploy VM112 | `../../deploy/vm112-wizard/MAIL-BUNDLE-DEPLOY.md` |
+| Conta teste | dratcoin.com billing #2 |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| 2026-07-01 | A | E2E parcial; webhooks; protocolo handoff |
+| 2026-07-01 | B | FOSS product + mail-bundle código/deploy VM112 |
+| 2026-07-01 | A | Commit protocolo; audit o que falta |

specs/SESSION-CHECKPOINT-TEMPLATE.md

@@ -0,0 +1,69 @@
+# SESSION-CHECKPOINT — Spec NNN — [Título curto]
+
+> **Handoff entre agentes/sessões Cursor.** Ler **antes** de actuar. Actualizar **antes** de sair.  
+> Template: [`../SESSION-CHECKPOINT-TEMPLATE.md`](../SESSION-CHECKPOINT-TEMPLATE.md)
+
+---
+
+## Estado
+
+| Campo | Valor |
+|-------|-------|
+| **Status** | `idle` \| `in_progress` \| `blocked` \| `done` |
+| **Última actualização** | YYYY-MM-DD |
+| **Agente / sessão** | — |
+| **Prioridade** | P0 \| P1 \| P2 \| — |
+
+---
+
+## Objetivo (1 linha)
+
+_[Resumo do `spec.md`]_
+
+---
+
+## Feito (última sessão)
+
+- _Nada nesta sessão._
+
+---
+
+## Bloqueios
+
+- _Nenhum._
+
+---
+
+## Próximo passo
+
+1. Ler `spec.md` e `tasks.md`
+2. _…_
+
+---
+
+## Smoke tests
+
+```bash
+# Substituir pelos comandos/URLs desta spec
+# curl -s http://10.10.10.122:8080/health
+```
+
+---
+
+## Referências rápidas
+
+| Item | Valor |
+|------|-------|
+| **spec.md** | `./spec.md` |
+| **tasks.md** | `./tasks.md` |
+| **contracts/** | `./contracts/` (se existir) |
+| **VMs** | — |
+| **Rollback** | `./ROLLBACK.md` (se existir) |
+
+---
+
+## Histórico de sessões
+
+| Data | Agente | Resumo |
+|------|--------|--------|
+| YYYY-MM-DD | — | Checkpoint inicial |

specs/SPECS-SESSION-PROTOCOL.md

@@ -0,0 +1,26 @@
+# Protocolo SESSION-CHECKPOINT — Ligbox Specs
+
+**Objectivo:** handoff entre agentes Cursor e sessões Roger sem depender da memória do chat.
+
+## Ficheiros
+
+| Ficheiro | Onde | Função |
+|----------|------|--------|
+| `SESSION-CHECKPOINT-TEMPLATE.md` | `specs/` | Modelo vazio |
+| `NNN-*/SESSION-CHECKPOINT.md` | cada spec | Estado vivo |
+| `.cursor/rules/spec-session-handoff.mdc` | repo | Rule Cursor |
+
+## Fluxo
+
+1. **Entrada:** ler checkpoint → spec.md → tasks.md → smoke test
+2. **Trabalho:** status `in_progress`; uma VM crítica por agente
+3. **Saída:** actualizar checkpoint + tasks.md + histórico
+
+## Status
+
+- `idle` — sem trabalho activo
+- `in_progress` — implementação/deploy em curso
+- `blocked` — parado (bloqueio documentado)
+- `done` — entregue e validado
+
+Ver Rule Cursor: `spec-session-handoff.mdc`