@onion-architect-ai/cli 4.1.0-beta.1 → 4.1.0-beta.2

package/templates/.cursor/commands/common/prompts/validation-rules.md

@@ -0,0 +1,173 @@
+# Regras de Validação
+
+## ✅ Validação de Inputs
+
+### Parâmetros Obrigatórios
+
+```markdown
+SE parâmetro NÃO fornecido:
+  → Perguntar ao usuário
+  → NÃO assumir valores
+  → NÃO prosseguir sem confirmação
+```
+
+### Formato de Parâmetros
+
+| Tipo | Formato | Exemplo |
+|------|---------|---------|
+| feature-slug | kebab-case | `user-authentication` |
+| task-id | alfanumérico | `86adf8jj6` |
+| branch-name | kebab-case | `feature/user-auth` |
+| version | semver | `1.2.3` |
+| date | ISO | `2025-11-24` |
+
+### Validação de Paths
+
+```markdown
+✅ Válido: /home/user/project/file.md
+✅ Válido: ./relative/path/file.md
+❌ Inválido: file.md (sem contexto)
+❌ Inválido: ~/path (expandir primeiro)
+```
+
+---
+
+## 🔍 Validação de Estado
+
+### Pré-condições Comuns
+
+```markdown
+### Verificar Antes de Executar
+
+1. **Workspace válido**
+   - [ ] .cursor/ existe
+   - [ ] É projeto Onion
+
+2. **Git limpo** (se necessário)
+   - [ ] Sem alterações não commitadas
+   - [ ] Branch correta
+
+3. **Dependências** (se necessário)
+   - [ ] Node modules instalados
+   - [ ] Ambiente configurado
+```
+
+### Verificação de Arquivos
+
+```bash
+# Arquivo existe
+test -f "$FILE" && echo "✅ Existe" || echo "❌ Não existe"
+
+# Diretório existe
+test -d "$DIR" && echo "✅ Existe" || echo "❌ Não existe"
+
+# Arquivo não vazio
+test -s "$FILE" && echo "✅ Tem conteúdo" || echo "⚠️ Vazio"
+```
+
+---
+
+## 🚫 Tratamento de Erros
+
+### Níveis de Erro
+
+| Nível | Ação | Exemplo |
+|-------|------|---------|
+| **Fatal** | Abortar | Arquivo crítico ausente |
+| **Erro** | Perguntar | Parâmetro inválido |
+| **Aviso** | Informar | Valor não otimal |
+| **Info** | Logar | Status informativo |
+
+### Formato de Erro
+
+```markdown
+❌ **Erro**: [Descrição clara]
+
+**Causa**: [O que causou]
+**Solução**: [Como resolver]
+
+Exemplo:
+❌ **Erro**: Arquivo de sessão não encontrado
+
+**Causa**: Sessão 'my-feature' não existe em .cursor/sessions/
+**Solução**: Execute `/engineer/start my-feature` primeiro
+```
+
+### Fallback Strategy
+
+```markdown
+SE erro recuperável:
+  1. Tentar recuperação automática
+  2. SE falhar → Perguntar ao usuário
+  3. SE usuário não disponível → Abortar com instruções
+
+SE erro fatal:
+  1. Logar erro detalhado
+  2. Abortar imediatamente
+  3. Sugerir correção
+```
+
+---
+
+## 📋 Validação de Outputs
+
+### Checklist de Output
+
+```markdown
+- [ ] Output corresponde ao esperado
+- [ ] Formato consistente
+- [ ] Sem dados sensíveis expostos
+- [ ] Acionável pelo usuário
+```
+
+### Formato de Sucesso
+
+```markdown
+✅ **Sucesso**: [Descrição]
+
+📁 Arquivos criados/modificados:
+∟ path/to/file1.md
+∟ path/to/file2.md
+
+🚀 Próximos passos:
+∟ Ação 1
+∟ Ação 2
+```
+
+---
+
+## 🔐 Validação de Segurança
+
+### Nunca Expor
+
+- [ ] API keys/tokens
+- [ ] Senhas
+- [ ] Dados pessoais
+- [ ] Paths absolutos sensíveis
+
+### Sanitização
+
+```markdown
+# Antes de logar/exibir:
+- Mascarar tokens: pk_xxx...xxx
+- Remover credenciais de URLs
+- Anonimizar dados pessoais
+```
+
+---
+
+## ⚡ Validação Rápida
+
+### One-liners
+
+```bash
+# Validar YAML
+head -1 file.md | grep -q "^---$" && echo "✅ YAML"
+
+# Validar kebab-case
+echo "$VAR" | grep -qE "^[a-z0-9]+(-[a-z0-9]+)*$" && echo "✅"
+
+# Validar semver
+echo "$VERSION" | grep -qE "^[0-9]+\.[0-9]+\.[0-9]+$" && echo "✅"
+```
+

package/templates/.cursor/commands/common/templates/abstraction-template.md

