Skip to content

[drift] CLI surface changed, consumers need update #10

@areales

Description

@areales

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:

  1. Were they intentionally added and should consumers now reference 22 templates?
  2. Or should they be gated behind a flag or removed until documented?
  3. Update TASKS.md to cross-reference consumer updates needed in scout-app and ai-baseball-data-analyst repos.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions