pycheck-neuron 1.0.8__tar.gz → 1.1.1__tar.gz

{pycheck_neuron-1.0.8 → pycheck_neuron-1.1.1}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: pycheck-neuron
-Version: 1.0.8
-Summary: 34-rule static AST analyzer catching temporal lookahead bias, causal confusion, and uncertainty bugs in Python ML code. Zero dependencies.
+Version: 1.1.1
+Summary: 37-rule static AST analyzer catching temporal lookahead bias, causal confusion, and uncertainty bugs in Python ML code. Zero dependencies.
 Author: NEURON Team
 Author-email: Fayo Ibrahim <fayo@neuron-lab.org>
 License-Expression: MIT
@@ -9,7 +9,7 @@ Project-URL: Homepage, https://github.com/neuronlabs-ai/pycheck
 Project-URL: Documentation, https://github.com/neuronlabs-ai/pycheck#readme
 Project-URL: Repository, https://github.com/neuronlabs-ai/pycheck
 Project-URL: Bug Tracker, https://github.com/neuronlabs-ai/pycheck/issues
-Keywords: machine-learning,data-leakage,temporal-bias,lookahead-bias,backtesting,quantitative-finance,algorithmic-trading,linter,static-analysis,causal-inference,time-series,pandas,sklearn,scikit-learn,uncertainty,neuron,ml-safety,data-science,feature-engineering
+Keywords: machine-learning,data-leakage,temporal-bias,lookahead-bias,backtesting,quantitative-finance,algorithmic-trading,linter,static-analysis,causal-inference,time-series,pandas,polars,sarif,github-actions,sklearn,scikit-learn,uncertainty,neuron,ml-safety,data-science,feature-engineering
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.7
 Classifier: Programming Language :: Python :: 3.8
@@ -38,7 +38,7 @@ Dynamic: license-file
 
 # PyCheck — ML Safety Analyzer
 
-**34 rules. Zero dependencies. Catches the bugs that cost millions.**
+**37 rules. Zero dependencies. Catches the bugs that cost millions.**
 
 PyCheck is a static AST analyzer that detects **temporal lookahead bias**, **causal confusion**, and **unguarded uncertainty** in Python ML and trading scripts — before you run a single line of code.
 
@@ -68,7 +68,7 @@ PyCheck catches all three before execution:
 =================================================================
   PyCheck — NEURON ML Safety Analyzer
   Scanning: strategy.py
-  Rules: 34 active + Data Flow & Provenance Engine
+  Rules: 37 active + Data Flow & Provenance Engine
 =================================================================
 
   ERROR[T001]: .shift(-1) accesses data 1 rows INTO THE FUTURE
@@ -123,6 +123,9 @@ PyCheck catches all three before execution:
 | `T017` | Target laundering & un-split target encoding (`regime_success_rate`) | **Error** |
 | `T018` | In-sample target encoding via `.transform()` or un-split group means | **Error** |
 | `T019` | `np.roll(arr, -k)` — negative shift rotates future data into present position | **Error** |
+| `T020` | `KFold(shuffle=True)` or `StratifiedKFold` on chronologically sorted series | **Error** |
+| `T021` | `CalibratedClassifierCV` initialized without a temporal cross-validation splitter | Warning |
+| `T022` | `cross_val_predict()` using shuffled cross-validation on temporal data | Warning |
 
 ### Causal Confusion Rules (7 rules — `C001`–`C007`)
 
@@ -190,7 +193,7 @@ pycheck script.py              # Errors + warnings (default)
 pycheck script.py --info       # Include info-level diagnostics
 pycheck script.py --quiet      # Errors only
 pycheck script.py --json       # JSON output — pipe into CI/CD
-pycheck --list                 # List all 34 rules
+pycheck --list                 # List all 37 rules
 pycheck --help
 ```
 
@@ -286,6 +289,63 @@ GitLab will automatically annotate the Merge Request diff with red warnings on e
 
 ---
 
+## GitHub Code Scanning & SARIF Integration
+
+PyCheck natively exports standard **SARIF v2.1.0** (Static Analysis Results Interchange Format) and GitHub Actions workflow commands, enabling turnkey integration into GitHub Code Scanning and PR annotations.
+
+```bash
+# Export standard SARIF v2.1.0 for GitHub Code Scanning
+pycheck . --sarif -o pycheck.sarif
+
+# Emit GitHub Actions workflow annotations directly in CI logs
+pycheck . --github-actions
+```
+
+### Turnkey `.github/workflows/pycheck.yml`
+
+```yaml
+name: PyCheck ML Safety Guard
+
+on: [push, pull_request]
+
+jobs:
+  pycheck:
+    name: PyCheck Temporal Leak Scan
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install PyCheck
+        run: pip install pycheck-neuron
+
+      - name: Run PyCheck
+        run: pycheck . --sarif -o pycheck.sarif
+
+      - name: Upload SARIF to GitHub Code Scanning
+        uses: github/codeql-action/upload-sarif@v3
+        if: always()
+        with:
+          sarif_file: pycheck.sarif
+```
+
+---
+
+## Polars First-Class Support
+
+PyCheck v1.1.1 includes native AST detection and taint tracking for **Polars** pipelines:
+
+- **Lookahead Fill**: Catches `pl.col().backward_fill()`, `.backward_fill()`, and `.fill_null(strategy="backward")` (`T007`).
+- **Centered Windows**: Catches `rolling_mean(center=True)`, `rolling_std(center=True)`, `rolling_median(center=True)`, etc. (`T009`).
+- **Event Merges**: Catches `.join_asof(strategy="forward")` and `.join_asof(strategy="nearest")` (`T016`).
+- **Dataflow Taint Tracking**: Traces future-tainted Polars expressions into downstream feature matrices and `.fit()` sinks (`F001`).
+
+---
+
 ## Real-World Examples
 
 The `examples/` directory contains recreations of actual ML disasters: