bbdata-cli 0.1.0 → 0.2.0

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

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

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

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"'],
+});

package/dist/templates/reports/relief-pitcher-quick.hbs

@@ -0,0 +1,29 @@
+# Relief Pitcher Quick Eval: {{player}}
+
+**Season:** {{season}} | **Generated:** {{date}}
+
+---
+
+## Arsenal
+
+{{#if data.pitcher-arsenal}}
+| Pitch | Usage | Velo | Whiff % |
+|-------|-------|------|---------|
+{{#each data.pitcher-arsenal}}
+| {{this.[Pitch Type]}} | {{this.[Usage %]}} | {{this.[Avg Velo]}} | {{this.[Whiff %]}} |
+{{/each}}
+{{else}}
+*Data not available*
+{{/if}}
+
+## Key Metrics
+
+*ERA, FIP, K-BB%, leverage index — to be populated*
+
+## Recommendation
+
+*Acquire / Pass / Monitor — to be filled by evaluator*
+
+---
+
+*Generated by bbdata CLI · 1-page format*

package/dist/templates/reports/trade-target-onepager.hbs

@@ -0,0 +1,45 @@
+# Trade Target: {{player}}
+
+**Season:** {{season}} | **For:** {{audience}} | **Generated:** {{date}}
+
+---
+
+## Key Stats
+
+{{#if data.hitter-batted-ball}}
+| Metric | Value |
+|--------|-------|
+{{#each data.hitter-batted-ball}}
+| {{this.Metric}} | {{this.Value}} |
+{{/each}}
+{{else}}
+{{#if data.pitcher-arsenal}}
+| Pitch | Usage | Velo | Whiff % |
+|-------|-------|------|---------|
+{{#each data.pitcher-arsenal}}
+| {{this.[Pitch Type]}} | {{this.[Usage %]}} | {{this.[Avg Velo]}} | {{this.[Whiff %]}} |
+{{/each}}
+{{else}}
+*Stats to be populated*
+{{/if}}
+{{/if}}
+
+## Strengths
+
+*Top 2-3 strengths — to be filled*
+
+## Concerns
+
+*Top 2-3 concerns — to be filled*
+
+## Fit Assessment
+
+*How this player fits the acquiring team's needs — to be filled*
+
+## Recommendation
+
+**Acquire / Pass / Monitor** — *to be filled*
+
+---
+
+*Generated by bbdata CLI · Executive 1-page format*

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bbdata-cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Baseball data CLI for querying, scouting reports, and analytics — built for humans and AI agents",
   "type": "module",
   "bin": {