{"record":{"id":"3e5eba39695c86c3","repo":"zeroclaw-labs/zeroclaw","slug":"download-returned","errorCode":null,"errorMessage":"download returned {}","messagePattern":"download returned (.+?)","errorType":"http","errorClass":"anyhow::Error","httpStatus":null,"severity":"error","filePath":"src/commands/update.rs","lineNumber":446,"sourceCode":"/// binary, which is the only artifact the caller needs by name — everything\n/// else in the archive is installed later by walking `staging` generically.\nasync fn download_release(\n    url: &str,\n    sha256sums_url: Option<&str>,\n    staging: &Path,\n) -> Result<PathBuf> {\n    let client = reqwest::Client::builder()\n        .user_agent(format!(\"zeroclaw/{}\", env!(\"CARGO_PKG_VERSION\")))\n        .timeout(std::time::Duration::from_mins(5))\n        .build()?;\n\n    let resp = client\n        .get(url)\n        .send()\n        .await\n        .context(\"download request failed\")?;\n    if !resp.status().is_success() {\n        bail!(\"download returned {}\", resp.status());\n    }\n\n    let bytes = resp.bytes().await.context(\"failed to read download body\")?;\n\n    if let Some(sums_url) = sha256sums_url {\n        verify_download_checksum(&bytes, url, sums_url, &client).await?;\n    } else {\n        ::zeroclaw_log::record!(\n            WARN,\n            ::zeroclaw_log::Event::new(module_path!(), ::zeroclaw_log::Action::Note)\n                .with_outcome(::zeroclaw_log::EventOutcome::Unknown),\n            \"No SHA256SUMS asset found; skipping update download checksum verification\"\n        );\n    }\n\n    tokio::fs::create_dir_all(staging)\n        .await\n        .context(\"failed to create staging directory\")?;","sourceCodeStart":428,"sourceCodeEnd":464,"githubUrl":"https://github.com/zeroclaw-labs/zeroclaw/blob/88bb9c8533fc57ed7a03e36ca7c9ed2bf8336dcc/src/commands/update.rs#L428-L464","documentation":"Error \"download returned {}\" thrown in zeroclaw-labs/zeroclaw.","triggerScenarios":"Thrown at src/commands/update.rs:446 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Verify network access to the download host and retry the update.","Check for a proxy or firewall blocking the download and configure it appropriately."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"88bb9c8533fc57ed7a03e36ca7c9ed2bf8336dcc","analyzedAt":"2026-08-23T01:07:41.857Z","schemaVersion":2},"datasetVersion":"2026-08-23T08:06:27.607Z"}