thailint 0.3.0__tar.gz → 0.3.2__tar.gz

{thailint-0.3.0 → thailint-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: thailint
-Version: 0.3.0
+Version: 0.3.2
 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-88%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.0 → thailint-0.3.2}/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-88%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.0 → thailint-0.3.2}/pyproject.toml

@@ -17,7 +17,7 @@ build-backend = "poetry.core.masonry.api"
 
 [tool.poetry]
 name = "thailint"
-version = "0.3.0"
+version = "0.3.2"
 description = "The AI Linter - Enterprise-grade linting and governance for AI-generated code across multiple languages"
 authors = ["Steve Jackson"]
 license = "MIT"
@@ -101,6 +101,7 @@ xenon = "^0.9.3"
 safety = "^3.2.11"
 pip-audit = "^2.8.0"
 loguru = "^0.7.3"
+pytest-xdist = "^3.8.0"
 
 [tool.poetry.scripts]
 thailint = "src.cli:cli"

{thailint-0.3.0 → thailint-0.3.2}/src/cli.py

@@ -1077,5 +1077,106 @@ def _run_dry_lint(orchestrator, path_objs, recursive):
     return dry_violations
 
 
+def _setup_magic_numbers_orchestrator(
+    path_objs: list[Path], config_file: str | None, verbose: bool
+):
+    """Set up orchestrator for magic-numbers command."""
+    first_path = path_objs[0] if path_objs else Path.cwd()
+    project_root = first_path if first_path.is_dir() else first_path.parent
+
+    from src.orchestrator.core import Orchestrator
+
+    orchestrator = Orchestrator(project_root=project_root)
+
+    if config_file:
+        _load_config_file(orchestrator, config_file, verbose)
+
+    return orchestrator
+
+
+def _run_magic_numbers_lint(orchestrator, path_objs: list[Path], recursive: bool):
+    """Execute magic-numbers lint on files or directories."""
+    all_violations = _execute_linting_on_paths(orchestrator, path_objs, recursive)
+    return [v for v in all_violations if "magic-number" in v.rule_id]
+
+
+@cli.command("magic-numbers")
+@click.argument("paths", nargs=-1, type=click.Path())
+@click.option("--config", "-c", "config_file", type=click.Path(), help="Path to config file")
+@format_option
+@click.option("--recursive/--no-recursive", default=True, help="Scan directories recursively")
+@click.pass_context
+def magic_numbers(  # pylint: disable=too-many-arguments,too-many-positional-arguments
+    ctx,
+    paths: tuple[str, ...],
+    config_file: str | None,
+    format: str,
+    recursive: bool,
+):
+    """Check for magic numbers in code.
+
+    Detects unnamed numeric literals in Python and TypeScript/JavaScript code
+    that should be extracted as named constants for better readability.
+
+    PATHS: Files or directories to lint (defaults to current directory if none provided)
+
+    Examples:
+
+        \b
+        # Check current directory (all files recursively)
+        thai-lint magic-numbers
+
+        \b
+        # Check specific directory
+        thai-lint magic-numbers src/
+
+        \b
+        # Check single file
+        thai-lint magic-numbers src/app.py
+
+        \b
+        # Check multiple files
+        thai-lint magic-numbers src/app.py src/utils.py tests/test_app.py
+
+        \b
+        # Check mix of files and directories
+        thai-lint magic-numbers src/app.py tests/
+
+        \b
+        # Get JSON output
+        thai-lint magic-numbers --format json .
+
+        \b
+        # Use custom config file
+        thai-lint magic-numbers --config .thailint.yaml src/
+    """
+    verbose = ctx.obj.get("verbose", False)
+
+    if not paths:
+        paths = (".",)
+
+    path_objs = [Path(p) for p in paths]
+
+    try:
+        _execute_magic_numbers_lint(path_objs, config_file, format, recursive, verbose)
+    except Exception as e:
+        _handle_linting_error(e, verbose)
+
+
+def _execute_magic_numbers_lint(  # pylint: disable=too-many-arguments,too-many-positional-arguments
+    path_objs, config_file, format, recursive, verbose
+):
+    """Execute magic-numbers lint."""
+    _validate_paths_exist(path_objs)
+    orchestrator = _setup_magic_numbers_orchestrator(path_objs, config_file, verbose)
+    magic_numbers_violations = _run_magic_numbers_lint(orchestrator, path_objs, recursive)
+
+    if verbose:
+        logger.info(f"Found {len(magic_numbers_violations)} magic number violation(s)")
+
+    format_violations(magic_numbers_violations, format)
+    sys.exit(1 if magic_numbers_violations else 0)
+
+
 if __name__ == "__main__":
     cli()