sauron-cli 1.2.0 → 1.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sauron-cli",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "",
   "main": "dist/index.js",
   "bin": {

package/templates/wiki-recipes/nextjs.rules.md

@@ -0,0 +1,21 @@
+# Next.js - Arquitetura de Server Components e Roteamento
+
+Este documento normatiza a organização lógica e padrões de Server vs Client Components no Next.js (App Router).
+
+## 🎯 Regras Obrigatórias para a IA
+
+1. **Server Components por Padrão**:
+   - Todas as páginas (`page.tsx`) e layouts (`layout.tsx`) devem operar como Server Components por padrão.
+   - Busque dados diretamente no servidor (usando `fetch` ou acessando o banco/serviço) em vez de chamar APIs internas via client.
+
+2. **Client Components Isolados**:
+   - Adicione a diretiva `'use client'` estritamente no topo de arquivos que necessitam de interatividade (hooks como `useState`, `useEffect` ou escutadores de eventos do DOM).
+   - Mantenha os Client Components no menor nível possível na árvore de componentes (ex: encapsule um botão interativo em vez de tornar o cabeçalho inteiro client-side).
+
+3. **Roteamento Dinâmico**:
+   - Utilize a API `Link` nativa de `next/link` para navegação interna, garantindo pré-carregamento.
+   - Utilize `useRouter` do `next/navigation` apenas em Client Components e navegações imperativas de evento.
+
+## 🚫 Práticas Banidas
+- Executar chamadas do Firebase Client SDK ou APIs internas diretamente em Server Components sem serialização apropriada.
+- Utilização de hooks de estado fora de Client Components.

package/templates/wiki-recipes/postgresql.rules.md

@@ -0,0 +1,20 @@
+# PostgreSQL - Diretrizes de Banco de Dados e Queries
+
+Este documento normatiza os padrões de modelagem, migrações e consultas SQL.
+
+## 🎯 Regras Obrigatórias para a IA
+
+1. **Migrações Cautelosas**:
+   - Todas as alterações estruturais de banco de dados (DDL) devem passar por arquivos de migração versionados.
+   - Evite alterações destrutivas em produção (como remoção de colunas). Prefira a abordagem de depreciação em fases (adiciona nova coluna, migra dados, remove antiga).
+
+2. **Indexação Estratégica**:
+   - Adicione índices explicitamente em colunas utilizadas em cláusulas `WHERE`, `JOIN` ou ordenações (`ORDER BY`).
+   - Evite excesso de índices em colunas com alta taxa de escrita para não degradar a performance de inserts/updates.
+
+3. **Consultas Seguras**:
+   - Nunca concatene variáveis de entrada diretamente em queries SQL cruas. Utilize sempre parâmetros vinculados (Prepared Statements) para blindagem contra SQL Injection.
+
+## 🚫 Práticas Banidas
+- Queries com `SELECT *` em tabelas largas em produção. Especifique as colunas necessárias para reduzir overhead de tráfego de rede.
+- Executar updates ou deletes sem cláusulas `WHERE` explícitas.

package/templates/wiki-recipes/react.rules.md

@@ -0,0 +1,18 @@
+# React - Gestão de Estado e Ciclo de Vida
+
+Este documento estabelece as diretrizes para a manipulação de componentes e renderização no React.
+
+## 🎯 Regras Obrigatórias para a IA
+
+1. **Componentes Funcionais Estritos**:
+   - Utilize exclusivamente componentes funcionais baseados em Arrow Functions ou declarações de função TypeScript. Componentes baseados em classe estão terminantemente proibidos.
+
+2. **Custom Hooks para Lógica**:
+   - Separe a lógica de negócio do componente visual. Se um componente possui lógica de fetching, paginação ou hooks complexos, isole-os em um custom hook (`useMyFeature.ts`).
+
+3. **Performance e Re-render**:
+   - Utilize `useMemo` e `useCallback` estritamente para evitar recomputações pesadas ou manter referências de objetos estáveis passados como dependência em hooks. Evite micro-otimizações desnecessárias.
+
+## 🚫 Práticas Banidas
+- Mutação direta de estados (ex: `state.push(item)`). Sempre utilize a função de mutação do `useState` aplicando imutabilidade (`setRawState([...state, item])`).
+- Injeção de lógica pesada de controle diretamente dentro do retorno visual JSX.

package/templates/wiki-recipes/tailwindcss.rules.md

@@ -0,0 +1,18 @@
+# Tailwind CSS - Padrões de Estilização Funcional
+
+Este documento estabelece as regras de escrita e organização para classes utilitárias do Tailwind CSS.
+
+## 🎯 Regras Obrigatórias para a IA
+
+1. **Organização de Classes**:
+   - Organize as classes utilitárias na ordem padrão: Layout (display, position), Box Model (width, height, padding, margin), Tipografia (font, text), Design Visual (bg, border, shadow), e Estados Interativos/Responsividade (`sm:`, `hover:`).
+
+2. **Uso de Variáveis de Tema**:
+   - Utilize cores e tokens definidos no arquivo de configuração do Tailwind (`tailwind.config.js`). Evite classes arbitrárias pesadas como `bg-[#ff22aa]` diretamente no HTML.
+
+3. **Responsividade Mobile-First**:
+   - Desenhe a estrutura móvel como base padrão do componente (sem prefixo) e adicione prefixos como `md:` e `lg:` progressivamente para telas maiores.
+
+## 🚫 Práticas Banidas
+- Criação de classes CSS customizadas tradicionais em arquivos separados para resolver problemas que podem ser resolvidos diretamente com classes utilitárias nativas do Tailwind.
+- Misturar estilos in-line JavaScript (`style={{ ... }}`) com classes utilitárias do Tailwind.

package/templates/wiki-recipes/typescript.rules.md

@@ -0,0 +1,21 @@
+# TypeScript - Diretrizes de Qualidade e Tipagem Estrita
+
+Este documento normatiza os padrões de tipagem e compilação para o uso do TypeScript no projeto.
+
+## 🎯 Regras Obrigatórias para a IA
+
+1. **Tipagem Estrita (Strict Mode)**:
+   - Nunca utilizar `any` de forma deliberada. Se a tipagem for dinâmica ou desconhecida, prefira `unknown` e realize Type Guarding (assercões de tipo seguras).
+   - Ative e respeite `noImplicitAny`, `strictNullChecks` e `noUnusedLocals`.
+
+2. **Tipos vs Interfaces**:
+   - Utilize `interface` para declarar contratos de objetos públicos, classes, e componentes expostos.
+   - Utilize `type` para uniões (`|`), interseções (`&`), tuplas, tipos utilitários ou definições primitivas de alias.
+
+3. **Importações Explicitas**:
+   - Utilize imports com a extensão `.js` ao compilar para ECMAScript Modules (ESM) nativo no Node.js.
+   - Prefira importações nomeadas em vez de imports coringa (`* as module`).
+
+## 🚫 Práticas Banidas
+- Desativar checagens com comentários `// @ts-ignore` (use `// @ts-expect-error` apenas com justificativa explícita e em testes).
+- Asserções de tipo coercitivas (`as any` ou `as unknown as Type`).