get_decision_history¶

Science¶

Past human decisions on catalogue events, as structured rows: a label (good, bad, uncertain, blast), a timestamp, and whether a note exists. Operator identity and note text are never returned. The session fence applies; some profiles hide the tool entirely so a reviewer never sees another person's labels.

A human label is a prior, not the truth. Operators disagree, and good includes events they recognised as real even when the automatic location was a teleseism. Use the counts as a spatial-temporal context (a quarry that is often labelled blast by day), then measure the present event.

Contract¶

Generated from the live registry (ToolSpec). Field names, types and defaults come from the input and payload models; they are not hand-typed.


Group	`catalog`
Class	1
Tool version	`1.1.0`
Highest declared tier	F
Timeout	5 s
Budget key	`none`
`readOnlyHint`	true
`idempotentHint`	true

Input¶

Field	Type	Required	Notes
`scope`	object (kind `circle` \| `event_ids`)	yes	discriminated on `kind`
`t_from_utc`	string \| null	no	default `null`
`t_to_utc`	string \| null	no	default `null`
`limit`	integer	no	default `200`; ≥ `1`

Payload¶

Field	Type	Required
`decisions`	array[object]	yes
`decisions[].decision_id`	integer	yes
`decisions[].event_id`	integer	yes
`decisions[].decision`	string	yes
`decisions[].decided_at_utc`	string	yes
`decisions[].has_note`	boolean	yes
`decisions[].event`	object	yes
`summary`	object	yes
`summary.good`	integer	yes
`summary.bad`	integer	yes
`summary.uncertain`	integer	yes
`summary.blast`	integer	yes
`fence_applied`	boolean	yes

Example request¶

{
  "scope": {
    "kind": "circle",
    "center": {
      "kind": "catalog",
      "event_id": 1001
    },
    "radius_km": 25
  },
  "limit": 200
}

Example payload¶

{
  "decisions": [
    {
      "decision_id": 512,
      "event_id": 990,
      "decision": "blast",
      "decided_at_utc": "2024-05-02T14:02:00.000Z",
      "has_note": true,
      "event": {
        "origin_time_utc": "2024-05-02T13:40:11.200Z",
        "latitude_deg": 47.161,
        "longitude_deg": 24.512,
        "distance_km": 3.2,
        "depth_km": 4.0,
        "magnitude_ml": 1.8
      }
    }
  ],
  "summary": {
    "good": 2,
    "bad": 1,
    "uncertain": 0,
    "blast": 11
  },
  "fence_applied": true
}

What this tool does not tell you¶

What this tool does not tell you: the truth. Operators can be wrong, and good here includes teleseisms they recognised as real events. Use as a prior, not as a verdict.