pi-autocontext-sports

Pi package for sports roster-impact analysis using sports-impact-core.

Install from npm:

pi install npm:pi-autocontext-sports@0.60.0

For a project-local install:

pi install npm:pi-autocontext-sports@0.60.0 -l

It adds:

• a consolidated sports_impact tool
• CSV/JSON baseline fixture import
• dataset-derived injury and trade scenario creation
• historical absence/outcome fixture generation for injury backtests
• historical trade/outcome fixture generation for trade backtests
• multi-suite injury and trade calibration reporting
• deterministic trade model parameter tuning and profile comparison
• trade fixture quality validation, case-level provenance, historical fixture-pack audits, input-hash evidence, reproducibility and deterministic rerun verification with drift grouping, configurable regression gates, maturity-aware benchmarks, benchmark comparisons, train/validation/test split generation, readiness gates, holdout scoring, unified audits, and residual diagnostics
• precomputed NBA game-footage tracking analysis for player/ball tracks, quality audit warnings, possession segments/estimates, and court-zone summaries without raw video inference
• deterministic external handoff validation reports for schema/version, metadata, source-system provenance, bbox format, pixel-scale, raw-video boundary, coordinate completeness, detection completeness, and confidence checks
• deterministic external handoff normalization into game-footage-analysis-input/v1, including direct court_feet coordinates and explicit-scale pixel/bbox-center conversion
• deterministic SVG/Markdown court visualizations for selected precomputed frames and track paths
• precomputed Roboflow/YOLO-style, CSV, ByteTrack/Supervision-style detection/tracking, and valid external handoff normalization for game-footage analysis inputs
• game-footage fixture-pack audit/rerun verification with adapter source files including external handoffs, input hashes, validation evidence, normalized-output comparisons, visualization artifact hashes, lifecycle policy scaffolds/conformance checks/run audits/CI adoption generators/adoption verifiers/trend reports/CI-hardened trend gates/trend registries/dashboard aggregation/dashboard adoption checks/dashboard adoption registries, materialized, verified, compared, gated, baseline-checked, promotion-evidenced, promotion-verified, suite-checked, ledger-verified, registry-verified, registry-gated, registry-compared, and registry-comparison-gated SVG/Markdown artifact bundles, and golden quality/possession checks
• deterministic injury/trade simulation and fixture-backed injury/trade backtest actions
• a sports-impact analysis skill
• an NBA roster-impact prompt template

The package is designed to assist analysis runs while keeping numeric projections deterministic and inspectable.

Boundaries and external handoff

Follow the package-local boundary document BOUNDARIES.md, the machine-readable handoff schema schemas/game-footage-external-handoff.schema.json, and the canonical repository boundary contract in docs/BOUNDARIES.md. Game-footage tools accept precomputed court-coordinate tracking/detection outputs only. Use validate_game_footage_external_handoff to report contract readiness, source-system provenance, bbox format, pixel-scale, and raw-video boundary alignment, normalize_external_handoff_game_footage to bridge valid handoffs into the existing analysis input schema before analysis, audit_game_footage_fixture_pack with normalization.adapter: "external_handoff" plus files.externalHandoffInput when that bridge must be audited as fixture-pack evidence, and gate_game_footage_external_handoff_fixture_pack when CI needs a hard pass/fail gate for validation, normalized-input matching, and raw-video boundary checks. The package does not perform raw video inference, object detection, segmentation, homography estimation, or jersey OCR, and it does not provide betting/gambling recommendations, medical advice, or guaranteed-performance claims.

