bbdata-cli 0.1.1 → 0.3.0

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

@@ -0,0 +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}}
+
+{{#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/dist/templates/reports/college-hitter-draft.hbs

@@ -0,0 +1,49 @@
+# College Hitter Draft Report: {{player}}
+
+**Season:** {{season}} | **Generated:** {{date}}
+
+---
+
+## Header
+
+| Field | Value |
+|-------|-------|
+| Player | {{player}} |
+| School | *To be filled* |
+| Bats/Throws | *To be filled* |
+| Position | *To be filled* |
+| Age | *To be filled* |
+
+## Physical
+
+*Body type, athleticism, strength projection — to be filled*
+
+## Tool Grades (20-80 Scale)
+
+| Tool | Present | Future | Notes |
+|------|---------|--------|-------|
+| Hit | — | — | *Bat speed, plate coverage* |
+| Power | — | — | *Raw, game power, pull/oppo* |
+| Speed | — | — | *Run times, baserunning IQ* |
+| Field | — | — | *Actions, arm, range* |
+| Arm | — | — | *Strength, accuracy* |
+
+## Performance
+
+*College slash line, K%, BB%, wood bat league stats — to be filled*
+
+## Projection
+
+*Ceiling, floor, likely outcome — to be filled*
+
+## Risk
+
+*Swing concerns, defensive fit, signability — to be filled*
+
+## Recommendation
+
+*Draft round range, comparison — to be filled*
+
+---
+
+*Generated by bbdata CLI*

package/dist/templates/reports/college-pitcher-draft.hbs

@@ -0,0 +1,48 @@
+# College Pitcher Draft Report: {{player}}
+
+**Season:** {{season}} | **Generated:** {{date}}
+
+---
+
+## Header
+
+| Field | Value |
+|-------|-------|
+| Player | {{player}} |
+| School | *To be filled* |
+| Throws | *To be filled* |
+| Age | *To be filled* |
+| Height/Weight | *To be filled* |
+
+## Physical
+
+*Body type, athleticism, projectability — to be filled by evaluator*
+
+## Arsenal Grades (20-80 Scale)
+
+| Tool | Present | Future | Notes |
+|------|---------|--------|-------|
+| Fastball | — | — | *Velo, life, command* |
+| Breaking Ball | — | — | *Type, spin, depth* |
+| Changeup | — | — | *Fade, deception* |
+| Command | — | — | *Zone control, sequencing* |
+
+## Performance
+
+*College stats: ERA, K/9, BB/9, WHIP — to be filled*
+
+## Projection
+
+*Ceiling, floor, likely outcome — to be filled by evaluator*
+
+## Risk
+
+*Injury history, workload, mechanics — to be filled by evaluator*
+
+## Recommendation
+
+*Draft round range, comparison, acquire/pass — to be filled*
+
+---
+
+*Generated by bbdata CLI*

package/dist/templates/reports/dev-progress.hbs

@@ -0,0 +1,29 @@
+# Development Progress Report: {{player}}
+
+**Season:** {{season}} | **Generated:** {{date}}
+
+---
+
+## Current Stats
+
+*Current level, slash line, K%, BB%, ISO — to be populated*
+
+## Trend Analysis
+
+*Month-over-month progression, key metric changes — to be populated*
+
+## Mechanical Notes
+
+*Changes, adjustments, coach observations — to be filled by evaluator*
+
+## Development Goals
+
+*Target areas for improvement — to be filled by development staff*
+
+## Next Steps
+
+*Promotion timeline, assignment recommendation — to be filled*
+
+---
+
+*Generated by bbdata CLI*

package/dist/templates/reports/draft-board-card.hbs

@@ -0,0 +1,35 @@
+# {{player}} — Draft Board Card
+
+**Generated:** {{date}}
+
+---
+
+| Field | Value |
+|-------|-------|
+| **Name** | {{player}} |
+| **Position** | *To be filled* |
+| **School** | *To be filled* |
+| **B/T** | *To be filled* |
+| **Age** | *To be filled* |
+
+### Tool Grades
+
+| Hit | Power | Speed | Field | Arm | OFP |
+|-----|-------|-------|-------|-----|-----|
+| — | — | — | — | — | — |
+
+### Projection
+
+*One-line ceiling* — *To be filled*
+
+### Comp
+
+*Player comparison* — *To be filled*
+
+### Round Range
+
+*Expected draft range* — *To be filled*
+
+---
+
+*bbdata CLI · Draft room card format*

package/dist/templates/reports/hs-prospect.hbs

@@ -0,0 +1,48 @@
+# High School Prospect Report: {{player}}
+
+**Season:** {{season}} | **Generated:** {{date}}
+
+---
+
+## Header
+
+| Field | Value |
+|-------|-------|
+| Player | {{player}} |
+| School | *To be filled* |
+| Position | *To be filled* |
+| Commitment | *To be filled* |
+
+## Physical
+
+*Body type, athleticism, projectability — to be filled*
+
+## Tool Grades (20-80 Scale)
+
+| Tool | Present | Future | Notes |
+|------|---------|--------|-------|
+| Hit | — | — | |
+| Power | — | — | |
+| Speed | — | — | |
+| Field | — | — | |
+| Arm | — | — | |
+
+## Makeup
+
+*Work ethic, competitiveness, coachability — to be filled*
+
+## Projection
+
+*Development timeline, ceiling, floor — to be filled*
+
+## Signability
+
+*Commitment strength, slot expectations — to be filled*
+
+## Recommendation
+
+*Draft/follow recommendation — to be filled*
+
+---
+
+*Generated by bbdata CLI*

package/dist/templates/reports/partials/footer.hbs

@@ -0,0 +1,7 @@
+
+---
+
+*Generated by bbdata CLI v0.1.0*
+*Data sources: {{sources}}*
+*Report date: {{date}}*
+*This report was generated with AI assistance. All statistics should be verified against primary sources before making personnel decisions.*

package/dist/templates/reports/partials/header.hbs

@@ -0,0 +1,12 @@
+# {{reportTitle}}
+
+| Field | Value |
+|-------|-------|
+| **Player** | {{player}} |
+| **Team** | {{team}} |
+| **Season** | {{season}} |
+| **Report Type** | {{reportType}} |
+| **Audience** | {{audience}} |
+| **Date** | {{date}} |
+
+---

package/dist/templates/reports/post-promotion.hbs

@@ -0,0 +1,25 @@
+# Post-Promotion Evaluation: {{player}}
+
+**Season:** {{season}} | **Generated:** {{date}}
+
+---
+
+## Pre-Promotion Stats
+
+*Stats at previous level — to be populated*
+
+## Post-Promotion Stats
+
+*Stats at new level — to be populated*
+
+## Adjustment Analysis
+
+*What changed, what didn't, approach differences — to be filled by evaluator*
+
+## Recommendation
+
+*Continue at level / promote / reassign — to be filled*
+
+---
+
+*Generated by bbdata CLI*

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

@@ -0,0 +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}}
+
+{{#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}}*

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

@@ -0,0 +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}}
+
+{{#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/dist/templates/reports/registry.ts

@@ -0,0 +1,215 @@
+import type { DataSource, AdapterQuery } from '../../adapters/types.js';
+
+export type ReportCategory = 'pro-scouting' | 'amateur-scouting' | 'advance' | 'player-dev' | 'executive';
+export type Audience = 'coach' | 'gm' | 'scout' | 'analyst';
+
+export interface ReportTemplate {
+  id: string;
+  name: string;
+  category: ReportCategory;
+  description: string;
+  audiences: Audience[];
+  templateFile: string;
+
+  /** What data queries this report needs */
+  dataRequirements: {
+    queryTemplate: string;
+    paramMapping: Record<string, string>;
+    required: boolean;
+  }[];
+
+  /** Sections that must be present in the output */
+  requiredSections: string[];
+
+  examples: string[];
+}
+
+// Template registry
+const templates = new Map<string, ReportTemplate>();
+
+export function registerReportTemplate(template: ReportTemplate): void {
+  templates.set(template.id, template);
+}
+
+export function getReportTemplate(id: string): ReportTemplate | undefined {
+  return templates.get(id);
+}
+
+export function getAllReportTemplates(): ReportTemplate[] {
+  return Array.from(templates.values());
+}
+
+export function getReportTemplatesByCategory(category: ReportCategory): ReportTemplate[] {
+  return getAllReportTemplates().filter((t) => t.category === category);
+}
+
+export function listReportTemplates(): { id: string; name: string; category: string; description: string }[] {
+  return getAllReportTemplates().map((t) => ({
+    id: t.id,
+    name: t.name,
+    category: t.category,
+    description: t.description,
+  }));
+}
+
+// --- Register all 12 report templates ---
+
+registerReportTemplate({
+  id: 'pro-pitcher-eval',
+  name: 'Pro Pitcher Evaluation',
+  category: 'pro-scouting',
+  description: 'Full MLB/MiLB pitcher assessment for trade/free agency decisions',
+  audiences: ['gm', 'scout', 'analyst'],
+  templateFile: 'pro-pitcher-eval.hbs',
+  dataRequirements: [
+    { queryTemplate: 'pitcher-arsenal', paramMapping: { player: 'player' }, required: true },
+    { queryTemplate: 'pitcher-velocity-trend', paramMapping: { player: 'player' }, required: false },
+    { queryTemplate: 'pitcher-handedness-splits', paramMapping: { player: 'player' }, required: true },
+  ],
+  requiredSections: ['Header', 'Pitch Arsenal', 'Performance Profile', 'Splits Analysis', 'Trend Analysis', 'Risk Assessment', 'Comparable Player', 'Role Projection'],
+  examples: ['bbdata report pro-pitcher-eval --player "Corbin Burnes"'],
+});
+
+registerReportTemplate({
+  id: 'pro-hitter-eval',
+  name: 'Pro Hitter Evaluation',
+  category: 'pro-scouting',
+  description: 'Full MLB/MiLB hitter assessment for acquisition decisions',
+  audiences: ['gm', 'scout', 'analyst'],
+  templateFile: 'pro-hitter-eval.hbs',
+  dataRequirements: [
+    { queryTemplate: 'hitter-batted-ball', paramMapping: { player: 'player' }, required: true },
+    { queryTemplate: 'hitter-vs-pitch-type', paramMapping: { player: 'player' }, required: true },
+    { queryTemplate: 'hitter-hot-cold-zones', paramMapping: { player: 'player' }, required: false },
+  ],
+  requiredSections: ['Header', 'Batted Ball Profile', 'Approach & Discipline', 'Splits Analysis', 'Trend Analysis', 'Risk Assessment', 'Comparable Player', 'Role Projection'],
+  examples: ['bbdata report pro-hitter-eval --player "Juan Soto"'],
+});
+
+registerReportTemplate({
+  id: 'relief-pitcher-quick',
+  name: 'Relief Pitcher Quick Eval',
+  category: 'pro-scouting',
+  description: 'Fast 1-page evaluation for bullpen additions',
+  audiences: ['gm', 'scout'],
+  templateFile: 'relief-pitcher-quick.hbs',
+  dataRequirements: [
+    { queryTemplate: 'pitcher-arsenal', paramMapping: { player: 'player' }, required: true },
+  ],
+  requiredSections: ['Header', 'Arsenal', 'Key Metrics', 'Recommendation'],
+  examples: ['bbdata report relief-pitcher-quick --player "Edwin Diaz"'],
+});
+
+registerReportTemplate({
+  id: 'college-pitcher-draft',
+  name: 'College Pitcher Draft Report',
+  category: 'amateur-scouting',
+  description: 'Draft evaluation with tools and projection focus',
+  audiences: ['gm', 'scout'],
+  templateFile: 'college-pitcher-draft.hbs',
+  dataRequirements: [],
+  requiredSections: ['Header', 'Physical', 'Arsenal Grades', 'Performance', 'Projection', 'Risk', 'Recommendation'],
+  examples: ['bbdata report college-pitcher-draft --player "Chase Burns"'],
+});
+
+registerReportTemplate({
+  id: 'college-hitter-draft',
+  name: 'College Hitter Draft Report',
+  category: 'amateur-scouting',
+  description: 'Draft evaluation with tools and projection focus',
+  audiences: ['gm', 'scout'],
+  templateFile: 'college-hitter-draft.hbs',
+  dataRequirements: [],
+  requiredSections: ['Header', 'Physical', 'Tool Grades', 'Performance', 'Projection', 'Risk', 'Recommendation'],
+  examples: ['bbdata report college-hitter-draft --player "Charlie Condon"'],
+});
+
+registerReportTemplate({
+  id: 'hs-prospect',
+  name: 'High School Prospect Report',
+  category: 'amateur-scouting',
+  description: 'Tools-and-projection focused (stats unreliable at HS level)',
+  audiences: ['gm', 'scout'],
+  templateFile: 'hs-prospect.hbs',
+  dataRequirements: [],
+  requiredSections: ['Header', 'Physical', 'Tool Grades', 'Makeup', 'Projection', 'Signability', 'Recommendation'],
+  examples: ['bbdata report hs-prospect --player "Prospect Name"'],
+});
+
+registerReportTemplate({
+  id: 'advance-sp',
+  name: 'Advance Report: Starting Pitcher',
+  category: 'advance',
+  description: 'Game prep for opposing starter — actionable, 1-page, bullet-point format',
+  audiences: ['coach', 'analyst'],
+  templateFile: 'advance-sp.hbs',
+  dataRequirements: [
+    { queryTemplate: 'pitcher-arsenal', paramMapping: { player: 'player' }, required: true },
+    { queryTemplate: 'pitcher-handedness-splits', paramMapping: { player: 'player' }, required: true },
+  ],
+  requiredSections: ['Header', 'Recent Form', 'Pitch Mix & Sequencing', 'Times Through Order', 'Platoon Vulnerabilities', 'How to Attack'],
+  examples: ['bbdata report advance-sp --player "Gerrit Cole" --audience coach'],
+});
+
+registerReportTemplate({
+  id: 'advance-lineup',
+  name: 'Advance Report: Opposing Lineup',
+  category: 'advance',
+  description: 'Hitter-by-hitter breakdown for pitchers and catchers',
+  audiences: ['coach', 'analyst'],
+  templateFile: 'advance-lineup.hbs',
+  dataRequirements: [],
+  requiredSections: ['Header', 'Lineup Overview', 'Hitter Breakdowns', 'Key Matchups'],
+  examples: ['bbdata report advance-lineup --team NYY'],
+});
+
+registerReportTemplate({
+  id: 'dev-progress',
+  name: 'Development Progress Report',
+  category: 'player-dev',
+  description: 'Track minor league player growth over time (monthly/quarterly)',
+  audiences: ['scout', 'analyst'],
+  templateFile: 'dev-progress.hbs',
+  dataRequirements: [],
+  requiredSections: ['Header', 'Current Stats', 'Trend Analysis', 'Mechanical Notes', 'Development Goals', 'Next Steps'],
+  examples: ['bbdata report dev-progress --player "Jackson Holliday"'],
+});
+
+registerReportTemplate({
+  id: 'post-promotion',
+  name: 'Post-Promotion Evaluation',
+  category: 'player-dev',
+  description: 'Assess player adjustment after level change',
+  audiences: ['scout', 'analyst'],
+  templateFile: 'post-promotion.hbs',
+  dataRequirements: [],
+  requiredSections: ['Header', 'Pre-Promotion Stats', 'Post-Promotion Stats', 'Adjustment Analysis', 'Recommendation'],
+  examples: ['bbdata report post-promotion --player "Jackson Holliday"'],
+});
+
+registerReportTemplate({
+  id: 'trade-target-onepager',
+  name: 'Trade Target One-Pager',
+  category: 'executive',
+  description: 'Condensed 2-minute evaluation for GM-level trade decisions',
+  audiences: ['gm'],
+  templateFile: 'trade-target-onepager.hbs',
+  dataRequirements: [
+    { queryTemplate: 'hitter-batted-ball', paramMapping: { player: 'player' }, required: false },
+    { queryTemplate: 'pitcher-arsenal', paramMapping: { player: 'player' }, required: false },
+  ],
+  requiredSections: ['Header', 'Key Stats', 'Strengths', 'Concerns', 'Fit Assessment', 'Recommendation'],
+  examples: ['bbdata report trade-target-onepager --player "Vladimir Guerrero Jr." --audience gm'],
+});
+
+registerReportTemplate({
+  id: 'draft-board-card',
+  name: 'Draft Board Summary Card',
+  category: 'executive',
+  description: 'Glanceable index card for draft room use',
+  audiences: ['gm', 'scout'],
+  templateFile: 'draft-board-card.hbs',
+  dataRequirements: [],
+  requiredSections: ['Name', 'Position', 'School', 'Tool Grades', 'Projection', 'Comp', 'Round Range'],
+  examples: ['bbdata report draft-board-card --player "Prospect Name"'],
+});