zeroclaw-labs/zeroclaw · error · anyhow::Error

Run cannot re-draft: its parked checkpoint snapshot is not…

Error message

Run {run_id} cannot re-draft: its parked checkpoint snapshot is not yet durably persisted (retrying)

What it means

A revise was requested while the parked checkpoint snapshot is not yet durably persisted (is_park_persist_pending). Re-drafting on top of an unpersisted snapshot could lose the prior state on crash, so the engine refuses and the caller should retry until persistence settles.

Solutions

  1. Retry after the parked checkpoint snapshot is durably persisted.
Defensive patterns

Strategy: retry

When it happens

Trigger: Thrown at crates/zeroclaw-runtime/src/sop/engine.rs:2977 when the library encounters an invalid state.

Common situations: See trigger scenarios.


AI-assisted analysis of zeroclaw-labs/zeroclaw@88bb9c8533 (2026-08-23). Data as JSON: /api/errors/87985af389976573. Report an issue: GitHub.

Appendix: source

Thrown at crates/zeroclaw-runtime/src/sop/engine.rs:2977

        &mut self,
        run_id: &str,
        guidance: &str,
        decision: super::approval::ApprovalDecision,
        principal: super::approval::ApprovalPrincipal,
    ) -> Result<()> {
        let prior_run = self
            .active_runs
            .get(run_id)
            .cloned()
            .ok_or_else(|| anyhow::Error::msg(format!("Active run not found: {run_id}")))?;
        if prior_run.status != SopRunStatus::PausedCheckpoint {
            bail!(
                "Run {run_id} is not paused at a checkpoint (status: {})",
                prior_run.status
            );
        }
        if self.is_park_persist_pending(run_id) {
            bail!(
                "Run {run_id} cannot re-draft: its parked checkpoint snapshot is not yet \
                 durably persisted (retrying)"
            );
        }
        self.can_revise_checkpoint(run_id)?;
        let (_, sop) = self.resolve_active_run_sop(run_id)?;
        self.revise_checkpoint_draft(run_id, guidance)?;

        let event = super::approval::GateLedgerEntry {
            run_id: run_id.to_string(),
            step: prior_run.current_step,
            gate_revision: Some(prior_run.revision),
            checkpoint_revision: Some(prior_run.revision),
            decision_identity: super::approval::broker::checkpoint_decision_identity(&decision)
                .map(|(_, identity)| identity),
            kind: super::approval::GateEventKind::Resolved,
            decision: Some(decision),
            principal,

View on GitHub (pinned to 88bb9c8533)