Sanitize scenario ID and ensure path stays within sandbox base.

Show instincts that could be promoted from project to global.

Warn if legacy ~/.claude/homunculus/ contains data while the active path has moved to the XDG directory.

Append event to JSONL file with timestamps.

The minimal {verdict, reason, score} contract, plus did/ok.

Return safe argv/kwargs for opening a terminal rooted at the requested path.

Center the window on screen

Classify which tool calls match which compliance steps. Returns {step_id: [event_indices]} via a single LLM call.

* Sweep stale counter files from the temp dir. * * Each session writes `claude-tool-count-<sessionId>` into the OS temp * dir; nothing else removes

* Remove all tracked temporary directories.

Remove PID file on exit.

Analyze instincts and suggest evolutions to skills/commands/agents.

Export instincts to file.

Import instincts from file or URL.

Promote project-scoped instincts to global scope.

Delete pending instincts older than the TTL threshold.

* Collect every command-line segment we should evaluate. Returns the top-level * segments first, then segments harvested from `$(...)` / backtick com

* Walk every executable body reachable from a raw command line and * return them as a flat list. Bodies that bash will execute live in * three diffe