Function defer_state_free

src/watcher/watcher.c:732–746

Move a state onto the deferred-free list (caller holds projects_lock). * The state may still be referenced by a poll_once snapshot; poll_once * drains the list at the start of its next cycle. Returns false when * growing the list fails (OOM): the state is left untouched and the * caller must keep it registered — freeing it immediately here could be * a use-after-free against an in-flight poll

 * caller must keep it registered — freeing it immediately here could be
 * a use-after-free against an in-flight poll snapshot. */
static bool defer_state_free(cbm_watcher_t *w, project_state_t *s) {
    if (w->pending_free_count >= w->pending_free_cap) {
        int new_cap = w->pending_free_cap ? w->pending_free_cap * 2 : 8;
        project_state_t **tmp =
            realloc(w->pending_free, (size_t)new_cap * sizeof(project_state_t *));
        if (!tmp) {
            cbm_log_warn("watcher.unwatch.oom", "project", s->project_name);
            return false;
        }
        w->pending_free = tmp;
        w->pending_free_cap = new_cap;
    }
    w->pending_free[w->pending_free_count++] = s;
    return true;
}

/* ── Stale-root pruning (#286) ──────────────────────────────────── */