franalgaba/grimoire

O que grimoire faz?

Instala e opera Grimoire, cria arquivos .spell com cobertura total de sintaxe (incluindo lógica de decisão consultiva) e executa compile/validate/simulate/cast com segurança. Use quando os usuários pedirem para criar, editar, depurar, validar, simular, executar ou explicar estratégias Grimoire.

Funcionalidades

• Criação de .spell: Gera arquivos de estratégia usando sintaxe completa do Grimoire.
• Compilação: Valida a sintaxe do arquivo .spell com grimoire compile.
• Validação: Verifica a lógica e viabilidade com grimoire validate.
• Simulação: Testa a execução em ambiente isolado com grimoire simulate.
• Execução: Aplica a estratégia com grimoire cast.
• Lógica Consultiva: Suporte a ask para decisões que exigem aprovação humana.

Como Usar

1. Instalação (se necessário):

   curl -fsSL https://raw.githubusercontent.com/franalgaba/grimoire/main/install.sh | bash
   

2. Criar um arquivo .spell:

   grimoire new minha-estrategia.spell
   

3. Compilar e Validar:

   grimoire compile minha-estrategia.spell
   grimoire validate minha-estrategia.spell
   

4. Simular:

   grimoire simulate minha-estrategia.spell
   

5. Executar:

   grimoire cast minha-estrategia.spell
   

Exemplo de .spell com Lógica Consultiva

name: "Exemplo com Decisão"
version: 1

steps:
  - ask: "Deseja prosseguir com o deploy para produção?"
    if: response == "sim"
    then:
      - run: "deploy.sh"
    else:
      - run: "cancel.sh"

Observações

• Sempre use compile e validate antes de cast para evitar erros.
• A lógica consultiva (ask) é ideal para workflows que exigem supervisão.
• Consulte a documentação oficial para sintaxe avançada.