trending
Identify patterns with the highest observation velocity in a configurable time window, surfacing currently active trends for prioritization.
Instructions
Rank patterns by observation velocity (reinforcements per window).
Counts entries in the confidence log per pattern within the window
and returns the busiest. A brand-new pattern observed 10 times
today outranks a long-mature pattern idle for weeks. Falls back to
last_seen ordering for patterns with no log entries (pre-history
data). Read-only.
For all-time leaderboards use list_instincts(min_confidence=10).
For the confirmation-rate view of whether trending patterns were
actually useful, pair with effectiveness(days).
Args:
days: Window size in days. Default 7. Smaller (1) = what is
hot right now; larger (30) = what is steady over the
month.
limit: Max patterns to return. Default 10, ordered by window
observation count descending.
Returns:
{"trending": [<record>, ...], "period_days": int}
Each <record> is a full pattern record (see list_instincts
for field list) augmented with an extra field
"observations_in_period": int — the number of reinforcements
counted in this window. When the fallback path runs (no log
history), this field is absent; ordering is then by
"confidence" and "last_seen" descending.
"period_days" echoes the input so callers can cache results
against a window size.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | ||
| limit | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||