pi-autocontext-sports

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

Install from npm:

pi install npm:pi-autocontext-sports@0.71.0

For a project-local install:

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

It adds:

• a consolidated sports_impact tool
• CSV/JSON baseline fixture import
• dataset-derived injury and trade scenario creation
• deterministic front-office trade-feasibility guardrails for salary matching, luxury-tax/apron thresholds, hard caps, aggregation restrictions, roster limits, and optional required salary/payroll/apron source-license provenance
• 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
• reusable invalid external handoff fixture gates that require stable failed check IDs and normalization rejection before downstream analysis
• downstream external handoff fixture-gate CI adoption plans, adoption verification, and adoption registries that generate/verify deterministic GitHub Actions YAML for both valid fixture-pack gates and invalid-fixture gates across projects
• 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 and salary/apron feasibility checks deterministic and inspectable. Feasibility inputs can require source/license provenance for salary, payroll, apron-threshold, and rule-profile values, either embedded in the JSON input or ingested from CSV/JSON fixture files. Feasibility reports are preflights, not legal advice or authoritative CBA rulings.

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, 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, and gate_game_footage_external_handoff_invalid_fixtures when CI needs manifest-backed negative validation coverage with stable failed check IDs. 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, legal advice, authoritative CBA rulings, or guaranteed-performance claims.

After install, ask Pi to use sports_impact to initialize a run, create create_injury_scenario / create_trade_scenario artifacts, verify explicit front-office salary/apron inputs and optional strict financial provenance with verify_trade_feasibility, 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, gate invalid external handoff manifests with gate_game_footage_external_handoff_invalid_fixtures, generate downstream external handoff gate CI YAML with generate_game_footage_external_handoff_gate_ci, verify adopted external handoff gate CI YAML with verify_game_footage_external_handoff_gate_ci, verify downstream adoption registries with verify_game_footage_external_handoff_gate_ci_registry, gate downstream adoption registry policy/drift with gate_game_footage_external_handoff_gate_ci_registry, generate registry-gate CI YAML with generate_game_footage_external_handoff_gate_ci_registry_gate, verify adopted registry-gate CI YAML with verify_game_footage_external_handoff_gate_ci_registry_gate, verify registry-gate CI adoption registries with verify_game_footage_external_handoff_gate_ci_registry_gate_registry, gate registry-gate CI adoption registry policy/drift with gate_game_footage_external_handoff_gate_ci_registry_gate_registry, generate/verify downstream CI YAML for that verifier+gate pair with generate_game_footage_external_handoff_gate_ci_registry_gate_registry_gate / verify_game_footage_external_handoff_gate_ci_registry_gate_registry_gate, verify adoption registries for that generated workflow with verify_game_footage_external_handoff_gate_ci_registry_gate_registry_gate_registry, 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.