{"record":{"id":"aaa8f5c3db6ddf81","repo":"vectordotdev/vector","slug":"not-found","errorCode":null,"errorMessage":"{} not found","messagePattern":"(.+?) not found","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"vdev/src/commands/release/prepare.rs","lineNumber":227,"sourceCode":"            .arg(\"--label\")\n            .arg(\"no-changelog\")\n            .current_dir(&self.repo_root)\n            .status()?;\n        if !gh_status.success() {\n            return Err(anyhow!(\"Failed to create PR with gh CLI\"));\n        }\n        info!(\"Successfully created PR against {}\", self.release_branch);\n        Ok(())\n    }\n\n    fn append_vrl_changelog_to_release_cue(&self) -> Result<()> {\n        debug!(\"append_vrl_changelog_to_release_cue\");\n\n        let releases_path = self.repo_root.join(\"website/cue/reference/releases\");\n        let version = &self.new_vector_version;\n        let cue_path = releases_path.join(format!(\"{version}.cue\"));\n        if !cue_path.is_file() {\n            return Err(anyhow!(\"{} not found\", cue_path.display()));\n        }\n\n        let vrl_changelog = get_vrl_changelog(&self.vrl_version)?;\n        let vrl_changelog_block = format_vrl_changelog_block(&vrl_changelog);\n\n        let original = fs::read_to_string(&cue_path)?;\n        let updated = insert_block_after_changelog(&original, &vrl_changelog_block);\n\n        let tmp_path = cue_path.with_extension(\"cue.tmp\");\n        fs::write(&tmp_path, &updated)?;\n        fs::rename(&tmp_path, &cue_path)?;\n\n        run_command(&format!(\"cue fmt {}\", cue_path.display()));\n        debug!(\"Successfully added VRL changelog to the release cue file.\");\n        Ok(())\n    }\n}\n","sourceCodeStart":209,"sourceCodeEnd":245,"githubUrl":"https://github.com/vectordotdev/vector/blob/0d4ab78a4f0d9c9e5d03a50108a2ae4d2f4b2460/vdev/src/commands/release/prepare.rs#L209-L245","documentation":"This error is thrown by vdev's release preparation when the VRL changelog should be appended into a release CUE file. Before reading the file, it verifies that `website/cue/reference/releases/<new_vector_version>.cue` exists; if not, it aborts with the path in the message. It means the release CUE document for the version being prepared was never created, so there is nowhere to append the VRL changelog.","triggerScenarios":"Calling generate_release_cue -> append_vrl_changelog_to_release_cue when `website/cue/reference/releases/{new_vector_version}.cue` does not exist on disk, typically because `vdev release prepare` was invoked before the per-version CUE file was generated or committed.","commonSituations":"Running a Vector release prep on a checkout that is missing the newly scaffolded release notes file; a typo or mismatch in the configured new version string so the expected `{version}.cue` filename differs from what exists; branching from before the release file was added.","solutions":["Check the exact path in the error and create/restore `website/cue/reference/releases/<version>.cue` (copy structure from a previous release's CUE file).","Verify `new_vector_version` in the release config/state matches the actual CUE filename (watch for `vX.Y.Z` vs `X.Y.Z` mismatches).","Pull/rebase from main to pick up the release CUE file if it was added by another maintainer.","Re-run the earlier release step that scaffolds the CUE file before re-running `vdev release prepare`."],"exampleFix":"// before (file missing)\n$ vdev release prepare\nError: website/cue/reference/releases/0.46.0.cue not found\n\n// after: scaffold the file first\n$ cp website/cue/reference/releases/0.45.0.cue website/cue/reference/releases/0.46.0.cue\n$ vdev release prepare","handlingStrategy":"validation","validationCode":"let cue_path = std::path::Path::new(\"website/cue/reference/releases\").join(format!(\"{version}.cue\"));\nif !cue_path.is_file() {\n    // scaffold from a prior release before invoking the command\n    anyhow::bail!(\"missing release CUE file: {}\", cue_path.display());\n}","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Always run the release-scaffold step before `vdev release prepare`.","Verify `new_vector_version` matches the existing CUE filenames exactly before running release automation.","Keep release branches rebased on main so newly added release files are present."],"tags":["release-tooling","cue","file-not-found","rust"],"backgroundTag":"file-not-found","analyzedSha":"0d4ab78a4f0d9c9e5d03a50108a2ae4d2f4b2460","analyzedAt":"2026-09-16T02:53:35.741Z","contentChangedAt":"2026-09-16T02:53:35.741Z","schemaVersion":2},"datasetVersion":"2026-09-23T08:17:48.524Z"}