feat(farming-analyzer)!: add modular farming analyzer

README.md

@@ -17,6 +17,7 @@ component they operate on:
 ## Included utilities
 
 - `map-checker-qt/`: checksum-pinned map inspection application
+- `farming_analyzer/`: source-derived Classic farming-location analysis
 - `split_symbols.sh` and `stacktrace.py`: native binary diagnostics
 
 Read the Qt checker documentation before using it against a working content

farming_analyzer/__init__.py

@@ -0,0 +1,36 @@
+"""Rank authored Atrinik maps as repeatable monster-farming locations."""
+
+from .analyzer import FarmingAnalyzer
+from .cli import main, simulate_training
+from .config import (
+    ARCH_ROOT,
+    MAP_ROOT,
+    ROOT,
+    SERVER_ROOT,
+    TOOLS_ROOT,
+    WORKSPACE_ROOT,
+)
+from .experience import ExperienceModel
+from .models import AnalysisOptions, MapResult
+from .presentation import _fmt_money, group_farming_results
+from .sources import LocationIndex, flatten, one, parse_blocks
+
+__all__ = [
+    "ARCH_ROOT",
+    "AnalysisOptions",
+    "ExperienceModel",
+    "FarmingAnalyzer",
+    "LocationIndex",
+    "MAP_ROOT",
+    "MapResult",
+    "ROOT",
+    "SERVER_ROOT",
+    "TOOLS_ROOT",
+    "WORKSPACE_ROOT",
+    "flatten",
+    "group_farming_results",
+    "main",
+    "one",
+    "parse_blocks",
+    "simulate_training",
+]

farming_analyzer/__main__.py

@@ -0,0 +1,6 @@
+"""Run the farming analyzer package."""
+
+from .cli import main
+
+
+raise SystemExit(main())