@onion-ai/cli 1.0.0-beta.1

package/framework/commands/docs/reverse-consolidate.md

@@ -0,0 +1,158 @@
+---
+name: reverse-consolidate
+description: |
+  Engenharia reversa de projetos para gerar documentação consolidada.
+  Use como pré-processador para /docs/build-tech-docs.
+model: sonnet
+
+parameters:
+  - name: project_path
+    description: Caminho para o projeto a ser analisado
+    required: true
+  - name: output_path
+    description: Onde salvar documentação (default: docs/reverse/)
+    required: false
+
+category: docs
+tags:
+  - reverse-engineering
+  - documentation
+  - analysis
+
+version: "3.0.0"
+updated: "2025-11-24"
+
+related_commands:
+  - /docs/build-tech-docs
+  - /docs/build-business-docs
+
+related_agents:
+  - docs-reverse-engineer
+  - system-documentation-orchestrator
+---
+
+# 🔍 Engenharia Reversa de Projetos
+
+Orquestrador de engenharia reversa para gerar documentação consolidada.
+
+## 🎯 Objetivo
+
+Analisar qualquer projeto e gerar documento consolidado para `/docs/build-tech-docs`.
+
+## ⚡ Fluxo de Execução
+
+### Passo 1: Validar Input
+
+```bash
+# Verificar path existe
+test -d "{{project_path}}" || { echo "❌ Path não existe"; exit 1; }
+
+# Verificar é projeto de software
+ls "{{project_path}}"/*.json "{{project_path}}"/*.yaml 2>/dev/null || \
+  echo "⚠️ Arquivos de config não detectados"
+```
+
+### Passo 2: Detectar Stack
+
+```bash
+# Package managers
+test -f package.json && STACK="javascript"
+test -f requirements.txt && STACK="python"
+test -f Cargo.toml && STACK="rust"
+test -f go.mod && STACK="go"
+
+# Frameworks
+grep -q "react" package.json && FRAMEWORK="react"
+grep -q "fastify" package.json && FRAMEWORK="fastify"
+grep -q "nx" package.json && MONOREPO="nx"
+```
+
+### Passo 3: Analisar Estrutura
+
+Delegar para @docs-reverse-engineer:
+
+1. **Directory Scan**
+   - Estrutura de pastas
+   - Padrões de arquivos
+   - Convenções de naming
+
+2. **Dependency Analysis**
+   - Dependências principais
+   - DevDependencies
+   - Peer dependencies
+
+3. **Architecture Detection**
+   - Padrões (MVC, DDD, Clean)
+   - Camadas identificadas
+   - Pontos de integração
+
+### Passo 4: Gerar Documento
+
+Criar `{{output_path}}/consolidated.md`:
+
+```markdown
+# Documentação Consolidada: [Nome do Projeto]
+
+## 📊 Metadados
+- Stack: [stack detectado]
+- Framework: [framework]
+- Monorepo: [sim/não]
+- Tamanho: [arquivos/linhas]
+
+## 🏗️ Arquitetura
+[Descrição da arquitetura detectada]
+
+## 📁 Estrutura
+[Árvore de diretórios comentada]
+
+## 🔧 Componentes Principais
+[Lista de módulos/componentes]
+
+## 🔗 Integrações
+[APIs, databases, serviços externos]
+
+## 📋 Recomendações
+[Sugestões para documentação adicional]
+```
+
+### Passo 5: Finalizar
+
+## 📤 Output Esperado
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ ANÁLISE CONCLUÍDA
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📊 Projeto: {{project_path}}
+
+🔍 Stack Detectado:
+∟ Linguagem: TypeScript
+∟ Framework: React + Fastify
+∟ Monorepo: NX
+∟ Arquitetura: Clean Architecture
+
+📁 Arquivos Gerados:
+∟ docs/reverse/consolidated.md
+∟ docs/reverse/structure.json
+∟ docs/reverse/dependencies.json
+
+📈 Métricas:
+∟ Arquivos analisados: 245
+∟ Linhas de código: 12,450
+∟ Módulos: 18
+
+🚀 Próximo: /docs/build-tech-docs
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## 🔗 Referências
+
+- Agente: @docs-reverse-engineer
+- Próximo passo: /docs/build-tech-docs
+
+## ⚠️ Notas
+
+- Tempo médio: 2-5 minutos dependendo do tamanho
+- Funciona com JavaScript, Python, Rust, Go
+- Output otimizado para consumo por IA

