zeroclaw-labs/zeroclaw · error
Refusing incompatible migrated JSONL session
Error message
Refusing incompatible migrated JSONL session {} What it means
Safety refusal during post-commit cleanup of a JSONL migration: the .migrated archive for a session exists but its fingerprint does not match the expected one recorded at commit time. The archive cannot be proven to be the file that was just imported, so the handoff that would remove the staged copy refuses to proceed.
Solutions
- Inspect the migrated JSONL session's metadata for incompatibility; fix or remove it before migration.
Defensive patterns
Strategy: validation
When it happens
Trigger: Thrown at crates/zeroclaw-infra/src/session_sqlite.rs:737 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/9077bbf27f0ed484.
Report an issue: GitHub.
Appendix: source
Thrown at crates/zeroclaw-infra/src/session_sqlite.rs:737
&sessions_dir,
&mut mutation_guard,
)
.context("Failed to deactivate JSONL after committed SQLite import")?;
drop(conn);
return Err(sync_error).with_context(|| {
format!("JSONL import for {name} committed before sync mode restore failed")
});
}
crate::session_store::mark_session_directory_migrated(
&sessions_dir,
&mut mutation_guard,
)
.context("Failed to deactivate JSONL after committed SQLite import")?;
drop(conn);
if migrated_path.exists() {
if Self::source_fingerprint(&migrated_path, &name)? != expected {
bail!(
"Refusing incompatible migrated JSONL session {}",
migrated_path.display()
);
}
Self::sync_parent_directory(&migrated_path)?;
std::fs::remove_file(&staged_path)
.with_context(|| format!("Failed to finish staged JSONL handoff for {name}"))?;
Self::sync_parent_directory(&staged_path)?;
} else {
archive(&staged_path, &migrated_path, &expected)
.with_context(|| format!("Failed to archive imported JSONL session {name}"))?;
}
if live_path.exists() {
bail!(
"JSONL session {} reappeared during migration",
live_path.display()
);
}View on GitHub (pinned to 88bb9c8533)