* Detect tool loops from recent_tools ring buffer. * @param {Array} recentTools * @returns {{detected: boolean, tool: string, count: number}}

* Find files matching a pattern in a directory (cross-platform alternative to find) * @param {string} dir - Directory to search * @param {string} pa

* Default aliases file structure

* Home directory for tilde expansion and default agent-data paths. * * Intentionally mirrors `getHomeDir()` in `scripts/lib/utils.js` (HOME/USERPROF

* Read and parse package.json dependencies * @param {string} projectDir - Project root directory * @returns {string[]} Array of dependency names

* Returns true when `candidate` looks like a valid ECC plugin root, i.e. the * run-with-flags.js runner exists inside it. * * @param {unknown} cand

* Load and parse a single agent file.

* Resolve agent data home without mutating process.env.

* Run a command and return output * * SECURITY NOTE: This function executes shell commands. Only use with * trusted, hardcoded commands. Never pass

* Run a hook command string exactly as declared in hooks.json. * Supports wrapped node script commands and shell wrappers. * @param {string} command

Execute a scenario and extract tool calls from stream-json output.

* Map numeric severity to label.

* Strip all ANSI escape sequences from a string. * * Handles: * - CSI sequences: \x1b[ … <letter> (colors, cursor movement, erase, etc.) * - OSC

* Suggest a remediation action based on pattern characteristics.