dsh-idle-compactor

LIMITATIONS

Known limitations

- **Live agents only.** A session with no agent in this process has no surface to measure and no agent to run maintenance against, so closed or never-opened sessions wait until they are opened. A cold path would have to resume an agent per candidate; that is also why `includeSubagents` defaults to false — background children are already owned by their parent lifecycle. - **A running turn is never interrupted.** Eligibility requires `agent.status === "idle"`, and `compactNow` is a between-turn maintenance task; a session whose turn has been running for hours is not idle in either sense. Its between-turn twin — quiet while a child works — is held by `skipAwaitingWork`, so a parent whose wait is unbounded is compacted only after that wait ends. - **No settings panel.** Configuration lives in the patch layer; a `settings.section` with hot reload is the natural follow-up.