thailint 0.3.1__tar.gz → 0.4.0__tar.gz

{thailint-0.3.1 → thailint-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: thailint
-Version: 0.3.1
+Version: 0.4.0
 Summary: The AI Linter - Enterprise-grade linting and governance for AI-generated code across multiple languages
 License: MIT
 Keywords: linter,ai,code-quality,static-analysis,file-placement,governance,multi-language,cli,docker,python
@@ -35,14 +35,25 @@ Description-Content-Type: text/markdown
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
-[![Tests](https://img.shields.io/badge/tests-317%2F317%20passing-brightgreen.svg)](tests/)
-[![Coverage](https://img.shields.io/badge/coverage-90%25-brightgreen.svg)](htmlcov/)
+[![Tests](https://img.shields.io/badge/tests-253%2F253%20passing-brightgreen.svg)](tests/)
+[![Coverage](https://img.shields.io/badge/coverage-87%25-brightgreen.svg)](htmlcov/)
 
 The AI Linter - Enterprise-ready linting and governance for AI-generated code across multiple languages.
 
 ## Overview
 
-thailint is a modern, enterprise-ready multi-language linter designed specifically for AI-generated code. It enforces project structure, file placement rules, and coding standards across Python, TypeScript, and other languages.
+thailint is a modern, enterprise-ready multi-language linter designed specifically for AI-generated code. It focuses on common mistakes and anti-patterns that AI coding assistants frequently introduce—issues that existing linters don't catch or don't handle consistently across languages.
+
+**Why thailint?**
+
+We're not trying to replace the wonderful existing linters like Pylint, ESLint, or Ruff. Instead, thailint fills critical gaps:
+
+- **AI-Specific Patterns**: AI assistants have predictable blind spots (excessive nesting, magic numbers, SRP violations) that traditional linters miss
+- **Cross-Language Consistency**: Detects the same anti-patterns across Python, TypeScript, and JavaScript with unified rules
+- **No Existing Solutions**: Issues like excessive nesting depth, file placement violations, and cross-project code duplication lack comprehensive multi-language detection
+- **Governance Layer**: Enforces project-wide structure and organization patterns that AI can't infer from local context
+
+thailint complements your existing linting stack by catching the patterns AI tools repeatedly miss.
 
 ## Features
 
@@ -917,49 +928,96 @@ def test_no_violations():
 ### Setup Development Environment
 
 ```bash
-# Install development dependencies
-pip install -e ".[dev]"
+# Install dependencies and activate virtualenv
+just init
 
-# Install pre-commit hooks (if using)
-pre-commit install
+# Or manually:
+poetry install
+source $(poetry env info --path)/bin/activate
 ```
 
 ### Running Tests
 
 ```bash
-# Run all tests
-pytest
+# Run all tests (parallel mode - fast)
+just test
 
-# Run with coverage
-pytest --cov=src --cov-report=html
+# Run with coverage (serial mode)
+just test-coverage
 
 # Run specific test
-pytest tests/test_cli.py::test_hello_command
+poetry run pytest tests/test_cli.py::test_hello_command -v
 ```
 
 ### Code Quality
 
 ```bash
-# Lint code
-ruff check src tests
+# Fast linting (Ruff only - use during development)
+just lint
+
+# Comprehensive linting (Ruff + Pylint + Flake8 + MyPy)
+just lint-all
+
+# Security scanning
+just lint-security
+
+# Complexity analysis (Radon + Xenon + Nesting)
+just lint-complexity
+
+# SOLID principles (SRP)
+just lint-solid
+
+# DRY principles (duplicate code detection)
+just lint-dry
+
+# ALL quality checks (runs everything)
+just lint-full
+
+# Auto-fix formatting issues
+just format
+```
+
+### Dogfooding (Lint Our Own Code)
+
+```bash
+# Lint file placement
+just lint-placement
 
-# Format code
-ruff format src tests
+# Check nesting depth
+just lint-nesting
 
-# Type checking
-mypy src/
+# Check for magic numbers
+poetry run thai-lint magic-numbers src/
 ```
 
-### Building
+### Building and Publishing
 
 ```bash
 # Build Python package
 poetry build
 
-# Build Docker image locally (optional)
+# Build Docker image locally
 docker build -t washad/thailint:latest .
+
+# Publish to PyPI and Docker Hub (runs tests + linting + version bump)
+just publish
 ```
 
+### Quick Development Workflows
+
+```bash
+# Make changes, then run quality checks
+just lint-full
+
+# Share changes for collaboration (skips hooks)
+just share "WIP: feature description"
+
+# Clean up cache and artifacts
+just clean
+```
+
+See `just --list` or `just help` for all available commands.
+
 ## Docker Usage
 
 ```bash

{thailint-0.3.1 → thailint-0.4.0}/README.md

@@ -2,14 +2,25 @@
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
-[![Tests](https://img.shields.io/badge/tests-317%2F317%20passing-brightgreen.svg)](tests/)
-[![Coverage](https://img.shields.io/badge/coverage-90%25-brightgreen.svg)](htmlcov/)
+[![Tests](https://img.shields.io/badge/tests-253%2F253%20passing-brightgreen.svg)](tests/)
+[![Coverage](https://img.shields.io/badge/coverage-87%25-brightgreen.svg)](htmlcov/)
 
 The AI Linter - Enterprise-ready linting and governance for AI-generated code across multiple languages.
 
 ## Overview
 
-thailint is a modern, enterprise-ready multi-language linter designed specifically for AI-generated code. It enforces project structure, file placement rules, and coding standards across Python, TypeScript, and other languages.
+thailint is a modern, enterprise-ready multi-language linter designed specifically for AI-generated code. It focuses on common mistakes and anti-patterns that AI coding assistants frequently introduce—issues that existing linters don't catch or don't handle consistently across languages.
+
+**Why thailint?**
+
+We're not trying to replace the wonderful existing linters like Pylint, ESLint, or Ruff. Instead, thailint fills critical gaps:
+
+- **AI-Specific Patterns**: AI assistants have predictable blind spots (excessive nesting, magic numbers, SRP violations) that traditional linters miss
+- **Cross-Language Consistency**: Detects the same anti-patterns across Python, TypeScript, and JavaScript with unified rules
+- **No Existing Solutions**: Issues like excessive nesting depth, file placement violations, and cross-project code duplication lack comprehensive multi-language detection
+- **Governance Layer**: Enforces project-wide structure and organization patterns that AI can't infer from local context
+
+thailint complements your existing linting stack by catching the patterns AI tools repeatedly miss.
 
 ## Features
 
@@ -884,49 +895,96 @@ def test_no_violations():
 ### Setup Development Environment
 
 ```bash
-# Install development dependencies
-pip install -e ".[dev]"
+# Install dependencies and activate virtualenv
+just init
 
-# Install pre-commit hooks (if using)
-pre-commit install
+# Or manually:
+poetry install
+source $(poetry env info --path)/bin/activate
 ```
 
 ### Running Tests
 
 ```bash
-# Run all tests
-pytest
+# Run all tests (parallel mode - fast)
+just test
 
-# Run with coverage
-pytest --cov=src --cov-report=html
+# Run with coverage (serial mode)
+just test-coverage
 
 # Run specific test
-pytest tests/test_cli.py::test_hello_command
+poetry run pytest tests/test_cli.py::test_hello_command -v
 ```
 
 ### Code Quality
 
 ```bash
-# Lint code
-ruff check src tests
+# Fast linting (Ruff only - use during development)
+just lint
+
+# Comprehensive linting (Ruff + Pylint + Flake8 + MyPy)
+just lint-all
+
+# Security scanning
+just lint-security
+
+# Complexity analysis (Radon + Xenon + Nesting)
+just lint-complexity
+
+# SOLID principles (SRP)
+just lint-solid
+
+# DRY principles (duplicate code detection)
+just lint-dry
+
+# ALL quality checks (runs everything)
+just lint-full
+
+# Auto-fix formatting issues
+just format
+```
+
+### Dogfooding (Lint Our Own Code)
+
+```bash
+# Lint file placement
+just lint-placement
 
-# Format code
-ruff format src tests
+# Check nesting depth
+just lint-nesting
 
-# Type checking
-mypy src/
+# Check for magic numbers
+poetry run thai-lint magic-numbers src/
 ```
 
-### Building
+### Building and Publishing
 
 ```bash
 # Build Python package
 poetry build
 
-# Build Docker image locally (optional)
+# Build Docker image locally
 docker build -t washad/thailint:latest .
+
+# Publish to PyPI and Docker Hub (runs tests + linting + version bump)
+just publish
 ```
 
+### Quick Development Workflows
+
+```bash
+# Make changes, then run quality checks
+just lint-full
+
+# Share changes for collaboration (skips hooks)
+just share "WIP: feature description"
+
+# Clean up cache and artifacts
+just clean
+```
+
+See `just --list` or `just help` for all available commands.
+
 ## Docker Usage
 
 ```bash

{thailint-0.3.1 → thailint-0.4.0}/pyproject.toml

@@ -17,7 +17,7 @@ build-backend = "poetry.core.masonry.api"
 
 [tool.poetry]
 name = "thailint"
-version = "0.3.1"
+version = "0.4.0"
 description = "The AI Linter - Enterprise-grade linting and governance for AI-generated code across multiple languages"
 authors = ["Steve Jackson"]
 license = "MIT"

{thailint-0.3.1 → thailint-0.4.0}/src/cli.py

@@ -362,6 +362,141 @@ def config_reset(ctx, yes: bool):
         sys.exit(1)
 
 
+@cli.command("init-config")
+@click.option(
+    "--preset",
+    "-p",
+    type=click.Choice(["strict", "standard", "lenient"]),
+    default="standard",
+    help="Configuration preset",
+)
+@click.option("--non-interactive", is_flag=True, help="Skip interactive prompts (for AI agents)")
+@click.option("--force", is_flag=True, help="Overwrite existing .thailint.yaml file")
+@click.option(
+    "--output", "-o", type=click.Path(), default=".thailint.yaml", help="Output file path"
+)
+def init_config(preset: str, non_interactive: bool, force: bool, output: str):
+    """
+    Generate a .thailint.yaml configuration file with preset values.
+
+    Creates a richly-commented configuration file with sensible defaults
+    and optional customizations for different strictness levels.
+
+    For AI agents, use --non-interactive mode:
+      thailint init-config --non-interactive --preset lenient
+
+    Presets:
+      strict:   Minimal allowed numbers (only -1, 0, 1)
+      standard: Balanced defaults (includes 2, 3, 4, 5, 10, 100, 1000)
+      lenient:  Includes time conversions (adds 60, 3600)
+
+    Examples:
+
+        \\b
+        # Interactive mode (default, for humans)
+        thailint init-config
+
+        \\b
+        # Non-interactive mode (for AI agents)
+        thailint init-config --non-interactive
+
+        \\b
+        # Generate with lenient preset
+        thailint init-config --preset lenient
+
+        \\b
+        # Overwrite existing config
+        thailint init-config --force
+
+        \\b
+        # Custom output path
+        thailint init-config --output my-config.yaml
+    """
+    output_path = Path(output)
+
+    # Check if file exists (unless --force)
+    if output_path.exists() and not force:
+        click.echo(f"Error: {output} already exists", err=True)
+        click.echo("", err=True)
+        click.echo("Use --force to overwrite:", err=True)
+        click.echo("  thailint init-config --force", err=True)
+        sys.exit(1)
+
+    # Interactive mode: Ask user for preferences
+    if not non_interactive:
+        click.echo("thai-lint Configuration Generator")
+        click.echo("=" * 50)
+        click.echo("")
+        click.echo("This will create a .thailint.yaml configuration file.")
+        click.echo("For non-interactive mode (AI agents), use:")
+        click.echo("  thailint init-config --non-interactive")
+        click.echo("")
+
+        # Ask for preset
+        click.echo("Available presets:")
+        click.echo("  strict:   Only -1, 0, 1 allowed (strictest)")
+        click.echo("  standard: -1, 0, 1, 2, 3, 4, 5, 10, 100, 1000 (balanced)")
+        click.echo("  lenient:  Includes time conversions 60, 3600 (most permissive)")
+        click.echo("")
+
+        preset = click.prompt(
+            "Choose preset", type=click.Choice(["strict", "standard", "lenient"]), default=preset
+        )
+
+    # Generate config based on preset
+    config_content = _generate_config_content(preset)
+
+    # Write config file
+    try:
+        output_path.write_text(config_content, encoding="utf-8")
+        click.echo("")
+        click.echo(f"✓ Created {output}")
+        click.echo(f"✓ Preset: {preset}")
+        click.echo("")
+        click.echo("Next steps:")
+        click.echo(f"  1. Review and customize {output}")
+        click.echo("  2. Run: thailint magic-numbers .")
+        click.echo("  3. See docs: https://github.com/your-org/thai-lint")
+    except OSError as e:
+        click.echo(f"Error writing config file: {e}", err=True)
+        sys.exit(1)
+
+
+def _generate_config_content(preset: str) -> str:
+    """Generate config file content based on preset."""
+    # Preset configurations
+    presets = {
+        "strict": {
+            "allowed_numbers": "[-1, 0, 1]",
+            "max_small_integer": "3",
+            "description": "Strict (only universal values)",
+        },
+        "standard": {
+            "allowed_numbers": "[-1, 0, 1, 2, 3, 4, 5, 10, 100, 1000]",
+            "max_small_integer": "10",
+            "description": "Standard (balanced defaults)",
+        },
+        "lenient": {
+            "allowed_numbers": "[-1, 0, 1, 2, 3, 4, 5, 10, 60, 100, 1000, 3600]",
+            "max_small_integer": "10",
+            "description": "Lenient (includes time conversions)",
+        },
+    }
+
+    config = presets[preset]
+
+    # Read template
+    template_path = Path(__file__).parent / "templates" / "thailint_config_template.yaml"
+    template = template_path.read_text(encoding="utf-8")
+
+    # Replace placeholders
+    content = template.replace("{{PRESET}}", config["description"])
+    content = content.replace("{{ALLOWED_NUMBERS}}", config["allowed_numbers"])
+    content = content.replace("{{MAX_SMALL_INTEGER}}", config["max_small_integer"])
+
+    return content
+
+
 @cli.command("file-placement")
 @click.argument("paths", nargs=-1, type=click.Path())
 @click.option("--config", "-c", "config_file", type=click.Path(), help="Path to config file")

{thailint-0.3.1 → thailint-0.4.0}/src/linters/magic_numbers/config.py

@@ -4,7 +4,7 @@ Purpose: Configuration schema for magic numbers linter
 Scope: MagicNumberConfig dataclass with allowed_numbers and max_small_integer settings
 
 Overview: Defines configuration schema for magic numbers linter. Provides MagicNumberConfig dataclass
-    with allowed_numbers set (default includes common acceptable numbers like 0, 1, 2, -1, 10, 100, 1000)
+    with allowed_numbers set (default includes common acceptable numbers like -1, 0, 1, 2, 3, 4, 5, 10, 100, 1000)
     and max_small_integer threshold (default 10) for range() contexts. Supports per-file and per-directory
     config overrides through from_dict class method. Validates that configuration values are appropriate
     types. Integrates with orchestrator's configuration system to allow users to customize allowed numbers
@@ -29,7 +29,9 @@ class MagicNumberConfig:
     """Configuration for magic numbers linter."""
 
     enabled: bool = True
-    allowed_numbers: set[int | float] = field(default_factory=lambda: {-1, 0, 1, 2, 10, 100, 1000})
+    allowed_numbers: set[int | float] = field(
+        default_factory=lambda: {-1, 0, 1, 2, 3, 4, 5, 10, 100, 1000}
+    )
     max_small_integer: int = 10
 
     def __post_init__(self) -> None:
@@ -54,14 +56,17 @@ class MagicNumberConfig:
             lang_config = config[language]
             allowed_numbers = set(
                 lang_config.get(
-                    "allowed_numbers", config.get("allowed_numbers", {-1, 0, 1, 2, 10, 100, 1000})
+                    "allowed_numbers",
+                    config.get("allowed_numbers", {-1, 0, 1, 2, 3, 4, 5, 10, 100, 1000}),
                 )
             )
             max_small_integer = lang_config.get(
                 "max_small_integer", config.get("max_small_integer", 10)
             )
         else:
-            allowed_numbers = set(config.get("allowed_numbers", {-1, 0, 1, 2, 10, 100, 1000}))
+            allowed_numbers = set(
+                config.get("allowed_numbers", {-1, 0, 1, 2, 3, 4, 5, 10, 100, 1000})
+            )
             max_small_integer = config.get("max_small_integer", 10)
 
         return cls(

thailint-0.4.0/src/templates/thailint_config_template.yaml

@@ -0,0 +1,132 @@
+# thai-lint Configuration File
+# Generated by: thailint init-config
+#
+# For non-interactive mode (AI agents): thailint init-config --non-interactive
+#
+# Full documentation: https://github.com/your-org/thai-lint
+
+# ============================================================================
+# MAGIC NUMBERS LINTER
+# ============================================================================
+# Detects unnamed numeric literals that should be extracted as constants
+#
+# Preset: {{PRESET}}
+#
+magic-numbers:
+  enabled: true
+
+  # Numbers that are acceptable without being named constants
+  # Default: [-1, 0, 1, 2, 3, 4, 5, 10, 100, 1000]
+  allowed_numbers: {{ALLOWED_NUMBERS}}
+
+  # Maximum integer allowed in range() or enumerate() without flagging
+  # Default: 10
+  max_small_integer: {{MAX_SMALL_INTEGER}}
+
+  # -------------------------------------------------------------------------
+  # OPTIONAL: Uncomment to add time conversions (lenient mode)
+  # -------------------------------------------------------------------------
+  # allowed_numbers: [-1, 0, 1, 2, 3, 4, 5, 10, 60, 100, 1000, 3600]
+
+  # -------------------------------------------------------------------------
+  # OPTIONAL: Uncomment to add common HTTP status codes
+  # -------------------------------------------------------------------------
+  # allowed_numbers: [-1, 0, 1, 2, 3, 4, 5, 10, 100, 200, 201, 204, 400, 401, 403, 404, 500, 502, 503, 1000]
+
+  # -------------------------------------------------------------------------
+  # OPTIONAL: Uncomment to add decimal proportions (0.0-1.0)
+  # -------------------------------------------------------------------------
+  # allowed_numbers: [-1, 0, 1, 2, 3, 4, 5, 10, 100, 1000, 0.0, 0.1, 0.2, 0.25, 0.3, 0.4, 0.5, 0.6, 0.7, 0.75, 0.8, 0.9, 1.0]
+
+# ============================================================================
+# NESTING LINTER
+# ============================================================================
+# Checks for excessive nesting depth (if/for/while/try statements)
+#
+nesting:
+  enabled: true
+
+  # Maximum nesting depth allowed
+  # Default: 4
+  max_nesting_depth: 4
+
+# ============================================================================
+# SINGLE RESPONSIBILITY PRINCIPLE (SRP) LINTER
+# ============================================================================
+# Detects classes that may have too many responsibilities
+#
+srp:
+  enabled: true
+
+  # Maximum methods per class
+  # Default: 7
+  max_methods: 7
+
+  # Maximum lines of code per class
+  # Default: 200
+  max_loc: 200
+
+# ============================================================================
+# DRY (DON'T REPEAT YOURSELF) LINTER
+# ============================================================================
+# Detects duplicate code blocks
+#
+dry:
+  enabled: true
+
+  # Minimum lines for a block to be considered duplicate
+  # Default: 6
+  min_duplicate_lines: 6
+
+  # Enable SQLite caching for faster incremental scans
+  # Default: true
+  cache_enabled: true
+
+  # Cache file location (relative to project root)
+  # Default: .thailint-cache/dry.db
+  cache_path: .thailint-cache/dry.db
+
+# ============================================================================
+# FILE PLACEMENT LINTER
+# ============================================================================
+# Ensures files are in appropriate directories
+#
+file-placement:
+  enabled: true
+
+  # Rules for file placement
+  rules:
+    # Test files should be in tests/ directory
+    - pattern: "test_*.py"
+      required_dir: "tests/"
+      message: "Test files must be in tests/ directory"
+
+    # Config files should be in config/ or root
+    - pattern: "*config*.py"
+      required_dir: ["config/", "./"]
+      message: "Config files should be in config/ or project root"
+
+# ============================================================================
+# GLOBAL SETTINGS
+# ============================================================================
+#
+# Exclude patterns (files/directories to ignore)
+exclude:
+  - ".git/"
+  - ".venv/"
+  - "venv/"
+  - "node_modules/"
+  - "__pycache__/"
+  - "*.pyc"
+  - ".pytest_cache/"
+  - "dist/"
+  - "build/"
+  - ".eggs/"
+
+# Output format (text or json)
+# Default: text
+output_format: text
+
+# Exit with error code if violations found
+# Default: true
+fail_on_violations: true