{"record":{"id":"825292562ea99e2c","repo":"pbakaus/impeccable","slug":"could-not-download-the-impeccable-engine-v-version","errorCode":null,"errorMessage":"Could not download the impeccable engine v{version} for {os}-{arch} ({url}): {e}. The launcher fetches it on first run.\n","messagePattern":"Could not download the impeccable engine v(.+?) for (.+?)-(.+?) \\((.+?)\\): (.+?)\\. The launcher fetches it on first run\\.\n","errorType":"console","errorClass":null,"httpStatus":null,"severity":"warning","filePath":"crates/skills/src/engine_binary.rs","lineNumber":155,"sourceCode":"        match fetched {\n            Ok(bytes) => {\n                let written = util::mkdir_p(&jsp::dirname(&dest))\n                    .and_then(|_| util::write_bytes(&dest, &bytes))\n                    .and_then(|_| util::set_executable(&dest));\n                match written {\n                    Ok(()) => io.out(&format!(\n                        \"Installed impeccable engine v{version} ({os}-{arch}) into: {}\\n\",\n                        sys.format_path_for_display(&dest)\n                    )),\n                    Err(e) => io.err(&format!(\n                        \"Could not write the impeccable engine v{version} ({os}-{arch}) into {}: {e}\\n\",\n                        sys.format_path_for_display(&dest)\n                    )),\n                }\n            }\n            Err(e) => {\n                if !e.is_empty() {\n                    io.err(&format!(\n                        \"Could not download the impeccable engine v{version} for {os}-{arch} ({url}): {e}. The launcher fetches it on first run.\\n\"\n                    ));\n                    // Report once per version, then stay quiet for its siblings.\n                    cache.insert(version.to_string(), Err(String::new()));\n                }\n            }\n        }\n    }\n}\n\n#[cfg(test)]\nmod tests {\n    use super::*;\n\n    #[test]\n    fn asset_naming_matches_launcher() {\n        assert_eq!(\n            asset_url(DEFAULT_DOWNLOAD_BASE, \"1.2.3\", \"darwin\", \"arm64\"),","sourceCodeStart":137,"sourceCodeEnd":173,"githubUrl":"https://github.com/pbakaus/impeccable/blob/2bc2879276c1f321a53c4ca99d3371e411329b52/crates/skills/src/engine_binary.rs#L137-L173","documentation":"The engine binary download failed for a specific os-arch target. `install_engine_binaries` logs the failure once per version (siblings of the same version are silenced via a cache) and tells you the launcher will retry the fetch on first run, so installation is degraded but not fatal.","triggerScenarios":"`install` or `update` triggers the download in install_engine_binaries; the HTTP fetch for the pinned version at {url} returns an error or non-success, surfacing as Err(e) with a non-empty error string at crates/skills/src/engine_binary.rs:155.","commonSituations":"No network / corporate proxy blocking the download host; pinned ENGINE_VERSION asset missing upstream (version not yet released); DNS or TLS failure; 404 after a version bump.","solutions":["Check network connectivity and proxy settings (HTTPS_PROXY), then re-run install/update.","Open the printed {url} in a browser to confirm the release asset exists for your os-arch; if 404, wait for the release or align the pinned version.","Rely on the documented fallback: run the launcher, which fetches the engine on first run.","Alternatively build the engine locally and point IMPECCABLE_BIN at it."],"exampleFix":"# before\n$ impeccable install\nCould not download the impeccable engine v1.2.3 for linux-x64 (https://.../impeccable-linux-x64): 404 Not Found.\n# after (local build fallback)\n$ cargo build --release -p impeccable\n$ IMPECCABLE_BIN=\"$PWD/target/release/impeccable\" bun run test","handlingStrategy":"retry","validationCode":"const url = downloadUrlFor(version, os, arch);\nconst head = await fetch(url, { method: 'HEAD' });\nif (!head.ok) console.warn(`asset missing for ${os}-${arch}: HTTP ${head.status}; launcher will fetch on first run`);","typeGuard":null,"tryCatchPattern":"try {\n  await installEngineBinaries(io);\n} catch (e) {\n  console.warn('download failed; falling back to launcher first-run fetch:', e.message);\n}","preventionTips":["Verify the pinned version's release assets exist before rolling out a version bump","Configure proxy env vars (HTTPS_PROXY) in restricted networks","Retry installs with backoff on transient network failures","Use IMPECCABLE_BIN with a local build when offline"],"tags":["network","download","install"],"backgroundTag":"http-request-failed","analyzedSha":"2bc2879276c1f321a53c4ca99d3371e411329b52","analyzedAt":"2026-09-08T04:51:14.109Z","contentChangedAt":"2026-09-08T04:51:14.109Z","schemaVersion":2},"datasetVersion":"2026-09-14T00:17:10.932Z"}