NEXUS Background Worker

Resumo técnico

Worker de processamento de tarefas em segundo plano e filas do NEXUS: executa automaticamente tarefas simples (verificação HTTP e limpeza de log), avança tarefas complexas para in_progress e notifica a IA por e-mail com contexto completo (descrição, anexos, prioridade e token da API), via cron horário ou API.

Escopo executado

• plugin.json: v1.0.0, slug nexus-worker (legacy_slugs: ["worker"]), name "NEXUS Background Worker", categoria "Core", is_core: true, author_url e website públicos (perciocastelo.com.br).
• Sem tabelas próprias — opera sobre o schema de tasks/comments do core (sem DDL, sem migrations).
• Sem UI própria — sem tab.php; acesso via cron, API (run_worker) e doc ("Background Worker", ícone play).
• API: 1 action — run_worker (worker_run($task_id ?? null)), com task_id opcional.
• tasks_by_priority($status) — lê a fila via tasks_read(1, 999, "", ["status" => $status]).
• Auto-Exec (worker_try_autoexec) — tenta resolver a tarefa sozinho:

- Verificação HTTP: título com verificar|checar|check|ping|status http + URL na descrição → get_headers() e registro do código HTTP (ou timeout/erro); - Limpeza de Log: título com limpar log|clean log|purge log → mantém apenas as últimas 200 linhas do LOG_FILE; - Demais tarefas → ["auto" => false, "note" => "Requer execucao por IA."].

• build_task_context($task) — contexto formatado (TAREFA, ID, PROJETO, PRIORIDADE via priority_label, STATUS, DESCRIÇÃO, NOTAS ANTERIORES, ARQUIVOS ANEXADOS com original_name+url) + INSTRUÇÕES PARA A IA em 5 passos (acessar o dashboard SITE_URL, ler a tarefa e anexos, executar, comentar o resultado, mudar para done) + credenciais (API: SITE_URL/api.php, TOKEN: setting('security.api_key')).
• worker_run($task_id = null) — 2 modos:

- Manual: task_id específico, validando holding vazio e status pending/in_progress (erro "Tarefa nao disponivel.") — usado pelo botão "Executar Agora"; - Lote: toda a fila pending (erro "Nenhuma tarefa pendente." quando vazia). - Por tarefa: autoexec → task_update para done + nota [Worker YYYY-MM-DD HH:MM] <resultado> + comment_add("system", ...); complexa → task_update para in_progress + comentário "Execucao solicitada..." (próximo passo para a IA) + notify_task_ready_for_ia($task, $context).

• Cron — cronjob.json v1 com job worker_autoexec informativo (editable: false, tick: false, run.mode: none — a fila autoexec roda apenas no worker.php, nunca pelo botão "Rodar" do hub de cronjobs) + cron de SO **0 * * * *** (a cada hora).
• Sem fastr, sem modals, sem assets JS e sem i18n própria.

Stack e ferramentas

• PHP 8 (sem framework)
• MySQL 8 (tasks/comments do core)
• cURL / get_headers (verificação HTTP)
• Cron de SO + Plugin NEXUS (PluginManager: API actions, doc)

Tags operacionais

• Background Tasks
• Worker
• Queue
• Automação
• Verificação HTTP
• Notificação IA
• Cron
• Plugin NEXUS

Resultado operacional

• Filas processadas sem intervenção: tarefas pendentes são avaliadas a cada hora (cron) ou sob demanda (API).
• Tarefas simples resolvidas na hora: verificação de disponibilidade HTTP (status code) e limpeza de log com retenção das últimas 200 linhas.
• Tarefas complexas escaladas para IA: contexto completo (descrição, anexos, prioridade, token da API) enviado por e-mail com instruções passo a passo.
• Rastreabilidade total: cada execução gera comentário system na tarefa com a nota do resultado e o carimbo de data/hora do worker.
• Execução seletiva: task_id na API permite disparar o worker para uma tarefa específica (botão "Executar Agora") sem processar a fila inteira.
• Sem risco de dupla execução: holding vazio + status pending/in_progress são pré-requisitos para o modo manual.
• Job de cron do hub é informativo (run.mode: none) — o processamento acontece exclusivamente no worker.php.