LAT Runner
Executa tarefas de implementação aprovadas de .lat/tasks.yaml, normalmente iniciado por lat-dispatch.
Limites de Execução
- Apenas executa tarefas de implementação aprovadas. Não lida com revisão de especificações ou revisão de planos.
- Após processar a fila atual, encerra normalmente. Não cria processos em segundo plano ou ouvintes de longo prazo.
Fluxo de Processamento
- Lê
.lat/tasks.yaml. - Arquivo ausente, vazio ou
[]→ GeraNo pending tasks, sai com código0. - Falha na análise YAML → Segue o fluxo de tratamento de erros de análise conforme
references/yaml-schema.md. - Processa tarefas de cima para baixo, cada tarefa seguindo a checklist abaixo:
- [ ] Ler o goal, context e constraints da tarefa
- [ ] Se houver plan_file → ler o arquivo de plano, confirmar ordem das etapas
- [ ] Determinar se corresponde a habilidades de domínio disponíveis; carregar se corresponder
- [ ] Executar a implementação na ordem das etapas do plano (ou conforme o goal)
- [ ] Inserir resultado no topo de results.yaml (usando o mesmo task_id e agent_id)
- [ ] Remover esta tarefa de tasks.yaml
Regras complementares:
- Quando existe
context.plan_file, deve-se ler o plano primeiro e executar na ordem definida das etapas. Após cada etapa, o projeto deve ser executável. - Tarefas simples sem arquivo de plano: executar diretamente conforme o
goal. - O skill não pode ampliar o escopo da tarefa; em caso de conflito com
constraints, prevalecem asconstraints. - Remover tarefas processadas de
tasks.yaml(independentemente de concluídas, parciais ou falhas). Manter tarefas não processadas.
Estados de Resultado
| Estado | Significado |
|---|---|
completed | Objetivo da tarefa totalmente alcançado |
partial | Alcançado parcialmente; summary deve descrever o que foi e o que não foi concluído |
failed | Não concluído; errors deve conter pelo menos um objeto {code, message} |
Tarefas Subsequentes
- Apenas adicionar se a tarefa grande precisar ser dividida e o trabalho restante puder ser rastreado.
- Usar o mesmo
task_id(nome do arquivo Spec), incrementar o round deagent_id(ex.:code_executor_2_<task_id>,code_executor_3_<task_id>), e preenchercreated_bycom o identificador do agente atual. - Apenas tarefas de implementação; não adicionar tarefas de revisão.
Saída ao Finalizar
- Sem tarefas →
No pending tasks, código de saída0. - Com tarefas → Exibir contagens de cada estado (processed / completed / partial / failed) e lista de arquivos modificados.
- Após o processamento, não manter sessão zmx.
Observações
- Não pular ou reordenar as etapas do plano.
- Regras de escrita de resultados, ordem dos campos YAML, tratamento de estado vazio, e fluxo de backup de erros de análise conforme
references/yaml-schema.md.