| name | trap-detector |
| description | Use dynamics data to identify stuck states and create trap warnings. Integrates with dynamics layer potential/action metrics. Use when working on sleeptime tasks. |
| metadata | [object Object] |
Trap Detector
Use dynamics data to identify stuck states and create trap warnings.
Inputs
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
dynamics_db_path |
string | No | .cyntra/dynamics/transitions.db | Path to dynamics transitions SQLite DB |
action_threshold |
number | No | 0.2 | Action rate below which state is considered trapped |
min_visits |
integer | No | 3 | Minimum visits before considering a state for trap detection |
Outputs
| Field | Type | Description |
|---|---|---|
traps |
array | Newly detected trap states |
oscillations |
array | Detected oscillation cycles |
summary |
object | Summary statistics |
Usage
python scripts/trap_detector.py [arguments]
Examples
Detect traps (no-op if DB missing)
Inputs:
action_threshold: 0.2
dynamics_db_path: .cyntra/dynamics/transitions.db
min_visits: 3
Generated from `skills/sleeptime/trap-detector.yaml`