/hygiene

/hygiene Command
    |
    +-- Pattern Engine
    |       +-- Regex Pattern Library (25+ patterns)
    |       +-- AST-Free Analyzer
    |       +-- File Scanner (parallel)
    |       +-- Result Aggregator
    |
    +-- Check Categories
    |       +-- Anti-Pattern Detector
    |       |       +-- length() > 0 (use Enum.any?/1)
    |       |       +-- String.to_atom/1 (use String.to_existing_atom/1)
    |       |       +-- Process.sleep/1 (use Process.send_after/3)
    |       |       +-- Map access without default
    |       |       +-- Bare map access (use Map.get/3)
    |       |
    |       +-- Annotation Checker
    |       |       +-- Missing @spec
    |       |       +-- Missing @impl
    |       |       +-- Missing @moduledoc
    |       |       +-- Missing @doc
    |       |
    |       +-- Naming Convention Checker
    |       |       +-- Forbidden names (Manager, Handler, Utils)
    |       |       +-- Module naming consistency
    |       |       +-- Function naming patterns
    |       |
    |       +-- Security Pattern Checker
    |               +-- Hardcoded credentials
    |               +-- Unsafe deserialization
    |               +-- SQL injection patterns
    |               +-- XSS vulnerability patterns
    |
    +-- Performance Optimizer
    |       +-- Parallel File Processing
    |       +-- Incremental Analysis (changed files only)
    |       +-- Result Caching
    |       +-- Early Termination
    |
    +-- Reporter
            +-- Violation Formatter
            +-- Fix Suggestion Generator
            +-- Summary Statistics
            +-- Telemetry Emitter

# Run complete hygiene analysis on the codebase
/hygiene

# Run with detailed violation output
/hygiene --verbose

# Run on specific umbrella application
/hygiene --app=prismatic_perimeter

# Run on specific files
/hygiene --files=apps/prismatic_web/lib/prismatic_web/live/*.ex

# Check anti-patterns only
/hygiene --category=anti-patterns

# Check annotation coverage
/hygiene --category=annotations

# Check naming conventions
/hygiene --category=naming

# Check security patterns
/hygiene --category=security

# Analyze only changed files (git-based)
/hygiene --changed

# Analyze files changed since a specific commit
/hygiene --since=HEAD~5

# Analyze staged files only (pre-commit mode)
/hygiene --staged

# Preview auto-fixable violations
/hygiene --fix --dry-run

# Apply auto-fixes for safe patterns
/hygiene --fix

# Fix specific category only
/hygiene --fix --category=anti-patterns

# Define a custom hygiene pattern
%HygienePattern{
  id: :custom_unsafe_access,
  category: :anti_patterns,
  severity: :error,
  pattern: ~r/\bmap\[.*\]/,
  description: "Unsafe bracket map access; use Map.get/3",
  suggestion: "Replace map[key] with Map.get(map, key, default)",
  auto_fix: false
}

# Output in checkstyle format for editor integration
/hygiene --format=checkstyle --output=hygiene-report.xml

# Continuous watch mode for real-time feedback
/hygiene --watch --app=prismatic_web

Related Commands