hearting

Hearting (anteriormente denominado agent_setting) é uma camada de fluxo de trabalho local-first para agentes de programação. Ao invés de configurar um único tempo de execução, ele define contratos compartilhados uma única vez e os projeta nas superfícies nativas de habilidade, agente, gancho, modo e comando que o Claude Code, Codex e OpenCode descobrem individualmente. O objetivo declarado é levar pesquisa, planejamento, implementação e verificação através de um ciclo consistente em todos os três. Mecanismos principais descritos no README: - Capacidades roteadas: 12 roteadores de entrada sobre 26 capacidades. Antes do trabalho substancial, o agente propõe um cartão de rota com cinco campos (tarefa, razão, rota, escopo, conclusão) para aprovação. - Escada de intensidade: níveis direto, rápido, padrão, forte, completo e adversarial selecionam o grafo da etapa e profundidade de despacho; a rigorosidade da verificação deriva da intensidade. - Despacho cruzado selado: a partir do padrão e acima, cada etapa é executada como uma sessão separadamente iniciada com um papel selado, perfil de modelo e escopo de gravação disjunto. Grupos paralelos de 2-4 pernas começam em uma transação, e pernas se espalham pelas famílias de harneses por padrão. Profundidade de despacho 3 é proibida. - Níveis de modelo por nó: profundo, equilibrado-profundo, leve e mini são selados por nó em tempo de compilação; adaptadores mapeiam-nos para modelos concretos sem nomear fornecedores nos contratos compartilhados. - Fleet: um painel ao vivo sobre o registro de tentativas mostrando sessões interativas e trabalhadores despachados de todos os três tempos de execução em uma árvore única, com estado, harnês, perfil selado, medidor de contexto e contabilidade de tokens. `fleet --once` e `fleet --json` funcionam sem curses. - Guardiões: 39 ganchos, 5 deles bloqueios rígidos, negando escopos de gravação, leitura de especificações, raiz de artefato, violações de estado git e caminho de memória antes da chamada da ferramenta. - Sistema de artefatos: pesquisa/análise de projeto até especificação até planos para código, e pesquisa até rascunho até refinamento para documentos, sob uma raiz .agent_reports/ global do projeto. - Memória: SQLite com FTS5 através de sessões, projetos e tempos de execução; decisões alteradas são substituídas em vez de excluídas. A instalação é feita por meio de um script de lançamento de uma linha que instala um arquivo com verificação de integridade e registra uma verificação diária de atualização no nível do usuário quando suportado. O instalador não toca credenciais de tempo de execução, sessões, logs ou bancos de dados. Quando o Codex está presente, também instala um ingresso protegido reversível para que comandos interativos do codex entrem no servidor de aplicativo gerenciado pelo harnês, enquanto comandos não interativos passam através para a CLI real. `hearting update` prepara e verifica uma nova versão antes de alternar o ponteiro ativo e faz rollback em caso de falha. Um launcher de operador `compute-hosts` lê uma configuração YAML de propriedade do usuário, semeada uma vez como um modelo comentado. O suporte ao tempo de execução cobre Claude Code, Codex e OpenCode tanto em modo de projeção vinculado (debug em tempo real) quanto empacotado (pacote imutável). Superfícies não suportadas são marcadas como SKIP com uma razão. Fluxos de desenvolvimento incluem um único ponto de entrada gerar/checar, testes de drift de projeção gerada e ganchos Git do repositório que executam as mesmas verificações que o CI. A documentação cobre uso, layout de instalação, política de lançamento, capacidades, papéis, roteamento, operações, memória e ganchos. Licenciado sob MIT.