bbdata-cli 0.2.0 → 0.3.0

package/dist/templates/reports/pro-pitcher-eval.hbs

@@ -1,69 +1,81 @@
-# Pro Pitcher Evaluation: {{player}}
-
-**Season:** {{season}} | **Audience:** {{audience}} | **Generated:** {{date}}
-
----
-
-## Header
-
-| Field | Value |
-|-------|-------|
-| Player | {{player}} |
-| Season | {{season}} |
-| Sources | {{sources}} |
-
-## Pitch Arsenal
-
-{{#if data.pitcher-arsenal}}
-| Pitch Type | Usage % | Avg Velo | Avg Spin | H Break | V Break | Whiff % | Put Away % | Pitches |
-|------------|---------|----------|----------|---------|---------|---------|------------|---------|
-{{#each data.pitcher-arsenal}}
-| {{this.[Pitch Type]}} | {{this.[Usage %]}} | {{this.[Avg Velo]}} | {{this.[Avg Spin]}} | {{this.[H Break]}} | {{this.[V Break]}} | {{this.[Whiff %]}} | {{this.[Put Away %]}} | {{this.Pitches}} |
-{{/each}}
-{{else}}
-*Arsenal data not available*
-{{/if}}
-
-## Performance Profile
-
-*Season statistics to be populated from FanGraphs data (ERA, FIP, xFIP, SIERA, K-BB%, WAR)*
-
-## Splits Analysis
-
-{{#if data.pitcher-handedness-splits}}
-| vs | PA | AVG | SLG | K % | BB % | Avg EV | Whiff % |
-|----|-----|-----|-----|-----|------|--------|---------|
-{{#each data.pitcher-handedness-splits}}
-| {{this.vs}} | {{this.PA}} | {{this.AVG}} | {{this.SLG}} | {{this.[K %]}} | {{this.[BB %]}} | {{this.[Avg EV]}} | {{this.[Whiff %]}} |
-{{/each}}
-{{else}}
-*Splits data not available*
-{{/if}}
-
-## Trend Analysis
-
-{{#if data.pitcher-velocity-trend}}
-| Month | Avg Velo | Max Velo | Δ vs Prior | Pitches | Flag |
-|-------|----------|----------|------------|---------|------|
-{{#each data.pitcher-velocity-trend}}
-| {{this.Month}} | {{this.[Avg Velo]}} | {{this.[Max Velo]}} | {{this.[Δ vs Prior]}} | {{this.Pitches}} | {{this.Flag}} |
-{{/each}}
-{{else}}
-*Velocity trend data not available*
-{{/if}}
-
-## Risk Assessment
-
-*To be filled by evaluator: injury history, mechanical concerns, workload flags*
-
-## Comparable Player
-
-*To be filled by evaluator: statistical comp to current/recent MLB pitcher*
-
-## Role Projection
-
-*To be filled by evaluator: SP1-5 / Setup / Closer / Middle Relief + Acquire / Pass / Monitor recommendation*
-
----
-
-*Generated by bbdata CLI · Data sources: {{sources}}*
+# Pro Pitcher Evaluation: {{player}}
+
+**Season:** {{season}} | **Audience:** {{audience}} | **Generated:** {{date}}
+
+---
+
+## Header
+
+| Field | Value |
+|-------|-------|
+| Player | {{player}} |
+| Season | {{season}} |
+| Sources | {{sources}} |
+
+## Pitch Arsenal
+
+{{#if data.pitcher-arsenal}}
+| Pitch Type | Usage % | Avg Velo | Avg Spin | H Break | V Break | Whiff % | Put Away % | Pitches |
+|------------|---------|----------|----------|---------|---------|---------|------------|---------|
+{{#each data.pitcher-arsenal}}
+| {{this.[Pitch Type]}} | {{this.[Usage %]}} | {{this.[Avg Velo]}} | {{this.[Avg Spin]}} | {{this.[H Break]}} | {{this.[V Break]}} | {{this.[Whiff %]}} | {{this.[Put Away %]}} | {{this.Pitches}} |
+{{/each}}
+{{else}}
+*Arsenal data not available*
+{{/if}}
+
+{{#if graphs.movementChart}}
+### Movement Plot
+
+{{{svgOrEmpty graphs.movementChart}}}
+{{/if}}
+
+## Performance Profile
+
+*Season statistics to be populated from FanGraphs data (ERA, FIP, xFIP, SIERA, K-BB%, WAR)*
+
+## Splits Analysis
+
+{{#if data.pitcher-handedness-splits}}
+| vs | PA | AVG | SLG | K % | BB % | Avg EV | Whiff % |
+|----|-----|-----|-----|-----|------|--------|---------|
+{{#each data.pitcher-handedness-splits}}
+| {{this.vs}} | {{this.PA}} | {{this.AVG}} | {{this.SLG}} | {{this.[K %]}} | {{this.[BB %]}} | {{this.[Avg EV]}} | {{this.[Whiff %]}} |
+{{/each}}
+{{else}}
+*Splits data not available*
+{{/if}}
+
+## Trend Analysis
+
+{{#if data.pitcher-velocity-trend}}
+| Month | Avg Velo | Max Velo | Δ vs Prior | Pitches | Flag |
+|-------|----------|----------|------------|---------|------|
+{{#each data.pitcher-velocity-trend}}
+| {{this.Month}} | {{this.[Avg Velo]}} | {{this.[Max Velo]}} | {{this.[Δ vs Prior]}} | {{this.Pitches}} | {{this.Flag}} |
+{{/each}}
+{{else}}
+*Velocity trend data not available*
+{{/if}}
+
+{{#if graphs.rollingChart}}
+### Rolling Trend Chart
+
+{{{svgOrEmpty graphs.rollingChart}}}
+{{/if}}
+
+## Risk Assessment
+
+*To be filled by evaluator: injury history, mechanical concerns, workload flags*
+
+## Comparable Player
+
+*To be filled by evaluator: statistical comp to current/recent MLB pitcher*
+
+## Role Projection
+
+*To be filled by evaluator: SP1-5 / Setup / Closer / Middle Relief + Acquire / Pass / Monitor recommendation*
+
+---
+
+*Generated by bbdata CLI · Data sources: {{sources}}*

package/package.json

@@ -1,63 +1,68 @@
-{
-  "name": "bbdata-cli",
-  "version": "0.2.0",
-  "description": "Baseball data CLI for querying, scouting reports, and analytics — built for humans and AI agents",
-  "type": "module",
-  "bin": {
-    "bbdata": "dist/bin/bbdata.js"
-  },
-  "main": "./dist/src/index.js",
-  "types": "./dist/src/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/src/index.js",
-      "types": "./dist/src/index.d.ts"
-    }
-  },
-  "files": [
-    "dist",
-    "src/templates/**/*.hbs",
-    "src/cache/schema.sql"
-  ],
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsx bin/bbdata.ts",
-    "start": "node dist/bin/bbdata.js",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "lint": "eslint src/ bin/ test/",
-    "typecheck": "tsc --noEmit"
-  },
-  "keywords": [
-    "baseball",
-    "analytics",
-    "statcast",
-    "fangraphs",
-    "scouting",
-    "mlb",
-    "cli",
-    "ai"
-  ],
-  "author": "AI Baseball Data Analyst",
-  "license": "MIT",
-  "dependencies": {
-    "chalk": "^5.4.1",
-    "cli-table3": "^0.6.5",
-    "commander": "^13.1.0",
-    "csv-parse": "^5.6.0",
-    "csv-stringify": "^6.5.2",
-    "handlebars": "^4.7.8",
-    "sql.js": "^1.12.0",
-    "zod": "^3.24.2"
-  },
-  "devDependencies": {
-    "@types/node": "^22.13.0",
-    "tsup": "^8.4.0",
-    "tsx": "^4.19.2",
-    "typescript": "^5.7.3",
-    "vitest": "^3.0.4"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  }
-}
+{
+  "name": "bbdata-cli",
+  "version": "0.3.0",
+  "description": "Baseball data CLI for querying, scouting reports, and analytics — built for humans and AI agents",
+  "type": "module",
+  "bin": {
+    "bbdata": "dist/bin/bbdata.js"
+  },
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/src/index.js",
+      "types": "./dist/src/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "src/templates/**/*.hbs",
+    "src/cache/schema.sql"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsx bin/bbdata.ts",
+    "start": "node dist/bin/bbdata.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src/ bin/ test/",
+    "typecheck": "tsc --noEmit",
+    "viz:fixtures": "tsx scripts/render-fixtures.ts",
+    "prepublishOnly": "npm run build && npm run typecheck && npm test"
+  },
+  "keywords": [
+    "baseball",
+    "analytics",
+    "statcast",
+    "fangraphs",
+    "scouting",
+    "mlb",
+    "cli",
+    "ai"
+  ],
+  "author": "AI Baseball Data Analyst",
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^5.4.1",
+    "cli-table3": "^0.6.5",
+    "commander": "^13.1.0",
+    "csv-parse": "^5.6.0",
+    "csv-stringify": "^6.5.2",
+    "handlebars": "^4.7.8",
+    "sql.js": "^1.12.0",
+    "vega": "^5.30.0",
+    "vega-lite": "^5.21.0",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@resvg/resvg-js": "^2.6.2",
+    "@types/node": "^22.13.0",
+    "tsup": "^8.4.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.4"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/templates/reports/advance-sp.hbs

@@ -1,60 +1,66 @@
-# Advance Report: {{player}} (SP)
-
-**Season:** {{season}} | **For:** {{audience}} | **Generated:** {{date}}
-
----
-
-## Recent Form
-
-*Last 5 starts — to be populated with game log data*
-
-## Pitch Mix & Sequencing
-
-{{#if data.pitcher-arsenal}}
-### Arsenal Overview
-
-| Pitch | Usage | Velo | Spin | Whiff % |
-|-------|-------|------|------|---------|
-{{#each data.pitcher-arsenal}}
-| {{this.[Pitch Type]}} | {{this.[Usage %]}} | {{this.[Avg Velo]}} | {{this.[Avg Spin]}} | {{this.[Whiff %]}} |
-{{/each}}
-
-### By Count (to be populated)
-- **Ahead in count:** Primary pitch selection
-- **Behind in count:** Go-to pitch
-- **Two-strike:** Put-away pitch
-{{else}}
-*Arsenal data not available*
-{{/if}}
-
-## Times Through the Order
-
-*3rd time adjustment, velocity drop patterns — to be analyzed from pitch-level data*
-
-## Platoon Vulnerabilities
-
-{{#if data.pitcher-handedness-splits}}
-| Split | PA | AVG | SLG | K % | BB % |
-|-------|-----|-----|-----|-----|------|
-{{#each data.pitcher-handedness-splits}}
-| {{this.vs}} | {{this.PA}} | {{this.AVG}} | {{this.SLG}} | {{this.[K %]}} | {{this.[BB %]}} |
-{{/each}}
-{{else}}
-*Splits data not available*
-{{/if}}
-
-## How to Attack
-
-### Early in Game (1st time through)
-- *To be filled: patient approach? aggressive?*
-
-### Late in Game (3rd+ time through)
-- *To be filled: exploit fatigue patterns?*
-
-### Key Weaknesses
-- *To be filled by evaluator*
-
----
-
-*Generated by bbdata CLI · Data sources: {{sources}}*
-*This is a 1-page advance report designed for in-game use.*
+# Advance Report: {{player}} (SP)
+
+**Season:** {{season}} | **For:** {{audience}} | **Generated:** {{date}}
+
+---
+
+## Recent Form
+
+*Last 5 starts — to be populated with game log data*
+
+## Pitch Mix & Sequencing
+
+{{#if data.pitcher-arsenal}}
+### Arsenal Overview
+
+| Pitch | Usage | Velo | Spin | Whiff % |
+|-------|-------|------|------|---------|
+{{#each data.pitcher-arsenal}}
+| {{this.[Pitch Type]}} | {{this.[Usage %]}} | {{this.[Avg Velo]}} | {{this.[Avg Spin]}} | {{this.[Whiff %]}} |
+{{/each}}
+
+### By Count (to be populated)
+- **Ahead in count:** Primary pitch selection
+- **Behind in count:** Go-to pitch
+- **Two-strike:** Put-away pitch
+{{else}}
+*Arsenal data not available*
+{{/if}}
+
+{{#if graphs.movementChart}}
+### Pitch Movement Profile
+
+{{{svgOrEmpty graphs.movementChart}}}
+{{/if}}
+
+## Times Through the Order
+
+*3rd time adjustment, velocity drop patterns — to be analyzed from pitch-level data*
+
+## Platoon Vulnerabilities
+
+{{#if data.pitcher-handedness-splits}}
+| Split | PA | AVG | SLG | K % | BB % |
+|-------|-----|-----|-----|-----|------|
+{{#each data.pitcher-handedness-splits}}
+| {{this.vs}} | {{this.PA}} | {{this.AVG}} | {{this.SLG}} | {{this.[K %]}} | {{this.[BB %]}} |
+{{/each}}
+{{else}}
+*Splits data not available*
+{{/if}}
+
+## How to Attack
+
+### Early in Game (1st time through)
+- *To be filled: patient approach? aggressive?*
+
+### Late in Game (3rd+ time through)
+- *To be filled: exploit fatigue patterns?*
+
+### Key Weaknesses
+- *To be filled by evaluator*
+
+---
+
+*Generated by bbdata CLI · Data sources: {{sources}}*
+*This is a 1-page advance report designed for in-game use.*

package/src/templates/reports/pro-hitter-eval.hbs

@@ -1,65 +1,77 @@
-# Pro Hitter Evaluation: {{player}}
-
-**Season:** {{season}} | **Audience:** {{audience}} | **Generated:** {{date}}
-
----
-
-## Batted Ball Profile
-
-{{#if data.hitter-batted-ball}}
-| Metric | Value |
-|--------|-------|
-{{#each data.hitter-batted-ball}}
-| {{this.Metric}} | {{this.Value}} |
-{{/each}}
-{{else}}
-*Batted ball data not available*
-{{/if}}
-
-## Approach & Discipline
-
-{{#if data.hitter-vs-pitch-type}}
-| Pitch Type | Seen | Swing % | Whiff % | Foul % | In Play | Avg EV | SLG |
-|------------|------|---------|---------|--------|---------|--------|-----|
-{{#each data.hitter-vs-pitch-type}}
-| {{this.[Pitch Type]}} | {{this.Seen}} | {{this.[Swing %]}} | {{this.[Whiff %]}} | {{this.[Foul %]}} | {{this.[In Play]}} | {{this.[Avg EV]}} | {{this.SLG}} |
-{{/each}}
-{{else}}
-*Pitch type breakdown not available*
-{{/if}}
-
-## Hot/Cold Zones
-
-{{#if data.hitter-hot-cold-zones}}
-| Zone | Pitches | Swings | Whiff % | AVG | SLG |
-|------|---------|--------|---------|-----|-----|
-{{#each data.hitter-hot-cold-zones}}
-| {{this.Zone}} | {{this.Pitches}} | {{this.Swings}} | {{this.[Whiff %]}} | {{this.AVG}} | {{this.SLG}} |
-{{/each}}
-{{else}}
-*Zone data not available*
-{{/if}}
-
-## Splits Analysis
-
-*To be populated: vs LHP/RHP, home/away*
-
-## Trend Analysis
-
-*To be populated: rolling average trends*
-
-## Risk Assessment
-
-*To be filled by evaluator: injury history, age curve, contract implications*
-
-## Comparable Player
-
-*To be filled by evaluator: statistical comp*
-
-## Role Projection
-
-*To be filled by evaluator: lineup position, expected production, Acquire / Pass / Monitor*
-
----
-
-*Generated by bbdata CLI · Data sources: {{sources}}*
+# Pro Hitter Evaluation: {{player}}
+
+**Season:** {{season}} | **Audience:** {{audience}} | **Generated:** {{date}}
+
+---
+
+## Batted Ball Profile
+
+{{#if data.hitter-batted-ball}}
+| Metric | Value |
+|--------|-------|
+{{#each data.hitter-batted-ball}}
+| {{this.Metric}} | {{this.Value}} |
+{{/each}}
+{{else}}
+*Batted ball data not available*
+{{/if}}
+
+{{#if graphs.sprayChart}}
+### Spray Chart
+
+{{{svgOrEmpty graphs.sprayChart}}}
+{{/if}}
+
+## Approach & Discipline
+
+{{#if data.hitter-vs-pitch-type}}
+| Pitch Type | Seen | Swing % | Whiff % | Foul % | In Play | Avg EV | SLG |
+|------------|------|---------|---------|--------|---------|--------|-----|
+{{#each data.hitter-vs-pitch-type}}
+| {{this.[Pitch Type]}} | {{this.Seen}} | {{this.[Swing %]}} | {{this.[Whiff %]}} | {{this.[Foul %]}} | {{this.[In Play]}} | {{this.[Avg EV]}} | {{this.SLG}} |
+{{/each}}
+{{else}}
+*Pitch type breakdown not available*
+{{/if}}
+
+## Hot/Cold Zones
+
+{{#if data.hitter-hot-cold-zones}}
+| Zone | Pitches | Swings | Whiff % | AVG | SLG |
+|------|---------|--------|---------|-----|-----|
+{{#each data.hitter-hot-cold-zones}}
+| {{this.Zone}} | {{this.Pitches}} | {{this.Swings}} | {{this.[Whiff %]}} | {{this.AVG}} | {{this.SLG}} |
+{{/each}}
+{{else}}
+*Zone data not available*
+{{/if}}
+
+{{#if graphs.zoneChart}}
+### Zone Heatmap
+
+{{{svgOrEmpty graphs.zoneChart}}}
+{{/if}}
+
+## Splits Analysis
+
+*To be populated: vs LHP/RHP, home/away*
+
+## Trend Analysis
+
+*To be populated: rolling average trends*
+
+## Risk Assessment
+
+*To be filled by evaluator: injury history, age curve, contract implications*
+
+## Comparable Player
+
+*To be filled by evaluator: statistical comp*
+
+## Role Projection
+
+*To be filled by evaluator: lineup position, expected production, Acquire / Pass / Monitor*
+
+---
+
+*Generated by bbdata CLI · Data sources: {{sources}}*