zeroclaw-labs/zeroclaw · error

Refusing to replace JSONL session created while

Error message

Refusing to replace JSONL session created while {} was staged

What it means

Safety refusal in restore_uncommitted_jsonl: while a migration transaction was being rolled back, the live JSONL path that should have been restored already exists with different content than the staged copy. Restoring would overwrite a session that was concurrently modified, so the restore refuses and surfaces the mismatch instead of destroying data.

Solutions

  1. Resolve the staged SQLite state first (complete or roll back the migration), then recreate the JSONL session.
Defensive patterns

Strategy: validation

When it happens

Trigger: Thrown at crates/zeroclaw-infra/src/session_sqlite.rs:323 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/70be7366cf1a6512. Report an issue: GitHub.

Appendix: source

Thrown at crates/zeroclaw-infra/src/session_sqlite.rs:323

        let _ = path;
        Ok(())
    }

    fn sync_staged_jsonl(path: &Path, name: &str) -> Result<()> {
        let mut options = std::fs::OpenOptions::new();
        options.read(true);
        #[cfg(windows)]
        options.write(true);
        options
            .open(path)
            .with_context(|| format!("Failed to open staged JSONL session {name} for sync"))?
            .sync_all()
            .with_context(|| format!("Failed to sync staged JSONL session {name}"))
    }

    fn restore_uncommitted_jsonl(staged_path: &Path, live_path: &Path) -> Result<()> {
        if live_path.exists() {
            bail!(
                "Refusing to replace JSONL session created while {} was staged",
                live_path.display()
            );
        }
        std::fs::rename(staged_path, live_path).with_context(|| {
            format!(
                "Failed to restore empty JSONL session {}",
                live_path.display()
            )
        })
    }

    fn import_receipt(
        conn: &Connection,
        source_name: &str,
    ) -> Result<Option<(String, String, i64)>> {
        conn.query_row(
            "SELECT session_key, source_hash, source_len FROM jsonl_import_receipts \

View on GitHub (pinned to 88bb9c8533)