Diagnose a shot
diagnose_shotRead-onlyIdempotent
Evaluate shot metrics to provide ranked hypotheses (C6) and warn on flip-flops (G2) or fatigue (G6). Resolves the SHOT's own bean (age computed at the shot's pulled_at), never the active profile, and echoes it as bean_context, so diagnosing an older or differently-filed shot is always safe. The engine reads metrics and sensory tags, NOT free-text notes, so make sure taste feedback is recorded as sensory_tags on the shot (via log_shot or update_shot) before diagnosing; otherwise an in-range shot that tastes bad will come back "balanced".
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| shot_id | No | Optional shot ID; defaults to last pulled shot. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| facts | Yes | ||
| category | Yes | ||
| warnings | Yes | ||
| hypotheses | Yes | ||
| kb_version | Yes | ||
| bean_context | Yes | ||
| warning_codes | Yes | ||
| one_variable_only | Yes |