thailint 0.4.1__tar.gz → 0.14.0__tar.gz

{thailint-0.4.1 → thailint-0.14.0}/CHANGELOG.md

@@ -24,6 +24,122 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- **Stateless Class Linter** - Detect Python classes without state that should be module-level functions
+  - AST-based detection of classes without `__init__`/`__new__` constructors
+  - Detects classes without instance state (`self.attr` assignments)
+  - Excludes ABC, Protocol, and decorated classes (legitimate patterns)
+  - Excludes classes with class-level attributes
+  - Minimum 2 methods required to flag (avoids false positives on simple wrappers)
+  - CLI command: `thailint stateless-class src/`
+  - JSON and SARIF output formats
+  - Configuration via `.thailint.yaml` with `min_methods` and `ignore` options
+  - Self-dogfooded: 23 violations in thai-lint codebase were fixed
+  - 28 tests (15 detector + 13 CLI) with 100% pass rate
+  - Documentation: `docs/stateless-class-linter.md`
+
+- **Project Root Detection System** - Three-level precedence system for accurate configuration and ignore pattern resolution
+  - `--project-root` CLI option for explicit project root specification (highest priority)
+  - Automatic project root inference from `--config` path (config's parent directory becomes project root)
+  - Auto-detection fallback that walks up from file location to find markers (`.git`, `.thailint.yaml`, `pyproject.toml`)
+  - Priority order: `--project-root` > config inference > auto-detection
+  - Click path validation (exists, is directory) with helpful error messages
+  - All paths resolved to absolute paths immediately for consistency
+
+- **Docker Sibling Directory Support** - Solves critical Docker use case where config and code are in separate directories
+  - Explicit project root specification: `docker run -v $(pwd):/workspace thailint --project-root /workspace/root magic-numbers /workspace/backend/`
+  - Automatic config path inference: `docker run -v $(pwd):/workspace thailint --config /workspace/root/.thailint.yaml magic-numbers /workspace/backend/`
+  - Monorepo support with shared configuration across multiple projects
+  - CI/CD-friendly with explicit paths preventing auto-detection issues
+
+- **Enhanced Configuration System**
+  - Config loading now respects project root context
+  - Ignore patterns resolve relative to project root (not file location)
+  - Config search paths: explicit `--config` > project-root/.thailint.yaml > auto-detected locations
+  - Pyprojroot fallback for test environment compatibility
+
+- **Test Suite**
+  - 42 tests for project root detection (29 new + 13 updated, 100% passing)
+  - `tests/unit/test_cli_project_root.py` - Explicit `--project-root` tests (15 tests)
+  - `tests/unit/test_cli_config_inference.py` - Config path inference tests (14 tests)
+  - Priority order tests verifying explicit > inferred > auto-detection
+  - Error handling tests for invalid paths (doesn't exist, is file not directory)
+  - Integration tests with real directory structures
+
+### Changed
+
+- **CLI Commands** - All linter commands now accept `--project-root` option
+  - `thailint magic-numbers --project-root PATH [TARGET]`
+  - `thailint nesting --project-root PATH [TARGET]`
+  - `thailint srp --project-root PATH [TARGET]`
+  - `thailint file-placement --project-root PATH [TARGET]`
+  - All commands support combined usage: `--project-root` with `--config`
+
+- **Orchestrator Initialization** - Now accepts explicit project root parameter
+  - `Orchestrator(project_root=Path, config_path=Path)` signature
+  - Project root passed from CLI to orchestrator for all linting operations
+  - Config loading uses project root context for path resolution
+
+- **Path Resolution** - All ignore patterns resolve relative to project root
+  - Previous behavior: patterns resolved relative to file being linted
+  - New behavior: patterns resolved relative to project root directory
+  - More predictable and consistent ignore pattern matching
+  - Better Docker compatibility with volume mounts
+
+### Documentation
+
+- **README.md** - Added comprehensive Docker sibling directory examples
+  - "Docker with Sibling Directories" section (lines 171-207)
+  - "Docker with Sibling Directories (Advanced)" section (lines 1071-1107)
+  - Directory structure examples and use cases
+  - Priority order explanation with multiple solution approaches
+
+- **CLI Reference** (docs/cli-reference.md)
+  - Complete `--project-root` option documentation (lines 120-170)
+  - Enhanced `--config` section explaining automatic project root inference (lines 92-118)
+  - Use case examples: Docker, monorepos, CI/CD, ignore patterns
+  - Error handling examples and exit codes
+  - Priority order documentation
+
+- **Troubleshooting Guide** (docs/troubleshooting.md)
+  - New "Docker sibling directory structure not working" section (lines 754-856)
+  - Problem symptoms and root cause explanation
+  - Three solution approaches ranked by recommendation
+  - Debugging steps with test commands
+  - Cross-references to related documentation
+
+- **Technical Architecture** (.ai/docs/python-cli-architecture.md)
+  - New "Project Root Detection" component documentation (section 2)
+  - Architecture diagram updated with project root detection layer
+  - Design decisions and implementation patterns
+  - Testing strategy and related components
+  - Docker use case examples and configuration integration
+
+### Fixed
+
+- **Docker Sibling Directory Issue** - Config and code can now be in separate, non-nested directories
+  - Previous: Only worked when code was nested under config directory
+  - Fixed: Works with any directory structure using `--project-root` or config inference
+  - Ignore patterns now resolve correctly in Docker volume mount scenarios
+
+- **Ignore Pattern Resolution** - Patterns now resolve consistently relative to project root
+  - Previous: Resolved relative to file being linted (inconsistent behavior)
+  - Fixed: Resolved relative to project root (predictable, consistent)
+  - Especially important for Docker and monorepo scenarios
+
+- **Test Environment Compatibility** - Added pyprojroot fallback for pytest environments
+  - Tests can run in isolated temporary directories
+  - Auto-detection gracefully handles test scenarios without project markers
+  - No impact on production code behavior
+
+### Infrastructure
+
+- Test suite execution time: All tests pass in <120ms (optimized for fast feedback)
+- TDD approach: RED tests → GREEN implementation → Documentation
+- Pre-commit hooks validated for all changes
+- Zero regressions in existing functionality (13 existing tests updated, all passing)
+
 ## [0.2.1] - 2025-10-09
 
 **Docker Path Validation Fix** - Fixes critical Docker image bug where file-specific linting failed due to premature path validation.

thailint-0.14.0/PKG-INFO

@@ -0,0 +1,185 @@
+Metadata-Version: 2.4
+Name: thailint
+Version: 0.14.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,performance,typescript
+Author: Steve Jackson
+Requires-Python: >=3.11,<4.0
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+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
+Classifier: Topic :: Software Development :: Testing
+Classifier: Topic :: Utilities
+Classifier: Typing :: Typed
+Requires-Dist: click (>=8.1.0,<9.0.0)
+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://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
+
+# thai-lint
+
+[![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/)
+[![PyPI](https://img.shields.io/pypi/v/thai-lint)](https://pypi.org/project/thai-lint/)
+[![Documentation](https://readthedocs.org/projects/thai-lint/badge/?version=latest)](https://thai-lint.readthedocs.io/)
+
+**The AI Linter** - Catch the mistakes AI coding assistants keep making.
+
+thailint detects anti-patterns that AI tools frequently introduce: duplicate code, excessive nesting, magic numbers, SRP violations, and more. It works across Python, TypeScript, and JavaScript with unified rules - filling gaps that existing linters miss.
+
+## Installation
+
+```bash
+pip install thai-lint
+```
+
+Or with Docker:
+```bash
+docker run --rm -v $(pwd):/data washad/thailint:latest --help
+```
+
+## Quick Start
+
+```bash
+# Generate a config file (optional)
+thailint init-config
+
+# Run any linter
+thailint dry src/
+```
+
+That's it. See violations, fix them, ship better code.
+
+## Available Linters
+
+| Linter | What It Catches | Command | Docs |
+|--------|-----------------|---------|------|
+| **DRY** | Duplicate code across files | `thailint dry src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/dry-linter/) |
+| **Nesting** | Deeply nested if/for/while blocks | `thailint nesting src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/nesting-linter/) |
+| **Magic Numbers** | Unnamed numeric literals | `thailint magic-numbers src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/magic-numbers-linter/) |
+| **Performance** | O(n²) patterns: string += in loops, regex in loops | `thailint perf src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/performance-linter/) |
+| **SRP** | Classes doing too much | `thailint srp src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/srp-linter/) |
+| **File Header** | Missing documentation headers | `thailint file-header src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/file-header-linter/) |
+| **Stateless Class** | Classes that should be functions | `thailint stateless-class src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/stateless-class-linter/) |
+| **Collection Pipeline** | Loops with embedded filtering | `thailint pipeline src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/collection-pipeline-linter/) |
+| **Method Property** | Methods that should be @property | `thailint method-property src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/method-property-linter/) |
+| **File Placement** | Files in wrong directories | `thailint file-placement src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/file-placement-linter/) |
+| **Lazy Ignores** | Unjustified linting suppressions | `thailint lazy-ignores src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/lazy-ignores-linter/) |
+| **Print Statements** | Debug prints left in code | `thailint print-statements src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/print-statements-linter/) |
+| **Stringly Typed** | Strings that should be enums | `thailint stringly-typed src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/stringly-typed-linter/) |
+
+## Configuration
+
+Create `.thailint.yaml` in your project root:
+
+```yaml
+dry:
+  enabled: true
+  min_duplicate_lines: 4
+
+nesting:
+  enabled: true
+  max_nesting_depth: 3
+
+magic-numbers:
+  enabled: true
+  allowed_numbers: [-1, 0, 1, 2, 10, 100]
+```
+
+Or generate one automatically:
+```bash
+thailint init-config --preset lenient  # or: strict, standard
+```
+
+See [Configuration Reference](https://thai-lint.readthedocs.io/en/latest/configuration/) for all options.
+
+## Output Formats
+
+```bash
+# Human-readable (default)
+thailint dry src/
+
+# JSON for CI/CD
+thailint dry --format json src/
+
+# SARIF for GitHub Code Scanning
+thailint dry --format sarif src/ > results.sarif
+```
+
+## Ignoring Violations
+
+```python
+# Line-level
+timeout = 3600  # thailint: ignore[magic-numbers]
+
+# File-level
+# thailint: ignore-file[dry]
+```
+
+Or in config:
+```yaml
+dry:
+  ignore:
+    - "tests/"
+    - "**/generated/**"
+```
+
+See [How to Ignore Violations](https://thai-lint.readthedocs.io/en/latest/how-to-ignore-violations/) for all 5 ignore levels.
+
+## CI/CD Integration
+
+```yaml
+# GitHub Actions
+- name: Run thailint
+  run: |
+    pip install thai-lint
+    thailint dry src/
+    thailint nesting src/
+```
+
+Exit codes: `0` = success, `1` = violations found, `2` = error.
+
+## Documentation
+
+- **[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/)** - All config options
+- **[Troubleshooting](https://thai-lint.readthedocs.io/en/latest/troubleshooting/)** - Common issues
+- **[Full Documentation](https://thai-lint.readthedocs.io/)** - Everything else
+
+## Contributing
+
+Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+```bash
+git clone https://github.com/be-wise-be-kind/thai-lint.git
+cd thai-lint
+poetry install
+just test
+```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Support
+
+- **Issues**: [github.com/be-wise-be-kind/thai-lint/issues](https://github.com/be-wise-be-kind/thai-lint/issues)
+- **Docs**: [thai-lint.readthedocs.io](https://thai-lint.readthedocs.io/)
+

thailint-0.14.0/README.md

@@ -0,0 +1,149 @@
+# thai-lint
+
+[![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/)
+[![PyPI](https://img.shields.io/pypi/v/thai-lint)](https://pypi.org/project/thai-lint/)
+[![Documentation](https://readthedocs.org/projects/thai-lint/badge/?version=latest)](https://thai-lint.readthedocs.io/)
+
+**The AI Linter** - Catch the mistakes AI coding assistants keep making.
+
+thailint detects anti-patterns that AI tools frequently introduce: duplicate code, excessive nesting, magic numbers, SRP violations, and more. It works across Python, TypeScript, and JavaScript with unified rules - filling gaps that existing linters miss.
+
+## Installation
+
+```bash
+pip install thai-lint
+```
+
+Or with Docker:
+```bash
+docker run --rm -v $(pwd):/data washad/thailint:latest --help
+```
+
+## Quick Start
+
+```bash
+# Generate a config file (optional)
+thailint init-config
+
+# Run any linter
+thailint dry src/
+```
+
+That's it. See violations, fix them, ship better code.
+
+## Available Linters
+
+| Linter | What It Catches | Command | Docs |
+|--------|-----------------|---------|------|
+| **DRY** | Duplicate code across files | `thailint dry src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/dry-linter/) |
+| **Nesting** | Deeply nested if/for/while blocks | `thailint nesting src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/nesting-linter/) |
+| **Magic Numbers** | Unnamed numeric literals | `thailint magic-numbers src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/magic-numbers-linter/) |
+| **Performance** | O(n²) patterns: string += in loops, regex in loops | `thailint perf src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/performance-linter/) |
+| **SRP** | Classes doing too much | `thailint srp src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/srp-linter/) |
+| **File Header** | Missing documentation headers | `thailint file-header src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/file-header-linter/) |
+| **Stateless Class** | Classes that should be functions | `thailint stateless-class src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/stateless-class-linter/) |
+| **Collection Pipeline** | Loops with embedded filtering | `thailint pipeline src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/collection-pipeline-linter/) |
+| **Method Property** | Methods that should be @property | `thailint method-property src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/method-property-linter/) |
+| **File Placement** | Files in wrong directories | `thailint file-placement src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/file-placement-linter/) |
+| **Lazy Ignores** | Unjustified linting suppressions | `thailint lazy-ignores src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/lazy-ignores-linter/) |
+| **Print Statements** | Debug prints left in code | `thailint print-statements src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/print-statements-linter/) |
+| **Stringly Typed** | Strings that should be enums | `thailint stringly-typed src/` | [Guide](https://thai-lint.readthedocs.io/en/latest/stringly-typed-linter/) |
+
+## Configuration
+
+Create `.thailint.yaml` in your project root:
+
+```yaml
+dry:
+  enabled: true
+  min_duplicate_lines: 4
+
+nesting:
+  enabled: true
+  max_nesting_depth: 3
+
+magic-numbers:
+  enabled: true
+  allowed_numbers: [-1, 0, 1, 2, 10, 100]
+```
+
+Or generate one automatically:
+```bash
+thailint init-config --preset lenient  # or: strict, standard
+```
+
+See [Configuration Reference](https://thai-lint.readthedocs.io/en/latest/configuration/) for all options.
+
+## Output Formats
+
+```bash
+# Human-readable (default)
+thailint dry src/
+
+# JSON for CI/CD
+thailint dry --format json src/
+
+# SARIF for GitHub Code Scanning
+thailint dry --format sarif src/ > results.sarif
+```
+
+## Ignoring Violations
+
+```python
+# Line-level
+timeout = 3600  # thailint: ignore[magic-numbers]
+
+# File-level
+# thailint: ignore-file[dry]
+```
+
+Or in config:
+```yaml
+dry:
+  ignore:
+    - "tests/"
+    - "**/generated/**"
+```
+
+See [How to Ignore Violations](https://thai-lint.readthedocs.io/en/latest/how-to-ignore-violations/) for all 5 ignore levels.
+
+## CI/CD Integration
+
+```yaml
+# GitHub Actions
+- name: Run thailint
+  run: |
+    pip install thai-lint
+    thailint dry src/
+    thailint nesting src/
+```
+
+Exit codes: `0` = success, `1` = violations found, `2` = error.
+
+## Documentation
+
+- **[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/)** - All config options
+- **[Troubleshooting](https://thai-lint.readthedocs.io/en/latest/troubleshooting/)** - Common issues
+- **[Full Documentation](https://thai-lint.readthedocs.io/)** - Everything else
+
+## Contributing
+
+Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+```bash
+git clone https://github.com/be-wise-be-kind/thai-lint.git
+cd thai-lint
+poetry install
+just test
+```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Support
+
+- **Issues**: [github.com/be-wise-be-kind/thai-lint/issues](https://github.com/be-wise-be-kind/thai-lint/issues)
+- **Docs**: [thai-lint.readthedocs.io](https://thai-lint.readthedocs.io/)

{thailint-0.4.1 → thailint-0.14.0}/pyproject.toml

@@ -17,14 +17,14 @@ build-backend = "poetry.core.masonry.api"
 
 [tool.poetry]
 name = "thailint"
-version = "0.4.1"
+version = "0.14.0"
 description = "The AI Linter - Enterprise-grade linting and governance for AI-generated code across multiple languages"
 authors = ["Steve Jackson"]
 license = "MIT"
 readme = "README.md"
 homepage = "https://github.com/be-wise-be-kind/thai-lint"
 repository = "https://github.com/be-wise-be-kind/thai-lint"
-documentation = "https://github.com/be-wise-be-kind/thai-lint#readme"
+documentation = "https://thai-lint.readthedocs.io/"
 keywords = [
     "linter",
     "ai",
@@ -36,9 +36,11 @@ keywords = [
     "cli",
     "docker",
     "python",
+    "performance",
+    "typescript",
 ]
 classifiers = [
-    "Development Status :: 3 - Alpha",
+    "Development Status :: 4 - Beta",
     "Intended Audience :: Developers",
     "License :: OSI Approved :: MIT License",
     "Programming Language :: Python :: 3",
@@ -104,8 +106,8 @@ loguru = "^0.7.3"
 pytest-xdist = "^3.8.0"
 
 [tool.poetry.scripts]
-thailint = "src.cli:cli"
-thai-lint = "src.cli:cli"
+thailint = "src.cli_main:cli"
+thai-lint = "src.cli_main:cli"
 
 # Ruff configuration
 [tool.ruff]
@@ -228,6 +230,7 @@ disable = [
 
 [tool.pylint.format]
 max-line-length = 120
+max-module-lines = 500
 
 # Flake8 configuration (in .flake8 file, not pyproject.toml)
 # Note: Flake8 doesn't support pyproject.toml natively

{thailint-0.4.1 → thailint-0.14.0}/src/__init__.py

@@ -19,6 +19,7 @@ Exports: __version__, Linter (high-level API), cli (CLI entry point), load_confi
 Interfaces: Package version string, Linter class API, CLI command group, configuration functions
 """
 
+__version__: str
 try:
     from importlib.metadata import version
 

{thailint-0.4.1 → thailint-0.14.0}/src/analyzers/__init__.py

@@ -9,15 +9,16 @@ Overview: Package containing base analyzer classes for different programming lan
     (TypeScriptBaseAnalyzer, etc.) that linter-specific analyzers extend. Centralizes
     language parsing infrastructure to improve maintainability and consistency.
 
-Dependencies: tree-sitter, language-specific tree-sitter bindings
+Dependencies: tree-sitter, language-specific tree-sitter bindings, ast module
 
-Exports: TypeScriptBaseAnalyzer
+Exports: TypeScriptBaseAnalyzer, build_parent_map
 
 Interfaces: Base analyzer classes with parse(), walk_tree(), and extract() methods
 
 Implementation: Composition-based design for linter analyzers to use base utilities
 """
 
+from .ast_utils import build_parent_map
 from .typescript_base import TypeScriptBaseAnalyzer
 
-__all__ = ["TypeScriptBaseAnalyzer"]
+__all__ = ["TypeScriptBaseAnalyzer", "build_parent_map"]

thailint-0.14.0/src/analyzers/ast_utils.py

@@ -0,0 +1,54 @@
+"""
+Purpose: Common Python AST utilities for linter analyzers
+
+Scope: Shared AST traversal utilities for Python code analysis
+
+Overview: Provides common AST utility functions used across multiple Python linters.
+    Centralizes shared patterns like parent map building to eliminate code duplication.
+    The build_parent_map function creates a dictionary mapping AST nodes to their parents,
+    enabling upward tree traversal for context detection.
+
+Dependencies: ast module for AST node types
+
+Exports: build_parent_map
+
+Interfaces: build_parent_map(tree: ast.AST) -> dict[ast.AST, ast.AST]
+
+Implementation: Recursive AST traversal with parent tracking
+"""
+
+import ast
+
+
+def build_parent_map(tree: ast.AST) -> dict[ast.AST, ast.AST]:
+    """Build a map of AST nodes to their parent nodes.
+
+    Enables upward tree traversal for context detection (e.g., finding if a node
+    is inside a particular block type).
+
+    Args:
+        tree: Root AST node to build map from
+
+    Returns:
+        Dictionary mapping each node to its parent node
+    """
+    parent_map: dict[ast.AST, ast.AST] = {}
+    _build_parent_map_recursive(tree, None, parent_map)
+    return parent_map
+
+
+def _build_parent_map_recursive(
+    node: ast.AST, parent: ast.AST | None, parent_map: dict[ast.AST, ast.AST]
+) -> None:
+    """Recursively build parent map.
+
+    Args:
+        node: Current AST node
+        parent: Parent of current node
+        parent_map: Dictionary to populate
+    """
+    if parent is not None:
+        parent_map[node] = parent
+
+    for child in ast.iter_child_nodes(node):
+        _build_parent_map_recursive(child, node, parent_map)

{thailint-0.4.1 → thailint-0.14.0}/src/analyzers/typescript_base.py

@@ -18,6 +18,10 @@ Exports: TypeScriptBaseAnalyzer class with parsing and traversal utilities
 Interfaces: parse_typescript(code), walk_tree(node, node_type), extract_node_text(node)
 
 Implementation: Tree-sitter parser singleton, recursive AST traversal, composition pattern
+
+Suppressions:
+    - type:ignore[assignment]: Tree-sitter TS_PARSER fallback when import fails
+    - type:ignore[assignment,misc]: Tree-sitter Node type alias (optional dependency fallback)
 """
 
 from typing import Any

thailint-0.14.0/src/cli/__init__.py

@@ -0,0 +1,30 @@
+"""
+Purpose: CLI package entry point and public API for thai-lint command-line interface
+
+Scope: Re-export fully configured CLI with all commands registered
+
+Overview: Provides the public API for the modular CLI package by re-exporting the CLI group from
+    src.cli.main and triggering command registration by importing submodules. Importing from this
+    module (src.cli) gives access to the complete CLI with all commands. Maintains backward
+    compatibility with code that imports from src.cli while enabling modular organization.
+
+Dependencies: src.cli.main for CLI group, src.cli.config for config commands, src.cli.linters
+    for linter commands
+
+Exports: cli (main Click command group with all commands registered)
+
+Interfaces: Single import point for CLI access via 'from src.cli import cli'
+
+Implementation: Imports submodules to trigger command registration via Click decorators
+
+Suppressions:
+    - F401: Module re-exports required for public API interface
+"""
+
+# Import the CLI group from main module
+# Import config and linters to register their commands with the CLI group
+from src.cli import config as _config_module  # noqa: F401
+from src.cli import linters as _linters_module  # noqa: F401
+from src.cli.main import cli  # noqa: F401
+
+__all__ = ["cli"]

thailint-0.14.0/src/cli/__main__.py

@@ -0,0 +1,22 @@
+"""
+Purpose: Entry point for running thai-lint CLI as a module (python -m src.cli)
+
+Scope: Module execution support for direct CLI invocation
+
+Overview: Enables running the CLI via 'python -m src.cli' by invoking the main cli group.
+    This file is executed when the package is run as a module, providing an alternative
+    entry point to the installed 'thailint' command.
+
+Dependencies: src.cli for fully configured CLI
+
+Exports: None (execution entry point only)
+
+Interfaces: Command-line invocation via 'python -m src.cli [command] [args]'
+
+Implementation: Imports and invokes cli() from the package
+"""
+
+from src.cli import cli
+
+if __name__ == "__main__":
+    cli()