thailint 0.2.0__py3-none-any.whl → 0.5.0__py3-none-any.whl

{thailint-0.2.0.dist-info → thailint-0.5.0.dist-info}/METADATA

@@ -1,8 +1,9 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.4
 Name: thailint
-Version: 0.2.0
+Version: 0.5.0
 Summary: The AI Linter - Enterprise-grade linting and governance for AI-generated code across multiple languages
 License: MIT
+License-File: LICENSE
 Keywords: linter,ai,code-quality,static-analysis,file-placement,governance,multi-language,cli,docker,python
 Author: Steve Jackson
 Requires-Python: >=3.11,<4.0
@@ -15,6 +16,7 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Software Development :: Quality Assurance
@@ -26,7 +28,7 @@ Requires-Dist: pyprojroot (>=0.3.0,<0.4.0)
 Requires-Dist: pyyaml (>=6.0,<7.0)
 Requires-Dist: tree-sitter (>=0.25.2,<0.26.0)
 Requires-Dist: tree-sitter-typescript (>=0.23.2,<0.24.0)
-Project-URL: Documentation, https://github.com/be-wise-be-kind/thai-lint#readme
+Project-URL: Documentation, https://thai-lint.readthedocs.io/
 Project-URL: Homepage, https://github.com/be-wise-be-kind/thai-lint
 Project-URL: Repository, https://github.com/be-wise-be-kind/thai-lint
 Description-Content-Type: text/markdown