After install, ask Pi to use sports_impact to initialize a run, create create_injury_scenario / create_trade_scenario artifacts, tune trade model parameters with calibrate_trade_model, validate fixtures with validate_fixtures, audit historical fixture packs with audit_trade_fixture_pack, benchmark fixture packs with benchmark_trade_fixture_pack, inspect input hashes, verify benchmark reproducibility with verify_trade_fixture_pack_benchmark, rerun deterministic benchmark verification by adding rerunBenchmark: true, compare benchmark artifacts with compare_trade_fixture_pack_benchmarks, normalize precomputed detections with normalize_roboflow_game_footage, normalize_csv_game_footage, or normalize_tracking_game_footage, validate external handoff contracts with validate_game_footage_external_handoff, normalize valid external handoffs with normalize_external_handoff_game_footage, gate external handoff fixture-pack CI evidence with gate_game_footage_external_handoff_fixture_pack, analyze precomputed tracking outputs with analyze_game_footage, render deterministic court SVGs with render_game_footage_court, materialize fixture-pack visualization artifacts with materialize_game_footage_visualizations, verify materialized visualization bundles with verify_game_footage_visualization_bundle, compare visualization bundles with compare_game_footage_visualization_bundles, gate visualization bundle drift with gate_game_footage_visualization_bundle_drift, check committed visualization baselines with check_game_footage_visualization_baseline, create promotion evidence with promote_game_footage_visualization_baseline, verify promotion evidence with verify_game_footage_visualization_baseline_promotion, check baseline suites with check_game_footage_visualization_baseline_suite, append and verify promotion ledgers with append_game_footage_visualization_baseline_promotion_ledger_entry / verify_game_footage_visualization_baseline_promotion_ledger, verify promotion-ledger registries with verify_game_footage_visualization_baseline_promotion_ledger_registry, gate promotion-ledger registry policy with gate_game_footage_visualization_baseline_promotion_ledger_registry, compare promotion-ledger registries over time with compare_game_footage_visualization_baseline_promotion_ledger_registries, gate registry-comparison policy with gate_game_footage_visualization_baseline_promotion_ledger_registry_comparison, scaffold lifecycle policy presets with scaffold_game_footage_visualization_baseline_lifecycle, verify lifecycle conformance with verify_game_footage_visualization_baseline_lifecycle, audit lifecycle run directories with audit_game_footage_visualization_baseline_lifecycle, generate lifecycle CI adoption YAML with generate_game_footage_visualization_baseline_lifecycle_ci, verify adopted lifecycle CI with verify_game_footage_visualization_baseline_lifecycle_ci, compare lifecycle audit trends with compare_game_footage_visualization_baseline_lifecycle_runs, gate lifecycle trend policy with gate_game_footage_visualization_baseline_lifecycle_trend, verify/gate reusable lifecycle trend registries with verify_game_footage_visualization_baseline_lifecycle_trend_registry / gate_game_footage_visualization_baseline_lifecycle_trend_registry, compare registry history with compare_game_footage_visualization_baseline_lifecycle_trend_registries, gate registry deltas with gate_game_footage_visualization_baseline_lifecycle_trend_registry_comparison using scaffolded policy files, aggregate registry/gate history into a dashboard with create_game_footage_visualization_baseline_lifecycle_dashboard, verify dashboard adoption with verify_game_footage_visualization_baseline_lifecycle_dashboard_adoption, verify/gate/compare dashboard adoption registries with verify_game_footage_visualization_baseline_lifecycle_dashboard_adoption_registry, gate_game_footage_visualization_baseline_lifecycle_dashboard_adoption_registry, compare_game_footage_visualization_baseline_lifecycle_dashboard_adoption_registries, and gate_game_footage_visualization_baseline_lifecycle_dashboard_adoption_registry_comparison, audit game-footage fixture packs with audit_game_footage_fixture_pack (including external handoff validation/normalization evidence and optional visualization artifact hashes), verify deterministic game-footage fixture-pack reruns with verify_game_footage_fixture_pack_rerun, split trade backtests with split_trade_backtests, evaluate readiness gates with evaluate_trade_model_readiness, score reserved holdouts with evaluate_trade_holdout, run unified audits with audit_trade_fixtures, diagnose residuals with diagnose_trade_model, or execute the fixture-backed workflows in examples/nba-injury/, examples/nba-trade/, examples/nba-trade-calibration/, examples/nba-trade-fixture-quality/, examples/nba-trade-historical-template/, and examples/nba-game-footage/. See docs/PI_INSTALL.md in the repository for a full prompt and guardrails.