@codexa/cli 8.5.0 → 8.6.0

package/detectors/loader.ts

@@ -26,18 +26,6 @@ export {
   type DetectorResult,
 } from "./index";
 
-// Re-export utilities for custom detectors
-export {
-  registerDetector,
-  fileExists,
-  dirExists,
-  findFiles,
-  readJson,
-  readText,
-  parseToml,
-  parseYaml,
-} from "./index";
-
 /**
  * Convenience function for CLI display
  */

package/gates/standards-validator.ts

@@ -1,205 +1,205 @@
-import { getDb } from "../db/connection";
-import { existsSync, readFileSync } from "fs";
-import { basename, extname } from "path";
-
-interface Violation {
-  file: string;
-  rule: string;
-  category: string;
-  enforcement: string;
-  detail?: string;
-}
-
-interface ValidationResult {
-  passed: boolean;
-  violations: Violation[];
-  warnings: Violation[];
-}
-
-export function validateAgainstStandards(
-  files: string[],
-  agentDomain: string
-): ValidationResult {
-  const db = getDb();
-  const violations: Violation[] = [];
-  const warnings: Violation[] = [];
-
-  // Buscar standards aplicáveis
-  const standards = db
-    .query(
-      `SELECT * FROM standards
-       WHERE (scope = 'all' OR scope = ?)
-       ORDER BY enforcement DESC, category`
-    )
-    .all(agentDomain) as any[];
-
-  if (standards.length === 0) {
-    return { passed: true, violations: [], warnings: [] };
-  }
-
-  for (const file of files) {
-    if (!existsSync(file)) continue;
-
-    let content: string;
-    try {
-      content = readFileSync(file, "utf-8");
-    } catch {
-      continue;
-    }
-
-    const fileName = basename(file);
-    const ext = extname(file);
-
-    for (const std of standards) {
-      let violated = false;
-      let detail: string | undefined;
-
-      // Validações por categoria
-      switch (std.category) {
-        case "naming":
-          // Validar PascalCase para componentes React/Next
-          if (std.rule.toLowerCase().includes("pascalcase") && (ext === ".tsx" || ext === ".jsx")) {
-            const nameWithoutExt = fileName.replace(ext, "");
-            // Ignorar arquivos especiais (page, layout, loading, etc.)
-            const specialFiles = ["page", "layout", "loading", "error", "not-found", "template", "default"];
-            if (!specialFiles.includes(nameWithoutExt)) {
-              violated = !/^[A-Z][a-zA-Z0-9]*$/.test(nameWithoutExt);
-              if (violated) {
-                detail = `"${fileName}" deveria ser PascalCase (ex: ${nameWithoutExt.charAt(0).toUpperCase() + nameWithoutExt.slice(1)}.tsx)`;
-              }
-            }
-          }
-
-          // Validar camelCase para hooks
-          if (std.rule.toLowerCase().includes("use") && std.rule.toLowerCase().includes("hook")) {
-            if (fileName.includes("use") || fileName.includes("Use")) {
-              violated = !/^use[A-Z][a-zA-Z0-9]*\.ts$/.test(fileName);
-              if (violated) {
-                detail = `Hook "${fileName}" deveria seguir padrao useXxx.ts`;
-              }
-            }
-          }
-          break;
-
-        case "code":
-          // Validar Server Components (sem "use client" desnecessário)
-          if (std.rule.toLowerCase().includes("server component")) {
-            // Se está em app/ e não é um componente interativo, não deveria ter "use client"
-            if (file.includes("/app/") && !file.includes("/components/")) {
-              const hasUseClient = content.includes('"use client"') || content.includes("'use client'");
-              const hasInteractiveCode =
-                content.includes("useState") ||
-                content.includes("useEffect") ||
-                content.includes("onClick") ||
-                content.includes("onChange");
-
-              if (hasUseClient && !hasInteractiveCode) {
-                violated = true;
-                detail = `Arquivo tem "use client" mas nao usa hooks ou eventos interativos`;
-              }
-            }
-          }
-
-          // Validar uso de @ alias
-          if (std.rule.toLowerCase().includes("@") && std.rule.toLowerCase().includes("alias")) {
-            // Verificar imports relativos profundos
-            const deepRelativeImport = /from ['"]\.\.\/\.\.\/\.\.\//;
-            if (deepRelativeImport.test(content)) {
-              violated = true;
-              detail = `Imports relativos profundos (../../..) deveriam usar @ alias`;
-            }
-          }
-          break;
-
-        case "structure":
-          // Validar pasta de componentes
-          if (std.rule.toLowerCase().includes("component") && (ext === ".tsx" || ext === ".jsx")) {
-            const isComponent = /^[A-Z]/.test(fileName) && !file.includes("/app/");
-            if (isComponent && !file.includes("/components/")) {
-              violated = true;
-              detail = `Componente "${fileName}" deveria estar em /components/`;
-            }
-          }
-          break;
-
-        case "library":
-          // Validar anti-exemplos (bibliotecas proibidas)
-          const antiExamples = std.anti_examples ? JSON.parse(std.anti_examples) : [];
-          for (const anti of antiExamples) {
-            if (content.includes(anti)) {
-              violated = true;
-              detail = `Uso de "${anti}" nao permitido. ${std.rule}`;
-              break;
-            }
-          }
-          break;
-
-        case "practice":
-          // Validar práticas obrigatórias
-          if (std.rule.toLowerCase().includes("zod") && std.rule.toLowerCase().includes("valid")) {
-            // Se arquivo define tipos/interfaces com Props, deveria usar Zod
-            const hasPropsInterface = /interface\s+\w*Props\b/.test(content);
-            const hasPropsType = /type\s+\w*Props\s*=/.test(content);
-            const usesZod = content.includes("z.") || content.includes("from 'zod'") || content.includes('from "zod"');
-
-            if ((hasPropsInterface || hasPropsType) && !usesZod && file.includes("/components/")) {
-              // Isso é mais um warning do que violation
-              if (std.enforcement === "required") {
-                violated = true;
-                detail = `Componente define Props mas nao usa Zod para validacao`;
-              }
-            }
-          }
-          break;
-      }
-
-      if (violated) {
-        const violation: Violation = {
-          file,
-          rule: std.rule,
-          category: std.category,
-          enforcement: std.enforcement,
-          detail,
-        };
-
-        if (std.enforcement === "required") {
-          violations.push(violation);
-        } else {
-          warnings.push(violation);
-        }
-      }
-    }
-  }
-
-  return {
-    passed: violations.length === 0,
-    violations,
-    warnings,
-  };
-}
-
-export function printValidationResult(result: ValidationResult): void {
-  if (result.violations.length > 0) {
-    console.error("\n⛔ VIOLACOES DE STANDARDS (required):\n");
-    for (const v of result.violations) {
-      console.error(`  [${v.category}] ${basename(v.file)}`);
-      console.error(`    Regra: ${v.rule}`);
-      if (v.detail) {
-        console.error(`    Detalhe: ${v.detail}`);
-      }
-      console.error();
-    }
-  }
-
-  if (result.warnings.length > 0) {
-    console.warn("\n⚠ AVISOS (recommended):\n");
-    for (const w of result.warnings) {
-      console.warn(`  [${w.category}] ${basename(w.file)}`);
-      console.warn(`    Regra: ${w.rule}`);
-      if (w.detail) {
-        console.warn(`    Detalhe: ${w.detail}`);
-      }
-      console.warn();
-    }
-  }
+import { getDb } from "../db/connection";
+import { existsSync, readFileSync } from "fs";
+import { basename, extname } from "path";
+
+interface Violation {
+  file: string;
+  rule: string;
+  category: string;
+  enforcement: string;
+  detail?: string;
+}
+
+interface ValidationResult {
+  passed: boolean;
+  violations: Violation[];
+  warnings: Violation[];
+}
+
+export function validateAgainstStandards(
+  files: string[],
+  agentDomain: string
+): ValidationResult {
+  const db = getDb();
+  const violations: Violation[] = [];
+  const warnings: Violation[] = [];
+
+  // Buscar standards aplicáveis
+  const standards = db
+    .query(
+      `SELECT * FROM standards
+       WHERE (scope = 'all' OR scope = ?)
+       ORDER BY enforcement DESC, category`
+    )
+    .all(agentDomain) as any[];
+
+  if (standards.length === 0) {
+    return { passed: true, violations: [], warnings: [] };
+  }
+
+  for (const file of files) {
+    if (!existsSync(file)) continue;
+
+    let content: string;
+    try {
+      content = readFileSync(file, "utf-8");
+    } catch {
+      continue;
+    }
+
+    const fileName = basename(file);
+    const ext = extname(file);
+
+    for (const std of standards) {
+      let violated = false;
+      let detail: string | undefined;
+
+      // Validações por categoria
+      switch (std.category) {
+        case "naming":
+          // Validar PascalCase para componentes React/Next
+          if (std.rule.toLowerCase().includes("pascalcase") && (ext === ".tsx" || ext === ".jsx")) {
+            const nameWithoutExt = fileName.replace(ext, "");
+            // Ignorar arquivos especiais (page, layout, loading, etc.)
+            const specialFiles = ["page", "layout", "loading", "error", "not-found", "template", "default"];
+            if (!specialFiles.includes(nameWithoutExt)) {
+              violated = !/^[A-Z][a-zA-Z0-9]*$/.test(nameWithoutExt);
+              if (violated) {
+                detail = `"${fileName}" deveria ser PascalCase (ex: ${nameWithoutExt.charAt(0).toUpperCase() + nameWithoutExt.slice(1)}.tsx)`;
+              }
+            }
+          }
+
+          // Validar camelCase para hooks
+          if (std.rule.toLowerCase().includes("use") && std.rule.toLowerCase().includes("hook")) {
+            if (fileName.includes("use") || fileName.includes("Use")) {
+              violated = !/^use[A-Z][a-zA-Z0-9]*\.ts$/.test(fileName);
+              if (violated) {
+                detail = `Hook "${fileName}" deveria seguir padrao useXxx.ts`;
+              }
+            }
+          }
+          break;
+
+        case "code":
+          // Validar Server Components (sem "use client" desnecessário)
+          if (std.rule.toLowerCase().includes("server component")) {
+            // Se está em app/ e não é um componente interativo, não deveria ter "use client"
+            if (file.includes("/app/") && !file.includes("/components/")) {
+              const hasUseClient = content.includes('"use client"') || content.includes("'use client'");
+              const hasInteractiveCode =
+                content.includes("useState") ||
+                content.includes("useEffect") ||
+                content.includes("onClick") ||
+                content.includes("onChange");
+
+              if (hasUseClient && !hasInteractiveCode) {
+                violated = true;
+                detail = `Arquivo tem "use client" mas nao usa hooks ou eventos interativos`;
+              }
+            }
+          }
+
+          // Validar uso de @ alias
+          if (std.rule.toLowerCase().includes("@") && std.rule.toLowerCase().includes("alias")) {
+            // Verificar imports relativos profundos
+            const deepRelativeImport = /from ['"]\.\.\/\.\.\/\.\.\//;
+            if (deepRelativeImport.test(content)) {
+              violated = true;
+              detail = `Imports relativos profundos (../../..) deveriam usar @ alias`;
+            }
+          }
+          break;
+
+        case "structure":
+          // Validar pasta de componentes
+          if (std.rule.toLowerCase().includes("component") && (ext === ".tsx" || ext === ".jsx")) {
+            const isComponent = /^[A-Z]/.test(fileName) && !file.includes("/app/");
+            if (isComponent && !file.includes("/components/")) {
+              violated = true;
+              detail = `Componente "${fileName}" deveria estar em /components/`;
+            }
+          }
+          break;
+
+        case "library":
+          // Validar anti-exemplos (bibliotecas proibidas)
+          const antiExamples = std.anti_examples ? JSON.parse(std.anti_examples) : [];
+          for (const anti of antiExamples) {
+            if (content.includes(anti)) {
+              violated = true;
+              detail = `Uso de "${anti}" nao permitido. ${std.rule}`;
+              break;
+            }
+          }
+          break;
+
+        case "practice":
+          // Validar práticas obrigatórias
+          if (std.rule.toLowerCase().includes("zod") && std.rule.toLowerCase().includes("valid")) {
+            // Se arquivo define tipos/interfaces com Props, deveria usar Zod
+            const hasPropsInterface = /interface\s+\w*Props\b/.test(content);
+            const hasPropsType = /type\s+\w*Props\s*=/.test(content);
+            const usesZod = content.includes("z.") || content.includes("from 'zod'") || content.includes('from "zod"');
+
+            if ((hasPropsInterface || hasPropsType) && !usesZod && file.includes("/components/")) {
+              // Isso é mais um warning do que violation
+              if (std.enforcement === "required") {
+                violated = true;
+                detail = `Componente define Props mas nao usa Zod para validacao`;
+              }
+            }
+          }
+          break;
+      }
+
+      if (violated) {
+        const violation: Violation = {
+          file,
+          rule: std.rule,
+          category: std.category,
+          enforcement: std.enforcement,
+          detail,
+        };
+
+        if (std.enforcement === "required") {
+          violations.push(violation);
+        } else {
+          warnings.push(violation);
+        }
+      }
+    }
+  }
+
+  return {
+    passed: violations.length === 0,
+    violations,
+    warnings,
+  };
+}
+
+export function printValidationResult(result: ValidationResult): void {
+  if (result.violations.length > 0) {
+    console.error("\n⛔ VIOLACOES DE STANDARDS (required):\n");
+    for (const v of result.violations) {
+      console.error(`  [${v.category}] ${basename(v.file)}`);
+      console.error(`    Regra: ${v.rule}`);
+      if (v.detail) {
+        console.error(`    Detalhe: ${v.detail}`);
+      }
+      console.error();
+    }
+  }
+
+  if (result.warnings.length > 0) {
+    console.warn("\n⚠ AVISOS (recommended):\n");
+    for (const w of result.warnings) {
+      console.warn(`  [${w.category}] ${basename(w.file)}`);
+      console.warn(`    Regra: ${w.rule}`);
+      if (w.detail) {
+        console.warn(`    Detalhe: ${w.detail}`);
+      }
+      console.warn();
+    }
+  }
 }