list_instincts
Audit and debug recorded patterns with filters for confidence, category, project. Includes low-confidence observations for noise analysis and promotion debugging.
Instructions
List recorded patterns with optional filters; includes low-confidence observations.
Unlike suggest() — which returns mature-only, compact payloads — this
surfaces seedlings too. Useful for audits, pruning noise via gc() or
alias_pattern(), and debugging why a pattern has not promoted.
Read-only; records sorted by confidence descending, then last_seen
descending.
For day-to-day agent guidance prefer suggest(). For keyword search
use search_instincts(). For a single exact-key lookup use
get_instinct().
Args:
min_confidence: Minimum observation count (inclusive). Examples:
1 returns everything including one-offs; 5 returns mature+;
10 returns rules only.
category: Filter by pattern type. One of: "sequence",
"preference", "fix_pattern", "combo". Empty string = all.
project: Filter by project fingerprint (repo hash or path hash).
Empty string returns every project including the global ""
bucket.
limit: Maximum records to return. Default 50; raise for full
dumps, lower for top-N views.
Returns:
{"instincts": [<record>, ...], "count": int, "hint": str}
Each <record> has: "pattern" (str key with prefix),
"category" ("sequence"|"preference"|"fix_pattern"|"combo"),
"confidence" (int observation count),
"promoted" (0=raw, 1=mature, 2=rule, 3=universal),
"level" ("raw"|"mature"|"rule"|"universal" — string form of promoted),
"project" (str fingerprint, "" = global),
"source" (str origin tag), "metadata" (parsed dict),
"explain" (str human-readable note),
"first_seen" and "last_seen" (ISO 8601 timestamps).
"hint" points to suggest() / search_instincts() / get_instinct()
as next-step tools depending on the audit goal.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| min_confidence | No | ||
| category | No | ||
| project | No | ||
| limit | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||