Summary
Query template registry has expanded from 21 to 22 templates. Downstream consumers (scout-app agent prompt and ai-baseball-data-analyst skills) explicitly document "all 21 query templates" — they are now out of sync.
Details
1. Query Template Count Drift
Expected by consumers: 21 query templates
Current in bbdata: 22 query templates (confirmed in src/templates/queries/index.ts)
New/undocumented templates (no BBDATA-* explanation in imports):
pitcher-rolling-trend
pitcher-raw-pitches
hitter-raw-bip
hitter-zone-grid
Affected consumers:
scout-app: agent/system-prompt.md states "Agent prompt references all 21 query templates"
ai-baseball-data-analyst: skills/query-data/SKILL.md states "references all 21 query templates"
Both must update their documentation to list all 22 templates or determine which 4 are new and should be excluded from consumer-facing documentation.
2. JSON Envelope (Query Results)
Status: ✓ No breaking change
The meta envelope added an optional template field. All expected fields (source, cached, queryTimeMs, season, sampleSize) remain and are still populated. Backwards compatible.
3. Other Checks
- ✓ Report template count: 13 (matches expectation)
- ✓ CLI flags (query): all expected flags present (--player, --season, --format, --stat, --min-ip, --min-pa, --top, --pitch-type, --seasons, --source)
- ✓ CLI flags (report): all expected flags present (--player, --season, --audience, --format, --validate)
- ✓ Audience values: coach, gm, scout, analyst (all present)
Required Action
Clarify which 4 templates are new additions:
- Were they intentionally added and should consumers now reference 22 templates?
- Or should they be gated behind a flag or removed until documented?
- Update TASKS.md to cross-reference consumer updates needed in scout-app and ai-baseball-data-analyst repos.
Summary
Query template registry has expanded from 21 to 22 templates. Downstream consumers (scout-app agent prompt and ai-baseball-data-analyst skills) explicitly document "all 21 query templates" — they are now out of sync.
Details
1. Query Template Count Drift
Expected by consumers: 21 query templates
Current in bbdata: 22 query templates (confirmed in src/templates/queries/index.ts)
New/undocumented templates (no BBDATA-* explanation in imports):
pitcher-rolling-trendpitcher-raw-pitcheshitter-raw-biphitter-zone-gridAffected consumers:
scout-app: agent/system-prompt.md states "Agent prompt references all 21 query templates"ai-baseball-data-analyst: skills/query-data/SKILL.md states "references all 21 query templates"Both must update their documentation to list all 22 templates or determine which 4 are new and should be excluded from consumer-facing documentation.
2. JSON Envelope (Query Results)
Status: ✓ No breaking change
The meta envelope added an optional
templatefield. All expected fields (source, cached, queryTimeMs, season, sampleSize) remain and are still populated. Backwards compatible.3. Other Checks
Required Action
Clarify which 4 templates are new additions: