Conflict (412 Precondition Failed): ETag mismatch, retry…

Error message

Conflict (412 Precondition Failed): ETag mismatch, retry needed

What it means

Optimistic-concurrency failure while uploading a team-memory batch: the server answered 412 Precondition Failed because the request's If-Match ETag no longer matches the server state — someone else pushed since our last pull. The batch was rejected; state must be re-fetched and the push retried.

Solutions

Re-pull to get the current ETag and merge remote changes, then push again
Keep pushes small/frequent to reduce the collision window
Automate the pull-merge-retry cycle rather than failing the whole push

Defensive patterns

Strategy: retry

When it happens

Trigger: Thrown at src-rust/crates/core/src/team_memory_sync.rs:336 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of Kuberwastaken/claurst@b0637c97ec (2026-09-10). Data as JSON: /api/errors/4a4ba40b2624ba54. Report an issue: GitHub.

Appendix: source

Thrown at src-rust/crates/core/src/team_memory_sync.rs:336

        match status {
            200 | 201 | 204 => {
                if let Some(etag) = response
                    .headers()
                    .get("etag")
                    .and_then(|v| v.to_str().ok())
                {
                    state.last_known_etag = Some(etag.to_string());
                }
                // Update local checksum map to reflect uploaded state
                for entry in &batch {
                    state
                        .server_checksums
                        .insert(entry.key.clone(), entry.checksum.clone());
                }
                Ok(())
            }
            412 => anyhow::bail!("Conflict (412 Precondition Failed): ETag mismatch, retry needed"),
            413 => anyhow::bail!("Payload too large (413)"),
            401 | 403 => anyhow::bail!("Authentication error ({})", status),
            _ => anyhow::bail!("Upload failed with status {}", status),
        }
    }

    /// Recursively scan `team_dir` for `.md` files, returning entries sorted by key.
    async fn scan_local_files(&self) -> Result<Vec<TeamMemoryEntry>> {
        let mut entries = Vec::new();

        if !self.team_dir.exists() {
            return Ok(entries);
        }

        // Iterative DFS using an explicit stack to avoid deep recursion
        let mut stack = vec![self.team_dir.clone()];

        while let Some(dir) = stack.pop() {

View on GitHub (pinned to b0637c97ec)