package/framework/commands/docs/sync-sessions.md

@@ -0,0 +1,354 @@
+---
+name: sync-sessions
+description: Sincronizar e organizar sessões de trabalho do Sistema Onion.
+model: sonnet
+category: docs
+tags: [sessions, sync, organization]
+version: '3.0.0'
+updated: '2025-11-24'
+---
+
+# 🔄 Sync Sessions - Sincronização de Sessões Onion
+
+Sincroniza e organiza todas as sessões de trabalho do Sistema Onion, garantindo que o contexto de desenvolvimento esteja preservado e acessível para referência futura.
+
+## 🎯 Objetivo
+
+Este comando analisa o trabalho realizado na sessão atual, organiza a documentação gerada e sincroniza com a estrutura `.claude/sessions/`, mantendo um histórico organizado de todas as atividades de desenvolvimento.
+
+## 🎯 Funcionalidades
+
+### Organização de Sessões
+
+- Detecta o trabalho realizado na sessão atual
+- Cria estrutura organizada por data e tópico
+- Preserva contexto e decisões tomadas
+- Gera índice navegável de sessões
+
+### Sincronização Automática
+
+- Identifica arquivos criados/modificados
+- Captura comandos Onion executados
+- Preserva interações e decisões
+- Mantém histórico de mudanças
+
+### Validação e Integridade
+
+- Verifica completude da documentação da sessão
+- Valida estrutura de diretórios
+- Identifica sessões incompletas
+- Sugere melhorias na organização
+
+## 🚀 Como Usar
+
+```bash
+# Sincronizar sessão atual
+/docs/sync-sessions
+
+# Sincronizar com nome customizado
+/docs/sync-sessions "implementacao-feature-x"
+
+# Sincronizar e arquivar sessão
+/docs/sync-sessions --archive
+
+# Apenas validar sem sincronizar
+/docs/sync-sessions --validate-only
+```
+
+## 📋 Processo Executado
+
+### 1. **Análise da Sessão Atual**
+
+- Identifica data/hora de início
+- Lista arquivos criados/modificados
+- Captura comandos executados
+- Extrai decisões e contexto
+
+### 2. **Estruturação**
+
+```
+.claude/sessions/
+└── YYYY-MM-DD_HHMM_topic-name/
+    ├── README.md              # Resumo da sessão
+    ├── context.md             # Contexto inicial
+    ├── decisions.md           # Decisões tomadas
+    ├── changes.md             # Mudanças realizadas
+    ├── notes.md               # Notas e observações
+    ├── files-changed.txt      # Lista de arquivos
+    └── commands-executed.txt  # Comandos usados
+```
+
+### 3. **Geração de Documentação**
+
+- **README.md**: Resumo executivo da sessão
+- **context.md**: Contexto e motivação
+- **decisions.md**: Decisões arquiteturais e técnicas
+- **changes.md**: Log detalhado de mudanças
+- **notes.md**: Anotações e insights
+
+### 4. **Sincronização**
+
+- Move/copia arquivos para estrutura correta
+- Atualiza índice de sessões
+- Gera links de navegação
+- Valida integridade
+
+## 📁 Estrutura de Sessão
+
+### README.md
+
+```markdown
+# [Topic Name] - [Date]
+
+## 🎯 Objetivo
+
+[Descrição do objetivo da sessão]
+
+## 📊 Resultados
+
+- [Lista de entregas]
+- [Arquivos criados/modificados]
+
+## 🔗 Links Relacionados
+
+- [Documentação relacionada]
+- [Issues/PRs relacionados]
+
+## ⏱️ Tempo Investido
+
+[Duração aproximada]
+```
+
+### context.md
+
+```markdown
+# Contexto - [Topic]
+
+## Situação Inicial
+
+[Estado do projeto antes da sessão]
+
+## Motivação
+
+[Por que este trabalho foi necessário]
+
+## Restrições
+
+[Limitações técnicas, tempo, recursos]
+
+## Referências
+
+[Links, documentos, discussões relevantes]
+```
+
+### decisions.md
+
+```markdown
+# Decisões Tomadas - [Topic]
+
+## Decisão 1: [Título]
+
+- **Contexto**: [Por que esta decisão foi necessária]
+- **Opções Consideradas**:
+  - Opção A: [Prós/Contras]
+  - Opção B: [Prós/Contras]
+- **Decisão**: [Opção escolhida]
+- **Justificativa**: [Razões]
+- **Impacto**: [Consequências]
+
+## Decisão 2: [Título]
+
+[...]
+```
+
+### changes.md
+
+```markdown
+# Mudanças Realizadas - [Topic]
+
+## Arquivos Criados
+
+- `path/to/file1.ts` - [Descrição]
+- `path/to/file2.md` - [Descrição]
+
+## Arquivos Modificados
+
+- `path/to/existing.ts`
+  - [Descrição da mudança]
+  - [Linhas afetadas]
+
+## Comandos Executados
+
+1. `/docs/build-tech-docs` - [Resultado]
+2. `/git/create-branch` - [Branch criada]
+
+## Testes Adicionados
+
+- [Lista de testes criados]
+```
+
+## 🤖 Integração com Agentes
+
+Este comando convoca automaticamente:
+
+- **@branch-documentation-writer**: Gera documentação estruturada
+- **@metaspec-gate-keeper**: Valida conformidade com padrões
+- **@gitflow-specialist**: Auxilia em questões Git se necessário
+
+## ⚙️ Opções Avançadas
+
+### Flags Disponíveis
+
+```bash
+--archive          # Move sessão para archived/
+--validate-only    # Apenas valida sem sincronizar
+--force           # Força sincronização mesmo com erros
+--skip-git        # Não inclui informações Git
+--detailed        # Gera relatório detalhado
+```
+
+### Exemplos Avançados
+
+```bash
+# Sincronizar e arquivar sessão antiga
+/docs/sync-sessions "refactoring-api" --archive
+
+# Validar integridade sem modificar
+/docs/sync-sessions --validate-only
+
+# Sincronização forçada com relatório detalhado
+/docs/sync-sessions --force --detailed
+```
+
+## 📊 Métricas Capturadas
+
+O comando captura automaticamente:
+
+- **Arquivos**: Criados, modificados, deletados
+- **Linhas de Código**: Adicionadas, removidas
+- **Comandos**: Onion executados
+- **Tempo**: Duração aproximada da sessão
+- **Agentes**: AI agents convocados
+- **Commits**: Git commits relacionados (se aplicável)
+
+## ⚠️ Resolução de Problemas
+
+### **Problema 1: Sessão já existe**
+
+- **Sintoma**: Erro "Session directory already exists"
+- **Solução**: Use flag `--force` ou renomeie a sessão
+
+### **Problema 2: Arquivos não detectados**
+
+- **Sintoma**: Lista de arquivos incompleta
+- **Causa**: Arquivos fora do workspace ou gitignored
+- **Fix**: Verifique `.gitignore` e workspace boundaries
+
+### **Problema 3: Contexto insuficiente**
+
+- **Sintoma**: README.md com pouca informação
+- **Solução**: Execute comandos Onion com mais contexto antes de sincronizar
+
+## 🔍 Validações Realizadas
+
+O comando valida:
+
+- ✅ Estrutura de diretórios correta
+- ✅ Todos os arquivos markdown obrigatórios presentes
+- ✅ README.md com seções mínimas
+- ✅ Links internos funcionando
+- ✅ Sem duplicação de sessões
+- ✅ Índice de sessões atualizado
+
+## 📈 Output Esperado
+
+```bash
+🔄 Sincronizando Sessão Onion...
+
+📊 Análise da Sessão:
+  • Tópico: implementação-dashboard-operacoes
+  • Data: 2025-10-03 10:30
+  • Arquivos Criados: 15
+  • Arquivos Modificados: 8
+  • Comandos Executados: 5
+  • Agentes Convocados: 3
+
+📁 Estrutura Criada:
+  ✅ .claude/sessions/2025-10-03_1030_dashboard-operacoes/
+     ✅ README.md
+     ✅ context.md
+     ✅ decisions.md
+     ✅ changes.md
+     ✅ notes.md
+     ✅ files-changed.txt
+     ✅ commands-executed.txt
+
+🔗 Índice Atualizado:
+  ✅ .claude/sessions/INDEX.md
+
+✅ Sessão sincronizada com sucesso!
+
+📚 Para revisar:
+   cat .claude/sessions/2025-10-03_1030_dashboard-operacoes/README.md
+```
+
+## 🎯 Casos de Uso
+
+### Caso 1: Fim de Sessão de Desenvolvimento
+
+```bash
+# Ao terminar trabalho do dia
+/docs/sync-sessions "refactoring-contracts-module"
+```
+
+### Caso 2: Antes de Trocar de Branch
+
+```bash
+# Preservar contexto antes de mudar de tarefa
+/docs/sync-sessions --detailed
+git checkout other-branch
+```
+
+### Caso 3: Auditoria de Trabalho Realizado
+
+```bash
+# Gerar relatório completo da sessão
+/docs/sync-sessions --validate-only --detailed
+```
+
+### Caso 4: Arquivar Trabalho Concluído
+
+```bash
+# Mover sessão para archived após merge
+/docs/sync-sessions "feature-x-completed" --archive
+```
+
+## 🔗 Comandos Relacionados
+
+- `/docs/build-index` - Reconstrói índice de documentação
+- `/docs/docs-health` - Verifica saúde da documentação
+- `/docs/validate-docs` - Valida completude
+- `/git/help` - Ajuda com Git workflows
+
+## 📝 Notas Importantes
+
+1. **Frequência**: Execute ao final de cada sessão significativa de trabalho
+2. **Contexto**: Quanto mais contexto fornecer, melhor a documentação gerada
+3. **Consistência**: Manter padrão de nomenclatura ajuda na navegação
+4. **Limpeza**: Arquive sessões antigas periodicamente para manter organização
+
+## 🎓 Best Practices
+
+1. **Nomeie Sessions Descritivamente**: Use nomes que descrevam claramente o trabalho
+2. **Documente Decisões**: Capture o "porquê" das decisões, não apenas o "o quê"
+3. **Preserve Contexto**: Inclua links para issues, PRs, discussões relevantes
+4. **Seja Consistente**: Use padrões consistentes de nomenclatura
+5. **Arquive Regularmente**: Mova sessões antigas para `archived/` periodicamente
+
+---
+
+**Agente Responsável**: @branch-documentation-writer  
+**Validador**: @metaspec-gate-keeper  
+**Categoria**: Documentação / Organização  
+**Prioridade**: Média  
+**Última Atualização**: Outubro 2025

