diff --git a/gestao/skills/today/SKILL.md b/gestao/skills/today/SKILL.md index 465beef..ff3e0a7 100644 --- a/gestao/skills/today/SKILL.md +++ b/gestao/skills/today/SKILL.md @@ -1,28 +1,35 @@ --- name: today -description: Checkup diário - dashboard agregador que lê resultados dos agentes cron locais (desktop) e recolhe dados frescos via skills interactivas. Usar quando "checkup", "hoje", "today", "rotina", início de dia. +description: Checkup diário - dashboard agregador que lê resultados dos agentes systemd locais (desktop/hp) e recolhe dados frescos via skills interactivas. Usar quando "checkup", "hoje", "today", "rotina", início de dia. context: fork --- -# /today v11.0 - Checkup Diario (Agregador) +# /today v12.0 - Checkup Diario (Agregador) -Le resultados dos agentes cron locais (desktop, crontab ealmeida) + invoca skills interactivas. Nao duplica trabalho automatizado. +Lê resultados dos agentes systemd locais (user timers, desktop/hp) + invoca skills interactivas. Não duplica trabalho automatizado. --- ## Arquitectura +> Migração: crontab (`claude_automations_dev`, extinto 20-04-2026) → Hermes cronjobs (05-05-2026, Task #2080) → **systemd user timers `stack-observer`** (actual, desde ~11-06-2026). Repo agentes: `git.descomplicar.pt/ealmeida/stack-observer` (código) + `~/.config/systemd/user/*.timer` (agendamento). + ``` -CRON (desktop local, crontab ealmeida) /today (interactivo, sob pedido) -├── imap-triage (4h) ├── Le logs locais do cron -├── auto-expense (4h +15min) ├── /daily-digest (dados frescos) -├── ticket-triage (4h +30min) ├── /tasks-overview (dados frescos) -├── aiktop-tasks (15min) ├── /cleanup-downloads (se necessario) -├── infra-check (diario 7h) ├── Specs/Sprints scan -├── wp-update (segunda 23h) ├── Rotinas especiais por dia -├── intelligence-* (researcher/scorer/ └── Dashboard + Obsidian + Supabase -│ selector/publisher) -└── weekly-digest-podcast (quinta 20h) +SYSTEMD USER TIMERS (desktop/hp) /today (interactivo, sob pedido) +├── collector-gate-events (*/5min) ├── Lê estado systemd (list-timers + list-units --failed) +├── collector-hermes-jobs (*/5min) ├── /daily-digest (dados frescos CRM) +├── observer-ticket-queue (*/5min) ├── /tasks-overview (dados frescos Desk) +├── observer-tickets (diário 09:30) ├── /cleanup-downloads (se necessário) +├── observer-desk-alert (diário 09:00) ├── Specs/Sprints scan +├── update-omp / update-claude (periódico) ├── Rotinas especiais por dia +├── okf-confianca (semanal seg) └── Dashboard + Obsidian + Mem0 +├── verify-gates-registry (semanal seg) +└── stk-drift-check (semanal dom) + +Timers de backup (rclone-bisync, gdrive-sync) e OKF secundários +(okf-health, okf-lint, okf-detect, okf-moc-sync, okf-validate) +existem mas ficam `disabled`/`inactive` por omissão — confirmar +estado antes de assumir que correm. ``` --- @@ -40,60 +47,49 @@ CRON (desktop local, crontab ealmeida) /today (interactivo, sob pedido) ``` 1. mcp__mcp-time__current_time -> data, dia da semana -2. mcp__memory-supabase__search_memories("today checkup YYYY-MM-DD") +2. mcp__mem0__search_memories("today checkup YYYY-MM-DD") -> Se ja existe hoje: perguntar se quer re-executar ``` -### Fase 1: Ler resultados dos agentes cron (silencioso) +### Fase 1: Ler estado dos agentes systemd (silencioso) ``` -3. Ler logs LOCAIS (Bash tail — sem SSH, tudo corre no desktop): +3. Ler estado systemd (Bash — sem SSH, tudo corre no desktop/hp): - Base: /media/ealmeida/Dados/Dev/claude_automations_dev/ + a) Próximas execuções + última corrida de cada timer activo: + systemctl --user list-timers --all --no-legend - a) IMAP (ultimo report): - tail -20 /media/ealmeida/Dados/Dev/claude_automations_dev/imap-triage/imap-triage.log - cat ~/.claude-work/today-imap-DD-MM-YYYY.json (se existir) + b) Unidades falhadas (qualquer serviço, não só os do stack-observer): + systemctl --user list-units --failed --no-legend --all - b) Ticket triage (ultimo log): - tail -30 /media/ealmeida/Dados/Dev/claude_automations_dev/ticket-triage/ticket-triage.log + c) Para cada falha encontrada em (b), obter a causa: + journalctl --user -u .service -n 20 --no-pager - c) Auto-expense (ultimo log): - tail -20 /media/ealmeida/Dados/Dev/claude_automations_dev/auto-expense/auto-expense.log + d) Confirmar se os timers de backup estão activos (regra 3-2-1): + systemctl --user is-enabled rclone-bisync.timer gdrive-sync.timer + systemctl --user is-active rclone-bisync.timer gdrive-sync.timer + -> Se disabled/inactive: ALERTA "Requer Atencao Urgente" (backup offsite em risco) - d) Infra check (ultimo log): - tail -30 /media/ealmeida/Dados/Dev/claude_automations_dev/infra-check/infra-check.log - - e) AikTop tasks (ultimo log): - tail -20 /media/ealmeida/Dados/Dev/claude_automations_dev/aiktop-tasks/aiktop-tasks.log - - f) SE segunda — wp-update (ultimo log): - tail -50 /media/ealmeida/Dados/Dev/claude_automations_dev/wp-update/wp-update.log - - g) Intelligence pipeline: - tail -30 /media/ealmeida/Dados/Dev/claude_automations_dev/daily-selector/daily-selector.log - tail -30 /media/ealmeida/Dados/Dev/claude_automations_dev/intelligence-publisher/intelligence-publisher.log - tail -20 /media/ealmeida/Dados/Dev/claude_automations_dev/intelligence-researcher/intelligence-researcher.log - tail -20 /media/ealmeida/Dados/Dev/claude_automations_dev/intelligence-scorer/intelligence-scorer.log - - h) HEARTBEAT WP — ultimo post em descomplicar.pt categoria 1188 (noticias): + e) HEARTBEAT WP — ultimo post em descomplicar.pt categoria 1188 (noticias): mcp__ssh-unified__ssh_execute(server="server", command="cd /home/ealmeida/public_html && wp post list --post_type=post --category=1188 --posts_per_page=1 --fields=ID,post_title,post_date --format=csv --allow-root 2>&1 | tail -2") + -> Se a ligação SSH falhar (auth/timeout), NÃO repetir a tentativa mais de uma vez + (risco de lockout CSF/LFD no servidor CWP) — reportar como alerta de acesso, + não como heartbeat em falta. -> Calcular idade do ultimo post -> Se >26h sem post novo: ALERTA "Requer Atencao Urgente" + contexto: - * Pipeline deveria publicar ate 5 noticias/dia (selector 06:30 + slots 09/11/13/15:30/17:30) - * Verificar logs daily-selector + publisher (passo g) - * Stock Supabase: scored>=7 count via curl REST - * Verificar se desktop teve downtime (uptime / journalctl) — agentes correm no desktop local + * Pipeline deveria publicar ate 5 noticias/dia + * Verificar journalctl dos timers relacionados (researcher/scorer/selector/publisher, se existirem) + * Verificar se desktop/hp tiveram downtime (uptime / journalctl -b) -4. DETECTAR PROBLEMAS nos logs: - - Cron nao correu (log desactualizado >8h) - - Exit codes != 0 - - Erros ou falhas nos logs - - HEARTBEAT WP >26h sem post novo em cat 1188 +4. DETECTAR PROBLEMAS: + - Timer com falha em list-units --failed + - Timer de backup/OKF crítico disabled/inactive quando deveria estar activo + - Exit codes != 0 nos journalctl consultados + - HEARTBEAT WP >26h sem post novo em cat 1188, ou SSH inacessível -> Adicionar a seccao "Requer Atencao Urgente" 4b. VERIFICAR FORNECEDORES AUTO-CRIADOS: - Ler ~/.claude-work/fornecedores-iva.json + Ler ~/.claude-work/fornecedores-iva.json (se existir) Filtrar entradas com "auto_proposto": true Para cada entrada extrair: nome, dominio (chave), politica, confianca, despesas_count -> Se existirem: adicionar secção "Fornecedores Auto-Criados" no dashboard (ver formato abaixo) @@ -104,10 +100,14 @@ CRON (desktop local, crontab ealmeida) /today (interactivo, sob pedido) ``` 5. Invocar /daily-digest -> Timer, tickets, facturas, leads, propostas, agenda + -> Requer MCP desk-crm-v3 (disabled por omissão, regra 57 CLAUDE.md) — + se desligado, reportar tickets/facturas/leads/propostas como indisponíveis + em vez de tentar contornar com desk-project-minimal (cobertura parcial: só tarefas). -> Output: dashboard markdown 6. Invocar /tasks-overview -> Tarefas overdue, pendentes, em curso, workflows sugeridos + -> desk-project-minimal cobre tarefas (get_overdue_tasks, get_tasks) sem depender do desk-crm-v3 -> Output: tarefas markdown 7. SE >10 ficheiros em ~/Transferencias: @@ -118,9 +118,11 @@ CRON (desktop local, crontab ealmeida) /today (interactivo, sob pedido) ``` 8. Glob: /media/ealmeida/Dados/Dev/**/SPEC.md (profundidade max 3) - -> Para cada encontrado: Ler frontmatter (15 linhas) - -> Filtrar: status != "completed" - -> Extrair: titulo (linha # SPEC:), status, weight, scope done/total + -> Excluir placeholders genéricos: title "Spec"/"SPEC — " com status: draft + e sem secções de conteúdo além do frontmatter (gerados por template, docs/SPECS/SPEC.md) + -> Para cada SPEC.md real (conteúdo substantivo): ler frontmatter (grep ^status: mais rápido que ler 15 linhas por ficheiro) + -> Filtrar: status not in [completed, shipped, abandoned, rejected] + -> Extrair: titulo, status, data approved/updated, projecto Desk associado 9. Glob: /media/ealmeida/Dados/Dev/**/SPRINT.md -> Para cada encontrado: Ler frontmatter @@ -141,8 +143,8 @@ CRON (desktop local, crontab ealmeida) /today (interactivo, sob pedido) ### Fase 3: Output Final ``` -12. AGREGAR resultados de cron + skills: - - Logs do cron (Fase 1) +12. AGREGAR resultados de systemd + skills: + - Estado dos timers/serviços (Fase 1) - Dados frescos do /daily-digest e /tasks-overview (Fase 2) - Specs/Sprints (Fase 2b) @@ -152,10 +154,10 @@ CRON (desktop local, crontab ealmeida) /today (interactivo, sob pedido) Path: /media/ealmeida/Dados/Hub/00-Inbox/DD-MM-YYYY-checkup.md Conteudo: dashboard completo -15. GUARDAR em Supabase: - mcp__memory-supabase__save_memory({ - content: "Checkup diario - X tickets, Y tarefas, Z urgentes, cron OK/FALHA", - tags: ["today", "checkup", "DD-MM-YYYY"] +15. GUARDAR em Mem0 (store canónico cross-agent, CLAUDE.md regra 28): + mcp__mem0__save_memory({ + text: "Checkup diario DD-MM-YYYY: X tarefas vencidas, Y em curso, Z urgentes, timers OK/FALHA", + metadata: {"type": "today-checkup", "date": "YYYY-MM-DD"} }) ``` @@ -169,7 +171,7 @@ CRON (desktop local, crontab ealmeida) /today (interactivo, sob pedido) --- ## Requer Atencao Urgente -[Alertas: cron falhado, erros infra, seguranca, notificacoes criticas] +[Alertas: timer/serviço falhado, backup offsite em risco, SSH inacessível, heartbeat WP em falta, notificacoes criticas] --- @@ -203,25 +205,25 @@ Nota: Promovidos automaticamente após 3 despesas. Confiança "baixa" = fallback --- ## Resumo do Dia -[Do /daily-digest: timer, tickets, facturas, tarefas, leads, agenda] +[Do /daily-digest: timer, tickets, facturas, tarefas, leads, agenda — ou "indisponível, desk-crm-v3 desligado" se aplicável] --- -## Agentes Cron (desktop local) +## Agentes Systemd (desktop/hp local) -| Agente | Ultima execucao | Status | Resumo | -|--------|----------------|--------|--------| -| imap-triage | HH:MM | OK/FALHA | X contas, Y emails | -| auto-expense | HH:MM | OK/SKIP | Z despesas criadas | -| ticket-triage | HH:MM | OK/FALHA | W tickets processados | -| aiktop-tasks | HH:MM | OK/FALHA | N tarefas executadas | -| infra-check | HH:MM | OK/FALHA | X/4 MCPs operacionais | -| wp-update [se seg] | HH:MM | OK/FALHA | X/16 sites actualizados | +| Timer | Ultima execucao | Status | Resumo | +|-------|-----------------|--------|--------| +| collector-gate-events | HH:MM | OK/FALHA | — | +| collector-hermes-jobs | HH:MM | OK/FALHA | — | +| observer-ticket-queue | HH:MM | OK/FALHA | — | +| observer-tickets | HH:MM | OK/FALHA | — | +| observer-desk-alert | HH:MM | OK/FALHA | [journalctl summary se FALHA] | +| rclone-bisync / gdrive-sync | — | ACTIVO/DISABLED | [alerta se desligado] | --- ## Auto-Processamento (ultimas 24h) -[Resumo agregado: despesas criadas, tickets fechados, emails limpos] +[Resumo agregado: divergências detectadas pelo stack-observer, tickets criados, despesas criadas] ``` --- @@ -243,12 +245,14 @@ Filename: `DD-MM-YYYY-checkup.md` (Regra #45: formato DD-MM-YYYY) ## Anti-Patterns -- NUNCA invocar /ticket-triage, /imap-triage, /auto-expense, /infra-check, /wp-update (correm no cron) +- NUNCA invocar manualmente os componentes do stack-observer (correm por timer) - NUNCA mostrar output antes de terminar Fase 1 e 2 - NUNCA mostrar mais de 3 prioridades (PHDA) - NUNCA executar sem verificar data/hora primeiro -- SEMPRE ler logs do cron antes de mostrar dashboard -- SEMPRE alertar se algum agente cron nao correu nas ultimas 8h +- SEMPRE correr `list-timers` + `list-units --failed` antes de mostrar dashboard +- SEMPRE alertar se algum timer crítico (observer-desk-alert, observer-tickets, backup) falhou ou está inactivo +- NUNCA repetir uma tentativa SSH falhada ao host `server` mais de uma vez na mesma sessão (risco de lockout CSF/LFD) +- NUNCA contornar um MCP desligado (ex: desk-crm-v3) — reportar e remeter para `/mcp` (regra 57 CLAUDE.md) --- @@ -256,28 +260,20 @@ Filename: `DD-MM-YYYY-checkup.md` (Regra #45: formato DD-MM-YYYY) | Componente | Tipo | Responsabilidade | |-----------|------|-----------------| -| `imap-triage` | Cron desktop (*/4h) | Triagem IMAP 13 contas + dedup Supabase | -| `auto-expense` | Cron desktop (15 */4h) | Criacao automatica de despesas | -| `ticket-triage` | Cron desktop (30 */4h) | Auto-process tickets (SPAM, facturas) | -| `aiktop-tasks` | Cron desktop (*/15min) | Executa tarefas AikTop do Desk CRM | -| `infra-check` | Cron desktop (07h) | Health check gateway + MCPs | -| `wp-update` | Cron desktop (seg 23h) | Actualizacoes WordPress 16 sites | -| `weekly-digest-podcast` | Cron desktop (quinta 20h) | Digest semanal para podcast | -| `improvement-evaluator` | Cron desktop (*/30min) | Avaliador de melhorias (HTTP @reboot) | -| `gitea-ci-cleaner` | Cron desktop (45 */4h) | Limpeza de runs CI Gitea | -| `daily-selector` | Cron desktop (06:30) | Selector ate 5 noticias/dia diversas → status=scheduled | -| `intelligence-publisher` | Cron desktop (5 slots 09/11/13/15:30/17:30) | Publica slots scheduled em descomplicar.pt | -| `intelligence-researcher` | Cron desktop (9/14/20) | Fetch 214 RSS → Supabase | -| `intelligence-scorer` | Cron desktop (0/30 min) | Score OpenRouter gpt-oss-20b | -| `HEARTBEAT WP` | Check ao vivo | `wp post list cat=1188` → idade do ultimo post. Alerta se >26h | -| `/daily-digest` | Skill (interactivo) | Timer, tickets, facturas, leads, agenda | -| `/tasks-overview` | Skill (interactivo) | Tarefas pendentes/overdue + workflows | +| `collector-gate-events` | systemd timer (*/5min) | Recolhe gate_events do Espelho/observer | +| `collector-hermes-jobs` | systemd timer (*/5min) | Recolhe jobs Hermes | +| `observer-ticket-queue` | systemd timer (*/5min) | Processa fila de divergências (Node) | +| `observer-tickets` | systemd timer (diário 09:30) | Processador de fila de tickets → Desk CRM | +| `observer-desk-alert` | systemd timer (diário 09:00) | Auto-ticket para divergências detectadas | +| `rclone-bisync` / `gdrive-sync` | systemd timer | Sync offsite (regra 3-2-1) — confirmar `enabled`/`active` | +| `okf-confianca` / `verify-gates-registry` / `stk-drift-check` | systemd timer (semanal) | Relatórios de qualidade/confiança OKF | +| `HEARTBEAT WP` | Check ao vivo | `wp post list cat=1188` via SSH → idade do ultimo post. Alerta se >26h ou SSH inacessível | +| `/daily-digest` | Skill (interactivo) | Timer, tickets, facturas, leads, agenda (requer desk-crm-v3) | +| `/tasks-overview` | Skill (interactivo) | Tarefas pendentes/overdue + workflows (desk-project-minimal) | | `/cleanup-downloads` | Skill (interactivo) | Limpeza pasta Transferencias | | `/spec` + `/sprint` | Scan local | Specs e sprints activos | -Repo agentes: `git.descomplicar.pt/ealmeida/claude_automations_dev` - - +Repo agentes: `git.descomplicar.pt/ealmeida/stack-observer` (código) — agendamento em `~/.config/systemd/user/*.timer`, não em crontab. --- @@ -293,8 +289,12 @@ Se encontrares um padrão relevante ao contexto actual, aplica o fix preventivam --- -*Skill v11.0.0 | 20-04-2026 | Descomplicar® — CT 102 eliminado, cron 100% local desktop* - +*Skill v12.0.0 | 06-07-2026 | Descomplicar® — arquitectura actualizada de crontab/claude_automations_dev (extinto) para systemd user timers `stack-observer`; memory-supabase substituído por mem0; alerta de lockout SSH ao host `server`* ## Healing Log + +```jsonl +{"date":"2026-07-06","issue":"Fase 1 apontava para claude_automations_dev/{imap-triage,auto-expense,ticket-triage,aiktop-tasks,infra-check,wp-update} — todos arquivados em z_arquivo/ desde a migração para Hermes cronjobs (05-05) e depois systemd stack-observer (~11-06). Logs nunca existiam, secção 'Agentes Cron' sempre vazia.","fix":"Ler estado via systemctl --user list-timers/list-units --failed + journalctl, não tail de logs em paths fixos que mudam a cada migração de arquitectura.","source":"user"} +{"date":"2026-07-06","issue":"skill referenciava mcp__memory-supabase (desactivado) para Fase 0/3.","fix":"Usar mem0 (mcp__mem0__search_memories / save_memory), store canónico actual por CLAUDE.md regra 28.","source":"user"} +```