{"record":{"id":"8d87799445a961f9","repo":"jdx/mise","slug":"unsupported-task-cache-store-version-expected","errorCode":null,"errorMessage":"unsupported task cache store version {}; expected {}","messagePattern":"unsupported task cache store version (.+?); expected (.+?)","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"src/task/task_cache.rs","lineNumber":431,"sourceCode":"                    base_url,\n                    namespace,\n                    token: settings.task.cache.remote_token.clone(),\n                    token_file: settings.task.cache.remote_token_file.clone(),\n                    oidc_audience: settings.task.cache.remote_oidc_audience.clone(),\n                    connect_timeout: settings.http_timeout(),\n                    read_timeout: settings.http_timeout(),\n                    download_timeout: settings.http_download_timeout(),\n                    retries: settings.http_retries(),\n                },\n                staging_dir: cache_dir.join(\"remote\"),\n                mode,\n            })\n        } else {\n            None\n        };\n        let store = compose_task_cache_stores(local, remote)?;\n        if store.version() != TASK_CACHE_STORE_VERSION {\n            bail!(\n                \"unsupported task cache store version {}; expected {}\",\n                store.version(),\n                TASK_CACHE_STORE_VERSION\n            );\n        }\n        Ok(TaskArtifactCache {\n            root,\n            cache_dir,\n            store,\n            key,\n            action: encoded,\n            explanation,\n            state_path,\n            limits,\n        })\n    }\n}\n","sourceCodeStart":413,"sourceCodeEnd":449,"githubUrl":"https://github.com/jdx/mise/blob/6f52dcdf99e282ef7a7db68c81301fa4618d0f79/src/task/task_cache.rs#L413-L449","documentation":"After composing the local (and optional remote) task cache stores, mise asserts the store's reported version equals TASK_CACHE_STORE_VERSION (currently 1, defined in task_cache_store.rs). A mismatch means the on-disk/remote store layout was written by an incompatible store implementation relative to this mise build.","triggerScenarios":"Sharing one cache directory or remote cache endpoint between different mise versions whose store protocols differ; downgrading mise after a newer version migrated the store; a remote cache server implementing a different store version.","commonSituations":"CI fleet pinning different mise versions but sharing a cache volume or HTTPS remote; developers on stable and colleagues on a bleeding-edge build; rolling back mise after an upgrade wrote a new-format store.","solutions":["Align mise versions everywhere that shares the cache (upgrade the older side)","Clear the task cache directory (default under the OS cache dir, 'task-artifacts') so a fresh store is created","Point the remote cache (settings task.cache_dir / remote config) at a per-version directory or endpoint","If it persists on matching versions, report it — the version constant should never drift within one build"],"exampleFix":"# shell — before: mixed mise versions share ~/.cache/task-artifacts\n\n# after: clear and repin\nrm -rf \"${XDG_CACHE_HOME:-$HOME/.cache}/task-artifacts\"\nmise use -g mise@2026.1.6   # pin one version across CI and devs","handlingStrategy":"fallback","validationCode":"mise --version   # confirm the version before touching a shared cache\ndu -sh \"${XDG_CACHE_HOME:-$HOME/.cache}/task-artifacts\" 2>/dev/null","typeGuard":null,"tryCatchPattern":"On this error, bypass the cache for the run (disable the cache setting or clear the dir) and complete the build uncached, then reconcile versions afterward.","preventionTips":["Pin one mise version across all writers of a shared cache","Scope cache_dir per mise major version in CI","Clear the task cache after upgrading mise if formats changed"],"tags":["mise","task-cache","caching","versioning","migration"],"backgroundTag":"cache-version-mismatch","analyzedSha":"6f52dcdf99e282ef7a7db68c81301fa4618d0f79","analyzedAt":"2026-08-22T10:14:23.840Z","contentChangedAt":null,"schemaVersion":2},"datasetVersion":"2026-09-08T15:18:49.778Z"}