package/framework/commands/docs/validate-docs.md

@@ -0,0 +1,157 @@
+---
+name: validate-docs
+description: |
+  Validação de completude e consistência da documentação.
+  Use para verificar estrutura, links e padrões.
+model: sonnet
+
+parameters:
+  - name: path
+    description: Caminho para validar (default: docs/)
+    required: false
+    default: docs/
+  - name: fix
+    description: Corrigir problemas automaticamente
+    required: false
+    default: "false"
+
+category: docs
+tags:
+  - validation
+  - documentation
+  - quality
+
+version: "3.0.0"
+updated: "2025-11-24"
+
+related_commands:
+  - /docs/docs-health
+  - /docs/build-tech-docs
+
+related_agents:
+  - system-documentation-orchestrator
+---
+
+# ✅ Validar Documentação
+
+Validação abrangente de estrutura e qualidade de docs.
+
+## 🎯 Objetivo
+
+Verificar completude, consistência e padrões da documentação.
+
+## ⚡ Fluxo de Execução
+
+### Passo 1: Validar Estrutura
+
+```bash
+# Arquivos obrigatórios
+REQUIRED=(README.md CHANGELOG.md)
+for f in "${REQUIRED[@]}"; do
+  test -f "$f" && echo "✅ $f" || echo "❌ $f ausente"
+done
+
+# Hierarquia de diretórios
+ls -la {{path}}/
+```
+
+#### Checklist de Estrutura
+
+- [ ] `README.md` na raiz
+- [ ] `docs/` com índice
+- [ ] Naming em kebab-case
+- [ ] Extensão `.md`
+
+### Passo 2: Validar Conteúdo
+
+#### Verificações por Arquivo
+
+```bash
+for f in $(find {{path}} -name "*.md"); do
+  # Header presente
+  head -1 "$f" | grep -q "^#" || echo "⚠️ $f: sem header"
+  
+  # Linhas mínimas
+  [ $(wc -l < "$f") -lt 10 ] && echo "⚠️ $f: muito curto"
+done
+```
+
+#### Seções Obrigatórias
+
+| Tipo de Doc | Seções Requeridas |
+|-------------|-------------------|
+| README | Objetivo, Uso, Instalação |
+| API | Endpoints, Exemplos |
+| Guide | Pré-requisitos, Steps |
+| Spec | Objetivo, Requisitos |
+
+### Passo 3: Validar Links
+
+```bash
+# Links internos
+grep -roh '\[.*\](.*\.md)' {{path}}/ | \
+  sed 's/.*(\(.*\))/\1/' | \
+  while read link; do
+    test -f "$link" || echo "❌ Link quebrado: $link"
+  done
+```
+
+### Passo 4: Gerar Relatório
+
+## 📤 Output Esperado
+
+### Sem Erros
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ VALIDAÇÃO CONCLUÍDA
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📊 Resumo:
+∟ Arquivos: 45
+∟ Erros: 0
+∟ Avisos: 3
+
+✅ Estrutura: OK
+✅ Conteúdo: OK
+✅ Links: OK
+
+⚠️ Avisos:
+∟ 3 arquivos sem update >30d
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+### Com Erros
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+❌ ERROS ENCONTRADOS
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📊 Resumo:
+∟ Arquivos: 45
+∟ Erros: 5
+∟ Avisos: 8
+
+❌ Erros:
+∟ docs/api.md: link quebrado (line 45)
+∟ docs/guide.md: sem header
+∟ README.md: seção "Uso" ausente
+
+⚠️ Avisos:
+∟ 8 arquivos muito curtos (<50 linhas)
+
+💡 Para corrigir: /docs/validate-docs fix="true"
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## 🔗 Referências
+
+- Health check: /docs/docs-health
+- Agente: @system-documentation-orchestrator
+
+## ⚠️ Notas
+
+- Executar antes de releases
+- `fix="true"` corrige apenas formatação
+- Links quebrados requerem correção manual

