bar_audit_ingredients
Audit bottles for missing image, ABV, or flavor data to clean up incomplete historical records. Optionally filter by category or shelf status.
Instructions
Audit real bottles for incomplete data, so historical gaps can be cleaned up.
This is the canonical "what's incomplete" worklist — it reports real bottles, not commodity leaves. (For raw structural listing use bar_list_ingredients.)
Reports, per specific bottle (leaf ingredient — generic parent categories are skipped), which of these are missing:
image — commodity leaves (juices, syrups, produce, dairy, ice) are excluded by default, so this is "bottles needing artwork".
ABV / strength (only for bottles in a tracked spirit/liqueur category)
flavor profile — only for bottles whose category supports flavor axes (gin, rye, bourbon, scotch, american_single_malt, aquavit, amaro, herbal_liqueur, rum, vermouth, fruit_liqueur). Bottles in categories with no axes are never flagged for a missing profile.
Axis support is seeded from a known map AND learned live from bottles that already have a profile, so it stays correct as the taxonomy grows.
Args:
category: restrict to one category's subtree (pass the category ingredient's ID, e.g. 347 Rye). Strongly recommended — it makes the flavor scan far cheaper.
on_shelf_only: only audit bottles currently in the bar.
check_flavor: set False to skip the per-bottle flavor-profile scan (faster; reports only image/ABV gaps).
include_uncategorized: also audit root-level leaves not filed under any category. Off by default.
include_commodities: include commodity items (juices, syrups, produce…) in the missing-image list. Off by default.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| category | No | ||
| check_flavor | No | ||
| on_shelf_only | No | ||
| include_commodities | No | ||
| include_uncategorized | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |