chatin-cli

CLI, Harness Engine e Dashboard de Orquestração SDD com Roteamento Inteligente LLM via OpenRouter e React Ink TUI em Node.js.

Roteia cada etapa do fluxo Forge-SDD (spec, plan, tasks, implement) e comandos oficiais (/discovery, /nova-feature, /novo-fix, /constitution, /status, /revisar, /archive) para o modelo LLM mais adequado, grava os artefatos diretamente no repositório, registra o custo real de cada chamada no SQLite e exibe uma TUI fluida em React Ink.

🚀 Instalação Nativa via NPM

Opção 1: Instalação Global via NPM (Recomendado)

npm install -g chatin-cli

Opção 2: Execução Instantânea (Zero-Install via npx)

npx chatin-cli

Verifique a instalação:

chatin --version
# 0.5.0

🌐 Autenticação OpenRouter (OAuth de 1 Clique ou API Key)

O chatin-cli inclui autenticação nativa via OAuth no navegador:

1. Abra o chatin no terminal.
2. Se nenhuma chave for encontrada, o modal 🔑 Conectar com OpenRouter abre automaticamente.
3. Clique em [ 🌐 Conectar via OAuth (Navegador) ] para autorizar sua conta sem precisar copiar e colar API Keys. A credencial é salva com segurança em ~/.chatin/config.json.

(Opcional: Você também pode definir manualmente export OPENROUTER_API_KEY="sk-or-v1-...").

⚙️ Harness Engine & Comandos do Forge-SDD

O chatin-cli atua como o Harness Engine do Forge-SDD. Ao executar qualquer comando no Orquestrador, ele:

• Carrega o Prompt Oficial: Executa a especificação do comando correspondente em .gemini/prompts/*.prompt.md ou sdd/prompts/.
• Injeta o Contexto do Projeto: Inclui automaticamente a Constituição (constitution.md), Progresso Ativo (progress.md), Lições Aprendidas (lessons.md) e Diretrizes do Agente (.gemini/skills/).
• Grava Artefatos no Disco: Captura a saída gerada pela IA e salva os arquivos no repositório (sdd/discovery/, sdd/spec/, sdd/plan/, sdd/features/).

Comandos Suportados no REPL TUI:

• /discovery <ideia>: Inicia sessão de discovery de produto/engenharia e gera documentos em sdd/discovery/.
• /nova-feature <nome>: Especifica uma nova feature em sdd/spec/feat-*.md.
• /novo-fix <descrição>: Registra e especifica a correção de um bug.
• /status: Analisa e informa o progresso ativo do projeto.
• /constitution: Alinha e verifica as diretrizes arquiteturais.
• /revisar: Valida os critérios de aceite e tarefas.
• /archive: Arquiva históricos em progress-log.md mantendo progress.md enxuto.
• /sdd <etapa> <feature>: Executa etapas específicas (spec, plan, tasks, implement).

💻 Interface TUI (React Ink)

Ao rodar chatin ou chatin-cli, a interface no terminal oferece 5 abas interativas:

• Dashboard: Custos em dólares e contagem de tokens por modelo LLM.
• Orquestrador: REPL com destaque do prompt enviado (>) em cyan, sugestões de autocomplete popup ao digitar / e renderização em Markdown.
• Modelos: Configuração de modelos por etapa.
• MCP: Gerenciador e teste de servidores MCP.
• Agentes: Visualizador Master-Detail dos 7 papéis especialistas do Forge-SDD.

🛠️ Desenvolvimento e Testes

# Instalar dependências
npm install

# Compilar projeto TypeScript
npm run build

# Executar testes unitários (Vitest)
npm run test

# Vincular binários locais (chatin e chatin-cli)
npm link --force