{"record":{"id":"97da9700a96f16e2","repo":"CloakHQ/CloakBrowser","slug":"pinned-download-completed-but-binary-not-found-at-97da97","errorCode":null,"errorMessage":"Pinned download completed but binary not found at expected path: {binary_path}. This may indicate a packaging issue. Please report at https://github.com/CloakHQ/cloakbrowser/issues","messagePattern":"Pinned download completed but binary not found at expected path: (.+?)\\. This may indicate a packaging issue\\. Please report at https://github\\.com/CloakHQ/cloakbrowser/issues","errorType":"exception","errorClass":"RuntimeError","httpStatus":null,"severity":"error","filePath":"cloakbrowser/download.py","lineNumber":275,"sourceCode":"        binary_path = get_binary_path(requested_version)\n        if binary_path.exists() and _is_executable(binary_path):\n            logger.debug(\n                \"Pinned binary found in cache: %s (version %s)\",\n                binary_path,\n                requested_version,\n            )\n            _show_welcome()\n            return str(binary_path)\n\n        logger.info(\n            \"Stealth Chromium %s not found. Downloading for %s...\",\n            requested_version,\n            get_platform_tag(),\n        )\n        _download_and_extract(requested_version)\n\n        if not (binary_path.exists() and _is_executable(binary_path)):\n            raise RuntimeError(\n                f\"Pinned download completed but binary not found at expected path: {binary_path}. \"\n                f\"This may indicate a packaging issue. Please report at \"\n                f\"https://github.com/CloakHQ/cloakbrowser/issues\"\n            )\n        _show_welcome()\n        return str(binary_path)\n\n    # Check for auto-updated version first, then fall back to hardcoded\n    effective = get_effective_version()\n    binary_path = get_binary_path(effective)\n\n    if binary_path.exists() and _is_executable(binary_path):\n        logger.debug(\"Binary found in cache: %s (version %s)\", binary_path, effective)\n        _show_welcome()\n        _maybe_trigger_update_check()\n        return str(binary_path)\n\n    # Fall back to platform's hardcoded version if effective version binary doesn't exist","sourceCodeStart":257,"sourceCodeEnd":293,"githubUrl":"https://github.com/CloakHQ/CloakBrowser/blob/d6bad5de261bedf025280ace1d14e800aee13923/cloakbrowser/download.py#L257-L293","documentation":"A pinned-version download reported success, but the extracted executable is missing or non-executable at the expected binary_path. Treated as a packaging bug, with a report link.","triggerScenarios":"ensure_binary with a pinned browser_version where _download_and_extract completes but the archive layout changed so the expected binary path isn't executable.","commonSituations":"Upstream archive restructure between releases; broken/deferred extraction (disk full, permissions); partial extraction on crash.","solutions":["Clear the cloakbrowser cache/download dir and re-download","Free disk space / fix permissions on the cache directory","Report at https://github.com/CloakHQ/cloakbrowser/issues with the version"],"exampleFix":null,"handlingStrategy":"retry","validationCode":null,"typeGuard":null,"tryCatchPattern":"try:\n    ensure_binary(browser_version=PIN)\nexcept RuntimeError as e:\n    if \"not found at expected path\" in str(e):\n        shutil.rmtree(get_cache_dir(), ignore_errors=True)\n        ensure_binary(browser_version=PIN)  # one clean retry\n    else:\n        raise","preventionTips":["Check free disk space before install steps","Treat cache dir as disposable; script a clean re-download path"],"tags":["download","packaging","corruption"],"backgroundTag":"binary-extraction-failed","analyzedSha":"d6bad5de261bedf025280ace1d14e800aee13923","analyzedAt":"2026-08-28T14:13:12.918Z","schemaVersion":2},"datasetVersion":"2026-08-28T16:17:29.566Z"}