Struct Lifecycle 

pub struct Lifecycle {
    pub cancel: CancellationToken,
    pub finalize_done: Arc<AtomicBool>,
    pub ledger: Arc<Mutex<ResourceLedger>>,
}

Runtime token for cooperative cancel and FINALIZE.

Ownership

Clones share the same Arc ledger and cancel token. Dropping any clone that wins the finalize CAS performs residual cleanup — treat as a resource owner (#[must_use]).

Fields

cancel: CancellationToken

Cancellation token shared with async tasks.

finalize_done: Arc<AtomicBool>

Whether FINALIZE already completed.

Updated with Ordering::SeqCst so a single total order is visible to Drop, signal handlers, and async tasks racing on idempotent finalize.

ledger: Arc<Mutex<ResourceLedger>>

Owned resources for residual cleanup.

std::sync::Mutex (not tokio::sync::Mutex): critical sections are short and never held across .await. Poison is always recovered via Self::with_ledger_mut so residual FINALIZE cannot sticky-fail.

Implementations

impl Lifecycle

pub fn new() -> Self

Create a fresh lifecycle for one process invocation.

pub fn with_ledger_mut<R>(&self, f: impl FnOnce(&mut ResourceLedger) -> R) -> R

Mutate the resource ledger under the mutex.

Poison policy

Recovers via PoisonError::into_inner so a prior panic cannot prevent residual kill/wipe (rules: treat PoisonError, never silent-skip FINALIZE).

pub fn record_chrome(&self, pid: Option<u32>)

Record that this invocation launched Chrome (residual kill target).

pub fn clear_chrome(&self)

Clear residual Chrome ownership after primary close reaped the child.

pub fn clear_chrome_and_profile(&self)

Clear Chrome + profile ledger after primary session shutdown.

pub fn is_cancelled(&self) -> bool

Whether cooperative cancel was requested (signal or finalize).

pub fn finalize(&self)

Idempotent FINALIZE: last-resort residual kill if chrome still flagged.

Primary reap is OneShotSession::shutdown (Browser.close + wait_or_kill).

Trait Implementations

impl Clone for Lifecycle

fn clone(&self) -> Lifecycle

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for Lifecycle

fn default() -> Self

Returns the “default value” for a type.

impl Drop for Lifecycle

Safety net: if the call site forgets explicit Lifecycle::finalize, Drop still runs residual cleanup (sync only: kill/wipe; no async I/O).

Drop contract

• Idempotent via finalize_done (SeqCst CAS).
• Bounded: residual Unix path may sleep up to FINALIZE_CHILD_GRACE (not indefinite; rules forbid unbounded block in Drop).
• No panic: kill/wipe errors are ignored (best-effort).
• Clones share the same Arcs; the first Drop that wins the CAS performs work.

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.