AC Code Validator

Validate code against quality standards and style guidelines.

Purpose

Performs static analysis, linting, type checking, and style validation to ensure code meets quality standards before integration.

Quick Start

from scripts.code_validator import CodeValidator

validator = CodeValidator(project_dir)
result = await validator.validate()

Validation Types

Linting

lint_result = await validator.run_lint()
# ESLint for JS/TS
# Ruff/Flake8 for Python
# golint for Go

Type Checking

type_result = await validator.run_type_check()
# TypeScript compiler
# mypy for Python

Formatting

format_result = await validator.check_formatting()
# Prettier for JS/TS
# Black for Python

Security Scan

security_result = await validator.run_security_scan()
# Bandit for Python
# npm audit for Node.js

Validation Result

{
  "valid": true,
  "checks": {
    "lint": {
      "passed": true,
      "errors": 0,
      "warnings": 3,
      "issues": [
        {"file": "auth.py", "line": 45, "severity": "warning", "message": "Line too long"}
      ]
    },
    "types": {
      "passed": true,
      "errors": 0
    },
    "format": {
      "passed": false,
      "files_needing_format": ["utils.py"]
    },
    "security": {
      "passed": true,
      "vulnerabilities": []
    }
  },
  "summary": {
    "total_issues": 3,
    "blocking": 0,
    "auto_fixable": 3
  }
}

Configuration

{
  "language": "python",
  "tools": {
    "lint": "ruff",
    "format": "black",
    "types": "mypy",
    "security": "bandit"
  },
  "rules": {
    "max_line_length": 100,
    "max_complexity": 10,
    "require_docstrings": true
  },
  "ignore_patterns": [
    "**/__pycache__/**",
    "**/node_modules/**",
    "**/.venv/**"
  ]
}

Auto-Fix Support

# Fix all auto-fixable issues
fix_result = await validator.auto_fix()

# Fix specific types only
await validator.auto_fix(types=["format", "lint"])

Language Support

Language	Lint	Types	Format	Security
Python	ruff/flake8	mypy	black	bandit
TypeScript	eslint	tsc	prettier	npm audit
JavaScript	eslint	-	prettier	npm audit
Go	golint	go vet	gofmt	gosec

Integration

• Used by:

  ac-qa-reviewer

  for quality checks
• Used by:

  ac-commit-manager

  before commits
• Reports to:

  ac-task-executor

API Reference

See

scripts/code_validator.py

for full implementation.