{"record":{"id":"211cd2933aa4a597","repo":"jdx/mise","slug":"is-not-captured-reason","errorCode":null,"errorMessage":"{} is not captured; {reason}","messagePattern":"(.+?) is not captured; (.+?)","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"src/cli/dotfiles/save.rs","lineNumber":99,"sourceCode":"                if !captured {\n                    // saving a deleted manual-save path saves the deletion,\n                    // provided the path was captured before (a path that\n                    // never existed is not a deletion)\n                    let deletion = tracked\n                        .entry_for(&path)\n                        .is_some_and(|entry| !entry.policy.autosave)\n                        && std::fs::symlink_metadata(&path)\n                            .is_err_and(|err| err.kind() == std::io::ErrorKind::NotFound)\n                        && previously_captured(&store, &entries, &path)?;\n                    if deletion {\n                        continue;\n                    }\n                    let reason = if tracked.entry_for(&path).is_some() {\n                        \"it is excluded, missing, or omitted from capture\"\n                    } else {\n                        \"track it with `mise bootstrap dotfiles track`\"\n                    };\n                    bail!(\"{} is not captured; {reason}\", display_path(&path));\n                }\n            }\n        }\n        let mut draft = Draft::new(trigger);\n        draft.explicit_paths = self\n            .paths\n            .iter()\n            .map(|path| normalize_target(path))\n            .collect();\n        draft.description = self.description.clone();\n        draft.description_source = Some(if trigger == Trigger::Agent {\n            DescriptionSource::Agent\n        } else {\n            DescriptionSource::User\n        });\n        draft.task = self.task.clone();\n        draft.labels = self.label.clone();\n        tokio::task::spawn_blocking(move || self.save_checkpoint(&store, &tracked, draft)).await?","sourceCodeStart":81,"sourceCodeEnd":117,"githubUrl":"https://github.com/jdx/mise/blob/afd2eddd3a50c16190efc1c7e94404b48f72af57/src/cli/dotfiles/save.rs#L81-L117","documentation":"`mise bootstrap dotfiles save` refuses to save a path that is not part of the dotfiles capture set. The tracked-set lookup found no entry for the path, so mise tells you either that the path is excluded/missing/omitted from capture, or that it has never been tracked at all. This guards the checkpoint store from capturing files the user never enrolled.","triggerScenarios":"Running `mise bootstrap dotfiles save <path>` (or with explicit paths) where the path has no entry in the TrackedSet: it was never added via `dotfiles track`, it was excluded by capture filters, or the file is missing on disk.","commonSituations":"User edits a new dotfile (e.g. ~/.config/newtool/config) and tries to save it without tracking first; a path was removed from the tracked set; a typo in the path means no entry matches.","solutions":["Track the path first with `mise bootstrap dotfiles track <path>`, then save","Check `mise bootstrap dotfiles status` to see which files are captured","Verify the path spelling matches the tracked entry exactly"],"exampleFix":"// before\nmise bootstrap dotfiles save ~/.zshrc   // fails if untracked\n// after\nmise bootstrap dotfiles track ~/.zshrc\nmise bootstrap dotfiles save ~/.zshrc","handlingStrategy":"validation","validationCode":"mise bootstrap dotfiles status --target \"$path\" || mise bootstrap dotfiles track \"$path\"","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Always `dotfiles track` a file before attempting to save it","Check `dotfiles status` output to confirm capture set membership","Avoid relying on capture filters that may exclude recently added files"],"tags":["cli","dotfiles","state"],"backgroundTag":"resource-not-found","analyzedSha":"afd2eddd3a50c16190efc1c7e94404b48f72af57","analyzedAt":"2026-09-09T01:38:25.179Z","contentChangedAt":"2026-09-09T01:38:25.179Z","schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}