@@ -0,0 +1,400 @@
+# 🏗️ Template: Abstraction Layer (SDAAL)
+
+Este template define a estrutura padrão para camadas de abstração seguindo o padrão **Specification-Driven AI Abstraction Layer**.
+
+---
+
+## 📁 Estrutura de Arquivos
+
+```
+.cursor/utils/{{abstraction_name}}/
+├── README.md           # Visão geral + uso rápido
+├── interface.md        # Contrato principal
+├── types.md            # Tipos de entrada/saída
+├── factory.md          # Criação de instâncias
+├── detector.md         # Detecção de provedor
+└── adapters/
+    ├── {{provider}}.md # Um por provedor
+    └── none.md         # Fallback obrigatório
+```
+
+---
+
+## 📝 README.md Template
+
+```markdown
+# 🔌 {{InterfaceName}} - Abstraction Layer
+
+## 🎯 Propósito
+
+[Descrição do que a abstração faz]
+
+## 📁 Estrutura
+
+\`\`\`
+{{abstraction_name}}/
+├── README.md
+├── interface.md
+├── types.md
+├── detector.md
+├── factory.md
+└── adapters/
+    ├── [providers].md
+    └── none.md
+\`\`\`
+
+## ⚡ Uso Rápido
+
+### 1. Configurar Provedor
+
+\`\`\`bash
+{{ENV_PREFIX}}_PROVIDER=[provider]
+\`\`\`
+
+### 2. Usar nos Comandos
+
+\`\`\`typescript
+const manager = get{{ManagerName}}();
+await manager.operation({ ... });
+\`\`\`
+
+## 🔧 Provedores Suportados
+
+| Provedor | Status | Notas |
+|----------|--------|-------|
+| [provider] | ✅/📝 | [notas] |
+| None | ✅ | Modo offline |
+
+---
+
+**Versão**: 1.0.0
+**Criado em**: YYYY-MM-DD
+```
+
+---
+
+## 📝 interface.md Template
+
+```markdown
+# 📐 Interface {{InterfaceName}}
+
+## 🎯 Propósito
+
+[O que esta interface define]
+
+---
+
+## 📋 Interface Completa
+
+\`\`\`typescript
+interface {{InterfaceName}} {
+  // ═══════════════════════════════════════════════════
+  // IDENTIFICAÇÃO
+  // ═══════════════════════════════════════════════════
+  
+  readonly provider: {{ManagerName}}Provider;
+  readonly isConfigured: boolean;
+  
+  // ═══════════════════════════════════════════════════
+  // OPERAÇÕES PRINCIPAIS
+  // ═══════════════════════════════════════════════════
+  
+  operation(input: OperationInput): Promise<OperationOutput>;
+  
+  // ═══════════════════════════════════════════════════
+  // VALIDAÇÃO
+  // ═══════════════════════════════════════════════════
+  
+  validateConfiguration(): boolean;
+}
+\`\`\`
+
+---
+
+## 📊 Métodos por Categoria
+
+| Categoria | Métodos | Descrição |
+|-----------|---------|-----------|
+| Identificação | provider, isConfigured | Info do adapter |
+| Principais | [lista] | Operações core |
+| Validação | validateConfiguration | Verificação |
+
+---
+
+**Versão**: 1.0.0
+```
+
+---
+
+## 📝 types.md Template
+
+```markdown
+# 📦 Tipos Compartilhados
+
+## 🔧 Enums e Constantes
+
+\`\`\`typescript
+type {{ManagerName}}Provider = '[providers]' | 'none';
+\`\`\`
+
+---
+
+## 📥 Tipos de Entrada
+
+\`\`\`typescript
+interface OperationInput {
+  field: Type;
+}
+\`\`\`
+
+---
+
+## 📤 Tipos de Saída
+
+\`\`\`typescript
+interface OperationOutput {
+  id: string;
+  provider: {{ManagerName}}Provider;
+  createdAt: string;
+}
+\`\`\`
+
+---
+
+## ⚙️ Configuração
+
+\`\`\`typescript
+interface ProviderConfig {
+  provider: {{ManagerName}}Provider;
+  isConfigured: boolean;
+  requiredEnvVars: string[];
+  optionalEnvVars: string[];
+  errorMessage?: string;
+}
+\`\`\`
+
+---
+
+**Versão**: 1.0.0
+```
+
+---
+
+## 📝 detector.md Template
+
+```markdown
+# 🔍 Detector de Provedor
+
+## 📋 detectProvider()
+
+\`\`\`typescript
+function detectProvider(): ProviderConfig {
+  const provider = process.env.{{ENV_PREFIX}}_PROVIDER || 'none';
+  
+  const configs = {
+    '[provider]': {
+      provider: '[provider]',
+      isConfigured: !!process.env.{{ENV_PREFIX}}_[PROVIDER]_TOKEN,
+      requiredEnvVars: ['{{ENV_PREFIX}}_[PROVIDER]_TOKEN'],
+      optionalEnvVars: ['{{ENV_PREFIX}}_[PROVIDER]_WORKSPACE'],
+    },
+    'none': {
+      provider: 'none',
+      isConfigured: true,
+      requiredEnvVars: [],
+      optionalEnvVars: [],
+    }
+  };
+  
+  return configs[provider] || configs.none;
+}
+\`\`\`
+
+---
+
+## 📊 Variáveis de Ambiente
+
+| Provedor | Obrigatória | Opcionais |
+|----------|-------------|-----------|
+| [provider] | TOKEN | WORKSPACE |
+
+---
+
+**Versão**: 1.0.0
+```
+
+---
+
+## 📝 factory.md Template
+
+```markdown
+# 🏭 Factory
+
+## 📋 get{{ManagerName}}()
+
+\`\`\`typescript
+function get{{ManagerName}}(options?: FactoryOptions): {{InterfaceName}} {
+  const config = detectProvider();
+  
+  if (!config.isConfigured && options?.throwOnMisconfigured) {
+    throw new Error(config.errorMessage);
+  }
+  
+  switch (config.provider) {
+    case '[provider]':
+      return new [Provider]Adapter({ ... });
+    default:
+      return new NoProviderAdapter();
+  }
+}
+\`\`\`
+
+---
+
+## ⚙️ FactoryOptions
+
+\`\`\`typescript
+interface FactoryOptions {
+  debug?: boolean;
+  throwOnMisconfigured?: boolean;
+  forceProvider?: {{ManagerName}}Provider;
+}
+\`\`\`
+
+---
+
+## 📊 NoProviderAdapter
+
+\`\`\`typescript
+class NoProviderAdapter implements {{InterfaceName}} {
+  readonly provider = 'none';
+  readonly isConfigured = false;
+  
+  // Implementar com warnings + fallbacks
+}
+\`\`\`
+
+---
+
+**Versão**: 1.0.0
+```
+
+---
+
+## 📝 adapters/[provider].md Template
+
+```markdown
+# 🔵 [Provider] Adapter
+
+## 📋 Configuração
+
+\`\`\`bash
+{{ENV_PREFIX}}_[PROVIDER]_TOKEN=xxx
+{{ENV_PREFIX}}_[PROVIDER]_WORKSPACE=xxx
+\`\`\`
+
+---
+
+## 🔧 Implementação
+
+\`\`\`typescript
+class [Provider]Adapter implements {{InterfaceName}} {
+  readonly provider = '[provider]';
+  readonly isConfigured: boolean;
+  
+  constructor(config) {
+    this.isConfigured = !!config.token;
+  }
+  
+  async operation(input): Promise<Output> {
+    // Chamar API/MCP específico
+    // Normalizar resposta
+  }
+}
+\`\`\`
+
+---
+
+## 📊 Mapeamento
+
+| Interface | [Provider] API | Notas |
+|-----------|---------------|-------|
+| field | api_field | [mapeamento] |
+
+---
+
+**Versão**: 1.0.0
+```
+
+---
+
+## 📝 adapters/none.md Template
+
+```markdown
+# ⚪ NoProvider Adapter
+
+## 🎯 Propósito
+
+Fallback para modo offline.
+
+---
+
+## 🔧 Implementação
+
+\`\`\`typescript
+class NoProviderAdapter implements {{InterfaceName}} {
+  readonly provider = 'none';
+  readonly isConfigured = false;
+  
+  async operation(input) {
+    console.warn('⚠️ Modo offline');
+    return {
+      id: \`local-\${Date.now()}\`,
+      provider: 'none',
+      ...input
+    };
+  }
+}
+\`\`\`
+
+---
+
+## 📊 Comportamento
+
+| Operação | Offline |
+|----------|---------|
+| Leitura | [] ou null |
+| Escrita | Warning + ID local |
+| Update | Warning + throw |
+| Delete | Warning + false |
+
+---
+
+**Versão**: 1.0.0
+```
+
+---
+
+## 🔄 Variáveis de Substituição
+
+| Variável | Exemplo | Descrição |
+|----------|---------|-----------|
+| `{{abstraction_name}}` | `notification-manager` | Nome em kebab-case |
+| `{{InterfaceName}}` | `INotificationManager` | Interface (I + PascalCase) |
+| `{{ManagerName}}` | `NotificationManager` | Sem I (PascalCase) |
+| `{{ENV_PREFIX}}` | `NOTIFICATION_MANAGER` | Prefixo de env (UPPER_SNAKE) |
+| `{{providers}}` | `slack,discord` | Lista de provedores |
+
+---
+
+## 📚 Referências
+
+- [SDAAL Pattern](../../../docs/knowbase/concepts/specification-driven-ai-abstraction-layer.md)
+- [Task Manager (Exemplo)](../../../.cursor/utils/task-manager/)
+- [Comando create-abstraction](../meta/create-abstraction.md)
+
+---
+
+**Versão**: 1.0.0
+**Criado em**: 2025-11-25
+