package/framework/commands/engineer/bump.md

@@ -0,0 +1,29 @@
+---
+name: bump
+description: Bump de versão seguindo semver. Incrementa major, minor ou patch.
+model: sonnet
+category: engineer
+tags: [version, release, semver]
+version: "3.0.0"
+updated: "2025-11-24"
+---
+
+Vamos preparar isso para um release aumentando o número da versão.
+
+Siga estas regras para versionamento x.y.z:
+
+- x (Versão major): Incremente quando você fizer mudanças incompatíveis na API ou funcionalidade. Exemplos incluem:
+Mudanças que quebram APIs públicas (ex.: remover ou renomear métodos).
+Reescritas majors ou refatoração que alteram comportamento.
+Mudanças que requerem que usuários atualizem seu código ou dependências para manter compatibilidade.
+- y (Versão minor): Incremente quando você adicionar novas funcionalidades ou melhorias de forma retrocompatível. Exemplos incluem:
+Adicionando novos métodos, endpoints, ou funcionalidades.
+Depreciar funcionalidades (mas não removê-las ainda).
+Melhorias que não quebram funcionalidades existentes.
+- z (Versão patch): Incremente quando você fizer correções de bugs retrocompatíveis ou pequenas atualizações. Exemplos incluem:
+Corrigir bugs sem alterar funcionalidade pretendida.
+Pequenas melhorias de performance.
+Atualizações de documentação ou mudanças de metadata.
+
+Altere a versão no pyproject.toml.
+Então, execute `uv sync --all-extras` para regenerar o lock file. 

package/framework/commands/engineer/docs.md

@@ -0,0 +1,11 @@
+---
+name: docs
+description: Invocar agente de documentação para branch atual.
+model: sonnet
+category: engineer
+tags: [documentation, branch]
+version: "3.0.0"
+updated: "2025-11-24"
+---
+
+Por favor, invoque o agente branch-documentation-writer