Enum PendingCountError 

pub enum PendingCountError {
    SharedStoreUnresolvable,
    SharedStoreUnreadable {
        path: PathBuf,
        error: String,
    },
    ChannelStoreUnreadable {
        path: PathBuf,
        error: String,
        global_pending: usize,
    },
}

Why a pending count could not be determined. Distinguished from “zero pending” on purpose: a caller deciding whether the schema is current must be able to tell “nothing to do” from “I could not tell”, because the safe reaction to each is opposite.

Variants

SharedStoreUnresolvable

No shared store path resolves (CI, or an env with no AGENTMUX_SHARED_DIR). Global-scope migrations cannot be counted.

SharedStoreUnreadable

The shared store exists but would not open.

Fields

path: PathBuf

error: String

ChannelStoreUnreadable

The channel store would not open. Channel-scoped migrations cannot be counted. Carries the global-scope count that WAS readable, so the lenient wrapper can keep reporting it — but it is still an error, because a partial count must not be mistaken for a complete one.

Fields

path: PathBuf

error: String

global_pending: usize

Implementations

impl PendingCountError

pub fn readable_pending(&self) -> usize

The pending count that WAS readable despite this error — the global-scope half when only the channel store failed, otherwise none at all.

For callers that must not block on an unreadable store (the AGENTMUXSRV-MIGRATING hint, which only sizes a timeout, and the ESTART report, which runs after the migration batch). A caller deciding anything on the count must handle the error instead — see try_count_pending_migrations.

Trait Implementations

impl Debug for PendingCountError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for PendingCountError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.