@@ -35,19 +37,47 @@ 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-393%2F393%20passing-brightgreen.svg)](tests/)
+[![Coverage](https://img.shields.io/badge/coverage-87%25-brightgreen.svg)](htmlcov/)
+[![Documentation Status](https://readthedocs.org/projects/thai-lint/badge/?version=latest)](https://thai-lint.readthedocs.io/en/latest/?badge=latest)
 
 The AI Linter - Enterprise-ready linting and governance for AI-generated code across multiple languages.
 
+## Documentation
+
+**New to thailint?** Start here:
+- **[Quick Start Guide](https://thai-lint.readthedocs.io/en/latest/quick-start/)** - Get running in 5 minutes
+- **[Configuration Reference](https://thai-lint.readthedocs.io/en/latest/configuration/)** - Complete config options for all linters
+- **[Troubleshooting Guide](https://thai-lint.readthedocs.io/en/latest/troubleshooting/)** - Common issues and solutions
+
+**Full Documentation:** Browse the **[documentation site](https://thai-lint.readthedocs.io/)** for comprehensive guides covering installation, all linters, configuration patterns, and integration examples.
+
 ## 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.
+
+**Complete documentation available at [thai-lint.readthedocs.io](https://thai-lint.readthedocs.io/)** covering installation, configuration, all linters, and troubleshooting.
 
 ## Features
 
 ### Core Capabilities
 - **File Placement Linting** - Enforce project structure and organization
+- **Magic Numbers Linting** - Detect unnamed numeric literals that should be constants
+  - Python and TypeScript support with AST analysis
+  - Context-aware detection (ignores constants, test files, range() usage)
+  - Configurable allowed numbers and thresholds
+  - Helpful suggestions for extracting to named constants
 - **Nesting Depth Linting** - Detect excessive code nesting with AST analysis
   - Python and TypeScript support with tree-sitter
   - Configurable max depth (default: 4, recommended: 3)
@@ -57,8 +87,8 @@ thailint is a modern, enterprise-ready multi-language linter designed specifical
   - Language-specific thresholds (Python, TypeScript, JavaScript)
   - Refactoring patterns from real-world examples
 - **DRY Linting** - Detect duplicate code across projects
-  - Token-based hash detection with SQLite caching
-  - Fast incremental scans (10-50x speedup with cache)
+  - Token-based hash detection with SQLite storage
+  - Fast duplicate detection (in-memory or disk-backed)
   - Configurable thresholds (lines, tokens, occurrences)
   - Language-specific detection (Python, TypeScript, JavaScript)
   - False positive filtering (keyword args, imports)
@@ -92,7 +122,7 @@ cd thai-lint
 pip install -e ".[dev]"
 ```
 
-### From PyPI (once published)
+### From PyPI
 
 ```bash
 pip install thai-lint
@@ -125,6 +155,9 @@ thailint nesting src/
 # Check for duplicate code
 thailint dry .
 
+# Check for magic numbers
+thailint magic-numbers src/
+
 # With config file
 thailint dry --config .thailint.yaml src/
 
@@ -132,6 +165,8 @@ thailint dry --config .thailint.yaml src/
 thailint dry --format json src/
 ```
 
+**New to thailint?** See the **[Quick Start Guide](https://thai-lint.readthedocs.io/en/latest/quick-start/)** for a complete walkthrough including config generation, understanding output, and next steps.
+
 ### Library Mode
 
 ```python
@@ -169,6 +204,44 @@ docker run --rm -v $(pwd):/data \
   washad/thailint:latest nesting /data/src
 ```
 
+### Docker with Sibling Directories
+
+For Docker environments with sibling directories (e.g., separate config and source directories), use `--project-root` or config path inference:
+
+```bash
+# Directory structure:
+# /workspace/
+# ├── root/           # Contains .thailint.yaml and .git
+# ├── backend/        # Code to lint
+# └── tools/
+
+# Option 1: Explicit project root (recommended)
+docker run --rm -v $(pwd):/data \
+  washad/thailint:latest \
+  --project-root /data/root \
+  magic-numbers /data/backend/
+
+# Option 2: Config path inference (automatic)
+docker run --rm -v $(pwd):/data \
+  washad/thailint:latest \
+  --config /data/root/.thailint.yaml \
+  magic-numbers /data/backend/
+
+# With ignore patterns resolving from project root
+docker run --rm -v $(pwd):/data \
+  washad/thailint:latest \
+  --project-root /data/root \
+  --config /data/root/.thailint.yaml \
+  magic-numbers /data/backend/
+```
+
+**Priority order:**
+1. `--project-root` (highest priority - explicit specification)
+2. Inferred from `--config` path directory
+3. Auto-detection from file location (fallback)
+
+See **[Docker Usage](#docker-usage)** section below for more examples.
+
 ## Configuration
 
 Create `.thailint.yaml` in your project root:
@@ -228,14 +301,19 @@ dry:
   python:
     min_occurrences: 3           # Python: require 3+ occurrences
 
-  # Cache settings (SQLite)
-  cache_enabled: true
-  cache_path: ".thailint-cache/dry.db"
+  # Storage settings (SQLite)
+  storage_mode: "memory"         # Options: "memory" (default) or "tempfile"
 
   # Ignore patterns
   ignore:
     - "tests/"
     - "__init__.py"
+
+# Magic numbers linter configuration
+magic-numbers:
+  enabled: true
+  allowed_numbers: [-1, 0, 1, 2, 10, 100, 1000]  # Numbers allowed without constants
+  max_small_integer: 10  # Max value allowed in range() or enumerate()
 ```
 
 **JSON format also supported** (`.thailint.json`):
@@ -268,14 +346,20 @@ dry:
     "python": {
       "min_occurrences": 3
     },
-    "cache_enabled": true,
-    "cache_path": ".thailint-cache/dry.db",
+    "storage_mode": "memory",
     "ignore": ["tests/", "__init__.py"]
+  },
+  "magic-numbers": {
+    "enabled": true,
+    "allowed_numbers": [-1, 0, 1, 2, 10, 100, 1000],
+    "max_small_integer": 10
   }
 }
 ```
 
-See [Configuration Guide](docs/configuration.md) for complete reference.
+See [Configuration Guide](https://thai-lint.readthedocs.io/en/latest/configuration/) for complete reference.
+
+**Need help with ignores?** See **[How to Ignore Violations](https://thai-lint.readthedocs.io/en/latest/how-to-ignore-violations/)** for complete guide to all ignore levels (line, method, class, file, repository).
 
 ## Nesting Depth Linter
 
@@ -361,7 +445,7 @@ Common patterns to reduce nesting:
 - **TypeScript**: Full support (if/for/while/try/switch)
 - **JavaScript**: Supported via TypeScript parser
 
-See [Nesting Linter Guide](docs/nesting-linter.md) for comprehensive documentation and refactoring patterns.
+See [Nesting Linter Guide](https://thai-lint.readthedocs.io/en/latest/nesting-linter/) for comprehensive documentation and refactoring patterns.
 
 ## Single Responsibility Principle (SRP) Linter
 
@@ -478,13 +562,13 @@ Common patterns to fix SRP violations (discovered during dogfooding):
 - **After**: Extract Class pattern applied - 5 focused classes (ConfigLoader, PatternValidator, RuleChecker, PathResolver, FilePlacementLinter)
 - **Result**: Each class ≤8 methods, ≤150 LOC, single responsibility
 
-See [SRP Linter Guide](docs/srp-linter.md) for comprehensive documentation and refactoring patterns.
+See [SRP Linter Guide](https://thai-lint.readthedocs.io/en/latest/srp-linter/) for comprehensive documentation and refactoring patterns.
 
 ## DRY Linter (Don't Repeat Yourself)
 
 ### Overview
 
-The DRY linter detects duplicate code blocks across your entire project using token-based hashing with SQLite caching. It identifies identical or near-identical code that violates the Don't Repeat Yourself (DRY) principle, helping maintain code quality at scale.
+The DRY linter detects duplicate code blocks across your entire project using token-based hashing with SQLite storage. It identifies identical or near-identical code that violates the Don't Repeat Yourself (DRY) principle, helping maintain code quality at scale.
 
 ### Quick Start
 
@@ -495,8 +579,8 @@ thailint dry .
 # Use custom thresholds
 thailint dry --min-lines 5 src/
 
-# Clear cache and re-scan
-thailint dry --clear-cache src/
+# Use tempfile storage for large projects
+thailint dry --storage-mode tempfile src/
 
 # Get JSON output
 thailint dry --format json src/
@@ -519,10 +603,8 @@ dry:
   typescript:
     min_occurrences: 3           # TypeScript: require 3+ occurrences
 
-  # Cache settings (SQLite for fast incremental scans)
-  cache_enabled: true
-  cache_path: ".thailint-cache/dry.db"
-  cache_max_age_days: 30
+  # Storage settings
+  storage_mode: "memory"         # Options: "memory" (default) or "tempfile"
 
   # Ignore patterns
   ignore:
@@ -543,11 +625,11 @@ dry:
 3. Store hashes in SQLite database with file locations
 4. Query for hashes appearing 2+ times across project
 
-**SQLite Caching:**
-- First scan: Hash all files (~1-3s for 1000 files)
-- Subsequent scans: Load cached hashes for unchanged files (~0.1-0.5s)
-- 10-50x speedup for incremental scans
-- Mtime-based cache invalidation (automatic and safe)
+**SQLite Storage:**
+- In-memory mode (default): Stores in RAM for best performance
+- Tempfile mode: Stores in temporary disk file for large projects
+- Fresh analysis on every run (no persistence between runs)
+- Fast duplicate detection using B-tree indexes
 
 ### Example Violation
 
@@ -605,31 +687,14 @@ def validate_admin(admin_data):
     return validate_credentials(admin_data)
 ```
 
-### Cache Management
-
-```bash
-# Normal cached run (default)
-thailint dry src/
-
-# Force re-analysis (ignore cache)
-thailint dry --no-cache src/
-
-# Clear cache before running
-thailint dry --clear-cache src/
-
-# Manual cache cleanup
-rm -rf .thailint-cache/dry.db
-```
-
 ### Performance
 
-| Operation | Performance | Cache Status |
+| Operation | Performance | Storage Mode |
 |-----------|-------------|--------------|
-| First scan (1000 files) | 1-3s | Cache write |
-| Unchanged files | 0.1-0.5s | Cache hit |
-| 50 changed files | 0.5-1s | Partial cache |
+| Scan (1000 files) | 1-3s | Memory (default) |
+| Large project (5000+ files) | Use tempfile mode | Tempfile |
 
-**Speedup**: 3-10x for incremental scans with cache
+**Note**: Every run analyzes files fresh - no persistence between runs ensures accurate results
 
 ### Language Support
 
@@ -650,7 +715,159 @@ Built-in filters automatically exclude common non-duplication patterns:
 3. **Extract Utility Module**: Move helper functions to shared utilities
 4. **Template Method**: Use function parameters for variations
 
-See [DRY Linter Guide](docs/dry-linter.md) for comprehensive documentation, cache management, and refactoring patterns.
+See [DRY Linter Guide](https://thai-lint.readthedocs.io/en/latest/dry-linter/) for comprehensive documentation, storage modes, and refactoring patterns.
+
+## Magic Numbers Linter
+
+### Overview
+
+The magic numbers linter detects unnamed numeric literals (magic numbers) that should be extracted to named constants. It uses AST analysis to identify numeric literals that lack meaningful context.
+
+### What are Magic Numbers?
+
+**Magic numbers** are unnamed numeric literals in code without explanation:
+
+```python
+# Bad - Magic numbers
+timeout = 3600  # What is 3600?
+max_retries = 5  # Why 5?
+
+# Good - Named constants
+TIMEOUT_SECONDS = 3600
+MAX_RETRY_ATTEMPTS = 5
+```
+
+### Quick Start
+
+```bash
+# Check for magic numbers in current directory
+thailint magic-numbers .
+
+# Check specific directory
+thailint magic-numbers src/
+
+# Get JSON output
+thailint magic-numbers --format json src/
+```
+
+### Configuration
+
+Add to `.thailint.yaml`:
+
+```yaml
+magic-numbers:
+  enabled: true
+  allowed_numbers: [-1, 0, 1, 2, 10, 100, 1000]
+  max_small_integer: 10  # Max for range() to be acceptable
+```
+
+### Example Violation
+
+**Code with magic numbers:**
+```python
+def calculate_timeout():
+    return 3600  # Magic number - what is 3600?
+
+def process_items(items):
+    for i in range(100):  # Magic number - why 100?
+        items[i] *= 1.5  # Magic number - what is 1.5?
+```
+
+**Violation messages:**
+```
+src/example.py:2 - Magic number 3600 should be a named constant
+src/example.py:5 - Magic number 100 should be a named constant
+src/example.py:6 - Magic number 1.5 should be a named constant
+```
+
+**Refactored code:**
+```python
+TIMEOUT_SECONDS = 3600
+MAX_ITEMS = 100
+PRICE_MULTIPLIER = 1.5
+
+def calculate_timeout():
+    return TIMEOUT_SECONDS
+
+def process_items(items):
+    for i in range(MAX_ITEMS):
+        items[i] *= PRICE_MULTIPLIER
+```
+
+### Acceptable Contexts
+
+The linter **does not** flag numbers in these contexts:
+
+| Context | Example | Why Acceptable |
+|---------|---------|----------------|
+| Constants | `MAX_SIZE = 100` | UPPERCASE name provides context |
+| Small `range()` | `range(5)` | Small loop bounds are clear |
+| Test files | `test_*.py` | Test data can be literal |
+| Allowed numbers | `-1, 0, 1, 2, 10` | Common values are self-explanatory |
+
+### Refactoring Patterns
+
+**Pattern 1: Extract to Module Constants**
+```python
+# Before
+def connect():
+    timeout = 30
+    retries = 3
+
+# After
+DEFAULT_TIMEOUT_SECONDS = 30
+DEFAULT_MAX_RETRIES = 3
+
+def connect():
+    timeout = DEFAULT_TIMEOUT_SECONDS
+    retries = DEFAULT_MAX_RETRIES
+```
+
+**Pattern 2: Extract with Units in Name**
+```python
+# Before
+delay = 3600  # Is this seconds? Minutes?
+
+# After
+TASK_DELAY_SECONDS = 3600  # Clear unit
+
+delay = TASK_DELAY_SECONDS
+```
+
+**Pattern 3: Use Standard Library**
+```python
+# Before
+if status == 200:
+    return "success"
+
+# After
+from http import HTTPStatus
+
+if status == HTTPStatus.OK:
+    return "success"
+```
+
+### Language Support
+
+- **Python**: Full support (int, float, scientific notation)
+- **TypeScript**: Full support (int, float, scientific notation)
+- **JavaScript**: Supported via TypeScript parser
+
+### Ignoring Violations
+
+```python
+# Line-level ignore
+timeout = 3600  # thailint: ignore[magic-numbers] - Industry standard
+
+# Method-level ignore
+def get_ports():  # thailint: ignore[magic-numbers] - Standard ports
+    return {80: "HTTP", 443: "HTTPS"}
+
+# File-level ignore
+# thailint: ignore-file[magic-numbers]
+```
+
+See **[How to Ignore Violations](https://thai-lint.readthedocs.io/en/latest/how-to-ignore-violations/)** and **[Magic Numbers Linter Guide](https://thai-lint.readthedocs.io/en/latest/magic-numbers-linter/)** for complete documentation.
 
 ## Pre-commit Hooks
 
@@ -712,7 +929,7 @@ repos:
         pass_filenames: true
 ```
 
-See **[Pre-commit Hooks Guide](docs/pre-commit-hooks.md)** for complete documentation, troubleshooting, and advanced configuration.
+See **[Pre-commit Hooks Guide](https://thai-lint.readthedocs.io/en/latest/pre-commit-hooks/)** for complete documentation, troubleshooting, and advanced configuration.
 
 ## Common Use Cases
 
@@ -765,51 +982,100 @@ 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
 
-# Format code
-ruff format src tests
+# Complexity analysis (Radon + Xenon + Nesting)
+just lint-complexity
 
-# Type checking
-mypy src/
+# 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
 ```
 
-### Building
+### Dogfooding (Lint Our Own Code)
+
+```bash
+# Lint file placement
+just lint-placement
+
+# Check nesting depth
+just lint-nesting
+
+# Check for magic numbers
+poetry run thai-lint magic-numbers src/
+```
+
+### 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
 
+### Basic Docker Commands
+
 ```bash
 # Pull published image
 docker pull washad/thailint:latest
@@ -838,22 +1104,62 @@ docker run --rm -v $(pwd):/data \
     washad/thailint:latest file-placement --format json /data
 ```
 
+### Docker with Sibling Directories (Advanced)
+
+For complex Docker setups with sibling directories, use `--project-root` for explicit control:
+
+```bash
+# Scenario: Monorepo with separate config and code directories
+# Directory structure:
+# /workspace/
+# ├── config/           # Contains .thailint.yaml
+# ├── backend/app/      # Python backend code
+# ├── frontend/         # TypeScript frontend
+# └── tools/            # Build tools
+
+# Explicit project root (recommended for Docker)
+docker run --rm -v /path/to/workspace:/workspace \
+  washad/thailint:latest \
+  --project-root /workspace/config \
+  magic-numbers /workspace/backend/
+
+# Config path inference (automatic - no --project-root needed)
+docker run --rm -v /path/to/workspace:/workspace \
+  washad/thailint:latest \
+  --config /workspace/config/.thailint.yaml \
+  magic-numbers /workspace/backend/
+
+# Lint multiple sibling directories with shared config
+docker run --rm -v /path/to/workspace:/workspace \
+  washad/thailint:latest \
+  --project-root /workspace/config \
+  nesting /workspace/backend/ /workspace/frontend/
+```
+
+**When to use `--project-root` in Docker:**
+- **Sibling directory structures** - When config/code aren't nested
+- **Monorepos** - Multiple projects sharing one config
+- **CI/CD** - Explicit paths prevent auto-detection issues
+- **Ignore patterns** - Ensures patterns resolve from correct base directory
+
 ## Documentation
 
 ### Comprehensive Guides
 
-- **[Getting Started](docs/getting-started.md)** - Installation, first lint, basic config
-- **[Configuration Reference](docs/configuration.md)** - Complete config options (YAML/JSON)
-- **[API Reference](docs/api-reference.md)** - Library API documentation
-- **[CLI Reference](docs/cli-reference.md)** - All CLI commands and options
-- **[Deployment Modes](docs/deployment-modes.md)** - CLI, Library, and Docker usage
-- **[File Placement Linter](docs/file-placement-linter.md)** - Detailed linter guide
-- **[Nesting Depth Linter](docs/nesting-linter.md)** - Nesting depth analysis guide
-- **[SRP Linter](docs/srp-linter.md)** - Single Responsibility Principle guide
-- **[DRY Linter](docs/dry-linter.md)** - Duplicate code detection guide
-- **[Pre-commit Hooks](docs/pre-commit-hooks.md)** - Automated quality checks
-- **[Publishing Guide](docs/releasing.md)** - Release and publishing workflow
-- **[Publishing Checklist](docs/publishing-checklist.md)** - Post-publication validation
+- **[Getting Started](https://thai-lint.readthedocs.io/en/latest/getting-started/)** - Installation, first lint, basic config
+- **[Configuration Reference](https://thai-lint.readthedocs.io/en/latest/configuration/)** - Complete config options (YAML/JSON)
+- **[How to Ignore Violations](https://thai-lint.readthedocs.io/en/latest/how-to-ignore-violations/)** - Complete guide to all ignore levels
+- **[API Reference](https://thai-lint.readthedocs.io/en/latest/api-reference/)** - Library API documentation
+- **[CLI Reference](https://thai-lint.readthedocs.io/en/latest/cli-reference/)** - All CLI commands and options
+- **[Deployment Modes](https://thai-lint.readthedocs.io/en/latest/deployment-modes/)** - CLI, Library, and Docker usage
+- **[File Placement Linter](https://thai-lint.readthedocs.io/en/latest/file-placement-linter/)** - Detailed linter guide
+- **[Magic Numbers Linter](https://thai-lint.readthedocs.io/en/latest/magic-numbers-linter/)** - Magic numbers detection guide
+- **[Nesting Depth Linter](https://thai-lint.readthedocs.io/en/latest/nesting-linter/)** - Nesting depth analysis guide
+- **[SRP Linter](https://thai-lint.readthedocs.io/en/latest/srp-linter/)** - Single Responsibility Principle guide
+- **[DRY Linter](https://thai-lint.readthedocs.io/en/latest/dry-linter/)** - Duplicate code detection guide
+- **[Pre-commit Hooks](https://thai-lint.readthedocs.io/en/latest/pre-commit-hooks/)** - Automated quality checks
+- **[Publishing Guide](https://thai-lint.readthedocs.io/en/latest/releasing/)** - Release and publishing workflow
+- **[Publishing Checklist](https://thai-lint.readthedocs.io/en/latest/publishing-checklist/)** - Post-publication validation
 
 ### Examples